Futures · Profiles and levels
Futures levels
/v1/futures/levelsfuturesLevelsThe levels traders reference in one response: the prior session's high, low and close; the high and low of the overnight (session start to the regular open), Asia (18:00 to 03:00 Eastern Time) and London (03:00 to the regular open) ranges; the regular-session open; the opening range after 5, 15 and 30 minutes; the initial balance (first regular hour); the developing high, low, point of control, value area and VWAP of the session; and the prior session's point of control and value area when its profile is held. Session boundaries come from the session calendar, so closures follow it. Reads two sessions of one-minute bars (through a deferred history read, so a first request can answer 503 data_pending; retry) and the session profile (which can answer 503 data_pending; retry). coverage.opening_range_complete and coverage.initial_balance_complete say whether the 30-minute opening range and the first regular hour have fully passed (before that they are still forming). A group with no bars in its window is null, the profile fields are null for a session whose profile is not held (the profile covers the current session only), and coverage.complete is false when the session has no bars. date defaults to the current session and keeps your plan's history window as a request parameter; the prior session it reads for its levels is a lookback and is not limited by that window.
Example request
curl -sS --get "https://api.ordermap.si/v1/futures/levels" \
-H "Authorization: Bearer $ORDERMAP_API_KEY" \
--data-urlencode symbol=ESconst params = new URLSearchParams({
symbol: "ES",
});
const res = await fetch(`https://api.ordermap.si/v1/futures/levels?${params}`, {
headers: { Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
console.log(data, meta.coverage);Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.
Parameters
3 parameters, none required.
| Parameter | Type and limits | Description |
|---|---|---|
symbolqueryoptional | stringat 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. |
contractqueryoptional | stringat 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. |
datequeryoptional | stringdate | Trading date (YYYY-MM-DD); default the current or most recent session. |
Response
| Status | Meaning | Body |
|---|---|---|
200 | Successful response. | Schema below |
400 | Invalid, unknown or repeated parameters, or an invalid cursor. | Error object |
401 | Missing or invalid API key. | Error object |
403 | The plan, dataset release or account state does not allow this request. | Error object |
422 | The request is valid but no data exists for it. | Error object |
429 | Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After | Error object |
500 | Internal error. | Error object |
503 | Data temporarily unavailable; retry after Retry-After seconds.Retry-After | Error object |
504 | The request timed out. | Error object |
Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.
200 response body
dataobjectrequiredReference levels of one session.41 fields insideasiaobject | nullrequiredHigh and low from the session start to 03:00 Eastern Time.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
contractstring | nullrequiredDated contract.developingobject | nullrequiredThe session so far.6 fields insidehighnumber | nullrequiredSession high.lownumber | nullrequiredSession low.poc_pricenumber | nullrequiredPoint of control of the session profile.value_area_highnumber | nullrequiredUpper edge of the 70 % value area.value_area_lownumber | nullrequiredLower edge of the 70 % value area.vwapnumber | nullrequiredVolume-weighted average price of the session.
initial_balanceobject | nullrequiredThe first regular hour.3 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.rangenumberrequiredhigh minus low.
londonobject | nullrequiredHigh and low from 03:00 Eastern Time to the regular open.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
opening_rangeobject | nullrequiredHigh and low of the first minutes of the regular session.9 fields insidem15object | nullrequiredFirst 15 minutes.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
m30object | nullrequiredFirst 30 minutes.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
m5object | nullrequiredFirst 5 minutes.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
overnightobject | nullrequiredHigh and low from the session start to the regular open.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
prior_profileobject | nullrequiredThe prior session's profile levels.3 fields insidepoc_pricenumber | nullrequiredPoint of control.value_area_highnumber | nullrequiredUpper edge of the 70 % value area.value_area_lownumber | nullrequiredLower edge of the 70 % value area.
prior_sessionobject | nullrequiredThe prior trading session.3 fields insideclosenumberrequiredClose of its last one-minute bar.highnumberrequiredHighest price.lownumberrequiredLowest price.
rth_opennumber | nullrequiredOpen of the first one-minute bar of the regular session.trading_datestringdaterequiredTrading date of the session.
metaobjectrequiredMeta object
Example response
{
"data": {
"asia": {
"high": 6045,
"low": 6025
},
"contract": "ESZ6",
"developing": {
"high": 6060,
"low": 6025,
"poc_price": 6041.5,
"value_area_high": 6048,
"value_area_low": 6034,
"vwap": 6042.1
},
"initial_balance": {
"high": 6052,
"low": 6036,
"range": 16
},
"london": {
"high": 6060,
"low": 6030
},
"opening_range": {
"m15": {
"high": 6050,
"low": 6038
},
"m30": {
"high": 6050,
"low": 6038
},
"m5": {
"high": 6046,
"low": 6040
}
},
"overnight": {
"high": 6060,
"low": 6025
},
"prior_profile": null,
"prior_session": {
"close": 6020,
"high": 6050,
"low": 5990
},
"rth_open": 6041,
"trading_date": "2026-10-16"
},
"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.
