Skip to content

Futures · Profiles and levels

Futures market profile

Time-price-opportunity (market profile) of a futures session: lettered periods, point of control, value area, initial balance and single prints.
On this page

A 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=ES

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

Parameters

9 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.
periodqueryoptionalstring15m30m60mdefault 30mLength of one lettered period.
row_ticksqueryoptionalintegerdefault 1min 1max 1000Price rows of this many ticks.
value_areaqueryoptionalnumberdefault 70min 50max 95Share of all letters the value area holds, in percent.

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

  • dataobjectrequiredA market profile.23 fields inside
    • contractstringrequiredDated contract.
    • initial_balanceobject | nullrequiredHigh and low of the first regular-session hour.2 fields inside
      • highnumberrequiredHighest price.
      • lownumberrequiredLowest price.
    • periodsarray<object>requiredThe lettered periods in time order.5 fields inside
      • end_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 inside
      • lettersstringrequiredTheir 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 inside
      • price_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.