Skip to content

Futures · Statistics

Futures session stats

One-row summary of the current futures session: volume, delta, CVD extremes, VWAP, value area and range.
GET/v1/futures/session-statsfuturesSessionStats
On this page

The current Globex session in one row: contracts traded and their buy, sell and unknown split, delta and delta as a percent of volume, the high, low and last of the cumulative volume delta, VWAP, point of control and the 70 % value area, and the high, low and range in ticks of the traded prices. Built from the session profile (which can answer 503 data_pending; retry) and the cumulative delta. The cumulative delta is accumulated from the session's 5-minute footprint bars, so cvd_high and cvd_low are extremes at bar resolution (the running delta after each 5-minute bar, not after each print) and a swing inside one bar is not seen; the cvd fields are null and coverage.complete is false when the session holds no bars. For individual large prints use /v1/futures/flow.

Example request

curl -sS --get "https://api.ordermap.si/v1/futures/session-stats" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=ES

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

2 parameters, none required.

ParameterType and limitsDescription
symbolqueryoptionalstringat most 3 characterspattern ^[A-Za-z0-9]{1,3}$Futures product root, for example ES, NQ, CL or GC. Without contract the current front month is used and returned in the response.
contractqueryoptionalstringat most 6 characterspattern ^[A-Za-z0-9]{1,3}[FGHJKMNQUVXZfghjkmnquvxz][0-9]{1,2}$Exact dated contract: root, month code and year, for example ESZ6 (December 2026). Two-digit years are accepted and returned in the one-digit form (ESZ26 is ESZ6). Only the front month and the contracts listed by /v1/futures/contracts are served.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
422The request is valid but no data exists for it.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataobjectrequiredSummary of one session.18 fields inside
    • buy_volumeinteger | nullrequiredAggressive buy contracts.
    • contractstringrequiredDated contract.
    • cvd_highnumber | nullrequiredHighest cumulative volume delta of the session.
    • cvd_lastnumber | nullrequiredLatest cumulative volume delta.
    • cvd_lownumber | nullrequiredLowest cumulative volume delta of the session.
    • deltainteger | nullrequiredBuy minus sell contracts.
    • delta_percentnumber | nullrequireddelta divided by volume, in percent.
    • poc_pricenumber | nullrequiredPoint of control: the busiest price (the lowest on a tie).
    • range_highnumber | nullrequiredHighest traded price.
    • range_lownumber | nullrequiredLowest traded price.
    • range_ticksinteger | nullrequiredRange in ticks.
    • sell_volumeinteger | nullrequiredAggressive sell contracts.
    • trading_datestringdaterequiredTrading date of the session.
    • unknown_volumeinteger | nullrequiredContracts whose side is unknown.
    • value_area_highnumber | nullrequiredUpper edge of the 70 % value area.
    • value_area_lownumber | nullrequiredLower edge of the 70 % value area.
    • volumeinteger | nullrequiredContracts traded.
    • vwapnumber | nullrequiredVolume-weighted average price of the session.
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "buy_volume": 205120,
    "contract": "ESZ6",
    "cvd_high": 8120,
    "cvd_last": -1980,
    "cvd_low": -6410,
    "delta": -1980,
    "delta_percent": -0.48,
    "poc_price": 6021.5,
    "range_high": 6030,
    "range_low": 6004.5,
    "range_ticks": 102,
    "sell_volume": 207100,
    "trading_date": "2026-10-16",
    "unknown_volume": 617,
    "value_area_high": 6027,
    "value_area_low": 6014.25,
    "volume": 412837,
    "vwap": 6018.42
  },
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "cme"
  }
}

Values are illustrative. Missing values are null, never 0.