Skip to content

Futures · Profiles and levels

Futures vwap series

Developing VWAP and one- and two-deviation bands after each bar of a futures session.
GET/v1/futures/vwap/seriesfuturesVwapSeries
On this page

One row per time bar with the volume-weighted average price accumulated from the first returned bar through that bar, its volume-weighted standard deviation and the one- and two-deviation bands, plus the VWAP and volume of the bar alone. The accumulation uses the traded volume at every price of every bar, and restarts at the first bar of the window you request. Values are null while no volume has traded. At most 2,000 bars; a larger window answers 413 range_too_large.

Example request

curl -sS --get "https://api.ordermap.si/v1/futures/vwap/series" \
  -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

7 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.
sessionqueryoptionalstringrthglobexgthcurbcombineddefault rthTrading session to read. rth is 09:30 to 16:00 Eastern Time; globex the full 18:00 to 17:00 session; gth the overnight window (20:15 to 09:25); curb 16:15 to 17:00; combined gth plus rth. Futures trade through the night, so every session is available on every plan.
datequeryoptionalstringdateTrading date (YYYY-MM-DD) of the session; default the current or most recent one.
start_timequeryoptionalintegerunix-msmin 946684800000max 4102444800000Narrow the session to start at or after this time.
end_timequeryoptionalintegerunix-msmin 946684800000max 4102444800000Narrow the session to end at or before this time.
intervalqueryoptionalstring1m5m15m30m1hdefault 5mBar size.

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

  • dataarray<object>required10 fields inside
    • bar_timeintegerunix-msrequiredStart of the bar. Unix epoch milliseconds (UTC).
    • bar_volumeintegerrequiredContracts traded in the bar.
    • bar_vwapnumber | nullrequiredVolume-weighted average price of this bar alone.
    • cumulative_volumeintegerrequiredContracts traded from the first returned bar through this bar.
    • lower_1number | nullrequiredvwap minus one standard deviation.
    • lower_2number | nullrequiredvwap minus two standard deviations.
    • std_devnumber | nullrequiredVolume-weighted standard deviation around the vwap.
    • upper_1number | nullrequiredvwap plus one standard deviation.
    • upper_2number | nullrequiredvwap plus two standard deviations.
    • vwapnumber | nullrequiredVolume-weighted average price from the first returned bar through this bar.
  • metaobjectrequiredMeta object

Example response

{
  "data": [
    {
      "bar_time": 1792159200000,
      "bar_volume": 4821,
      "bar_vwap": 6021.1,
      "cumulative_volume": 412837,
      "lower_1": 6011.11,
      "lower_2": 6003.8,
      "std_dev": 7.31,
      "upper_1": 6025.73,
      "upper_2": 6033.04,
      "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.