Futures · Profiles and levels
Futures market profile
/v1/futures/market-profilefuturesMarketProfileA market profile built from footprint bars at the period length: each period gets a letter (A to Z, then a to z, then again) and marks every price row between its low and its high. The point of control is the row with the most letters (the one nearest the middle of the range on a tie); the value area grows from it one row at a time toward the larger neighbour (the lower on a tie) until it holds value_area percent of all letters; single prints are runs of rows with exactly one letter that do not touch the top or bottom of the range. Row prices are the lowest price of the row. initial_balance is the high and low of the periods that start in the first 60 minutes of the regular session (09:30 Eastern Time); it is null before that session starts and for sessions that exclude it. Reads the live capture; at most 2,000 periods.
Example request
curl -sS --get "https://api.ordermap.si/v1/futures/market-profile" \
-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/market-profile?${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
9 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. |
sessionqueryoptional | stringrthglobexgthcurbcombineddefault rth | Trading 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. |
datequeryoptional | stringdate | Trading date (YYYY-MM-DD) of the session; default the current or most recent one. |
start_queryoptional | integerunix-msmin 946684800000max 4102444800000 | Narrow the session to start at or after this time. |
end_queryoptional | integerunix-msmin 946684800000max 4102444800000 | Narrow the session to end at or before this time. |
periodqueryoptional | string15m30m60mdefault 30m | Length of one lettered period. |
row_queryoptional | integerdefault 1min 1max 1000 | Price rows of this many ticks. |
value_queryoptional | numberdefault 70min 50max 95 | Share of all letters the value area holds, in percent. |
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
dataobjectrequiredA market profile.23 fields insidecontractstringrequiredDated contract.initial_balanceobject | nullrequiredHigh and low of the first regular-session hour.2 fields insidehighnumberrequiredHighest price.lownumberrequiredLowest price.
periodsarray<object>requiredThe lettered periods in time order.5 fields insideend_timeintegerunix-msrequiredEnd of the period. Unix epoch milliseconds (UTC).highnumberrequiredHighest traded price of the period.letterstringrequiredThe period's letter.lownumberrequiredLowest traded price of the period.start_timeintegerunix-msrequiredStart of the period. Unix epoch milliseconds (UTC).
poc_pricenumber | nullrequiredPoint of control row.range_highnumber | nullrequiredHighest traded price.range_lownumber | nullrequiredLowest traded price.rowsarray<object>requiredPrice rows, lowest first.3 fields insidelettersstringrequiredTheir letters in time order.pricenumberrequiredLowest price of the row.tpo_countintegerrequiredPeriods that traded in the row.
single_printsarray<object>requiredRuns of rows with one letter inside the range.2 fields insideprice_highnumberrequiredHighest row of the run.price_lownumberrequiredLowest row of the run.
total_tposintegerrequiredLetters in the profile.value_area_highnumber | nullrequiredHighest row of the value area.value_area_lownumber | nullrequiredLowest row of the value area.
metaobjectrequiredMeta object
Example response
{
"data": {
"contract": "ESZ6",
"initial_balance": {
"high": 6026,
"low": 6016.5
},
"periods": [
{
"end_time": 1792159200000,
"high": 6024.5,
"letter": "A",
"low": 6018.25,
"start_time": 1792157400000
}
],
"poc_price": 6021.5,
"range_high": 6031.5,
"range_low": 6014,
"rows": [
{
"letters": "AB",
"price": 6018.25,
"tpo_count": 2
}
],
"single_prints": [
{
"price_high": 6031.5,
"price_low": 6030
}
],
"total_tpos": 212,
"value_area_high": 6024.25,
"value_area_low": 6018.75
},
"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.
