Options · Levels
Options levels futures
/v1/options/levels/futuresoptionsLevelsFuturesThe key levels of the modeled dealer exposure (walls, gamma flip, max pain, the largest cell and key strikes, and the vanna, charm and delta levels) on the index scale and converted to the price of an E-mini or Micro E-mini future, with the basis used: the ratio of the future's price to the index at the time, the method and its time. es and mes convert SPX, XSP and SPY; nq and mnq convert NDX and QQQ; any other pair is refused. When no matching futures price exists the conversion is left null, never estimated. Needs access to the futures data as well as the options data. Dealer positioning is a model, not observed: with classic_oi the dealer is assumed long the calls and short the puts of the open interest, with flow_adjusted the classified prints since the open interest date adjust it. Public open interest does not identify who holds a position, so the values are estimates of exposure under that assumption.
Example request
curl -sS --get "https://api.ordermap.si/v1/options/levels/futures" \
-H "Authorization: Bearer $ORDERMAP_API_KEY" \
--data-urlencode underlying_symbol=SPXW \
--data-urlencode futures=esconst params = new URLSearchParams({
underlying_symbol: "SPXW",
futures: "es",
});
const res = await fetch(`https://api.ordermap.si/v1/options/levels/futures?${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
11 parameters, 2 required.
| Parameter | Type and limits | Description |
|---|---|---|
underlying_queryrequired | stringat most 8 characterspattern ^[A-Za-z][A-Za-z0-9.]{0,7}$ | Option root or family: SPX covers the SPX and SPXW roots, SPXW only the weekly root, QQQ, NDXP, RUTW, XSP ... |
futuresqueryrequired | stringesmesnqmnq | The futures product to convert the levels to: es or mes for SPX, XSP and SPY; nq or mnq for NDX and QQQ (written in either case). |
datequeryoptional | stringdate | Trading date (YYYY-MM-DD). Default: the current session, else the most recent completed one. |
sessionqueryoptional | stringrthgthdefault rth | Trading session: rth is the regular session, gth the overnight (global trading hours) session before the trading date. Overnight data requires the Pro plan and exists only for underlyings with an overnight session; GET /v1/options/sessions shows which. |
contract_queryoptional | stringcallput | Calls or puts. Omit for both. |
date_queryoptional | stringdate | Only this expiration. |
expirationsqueryoptional | array<string>comma-separated in one parameter1 to 64 itemseach at most 128 characterspattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ | Only these expirations, comma separated (YYYY-MM-DD), at most 64. Unlisted dates are ignored. |
expiry_queryoptional | string0dte1dteweeklymonthlylte30lte90 | Expiration set: 0dte, 1dte, weekly (within 7 days), monthly (third-Friday expirations), lte30 or lte90 (within 30 or 90 days). |
min_queryoptional | integermin 0max 3650 | Minimum days to expiration (0 = expires on the trading date). |
max_queryoptional | integermin 0max 3650 | Maximum days to expiration. |
modelqueryoptional | stringclassic_oiflow_adjusteddefault classic_oi | Dealer positioning model: classic_oi (open interest, calls long and puts short) or flow_adjusted (adjusted by classified prints since the open interest date). |
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
dataobjectrequiredKey levels as futures prices.28 fields insidebasisobject | nullrequiredHow the index scale was converted.3 fields insideas_of_timeinteger | nullunix-msrequiredTime of the futures price used. Unix epoch milliseconds (UTC).methodstringrequiredHow the basis was formed, for example ratio_live (the live ratio of the future to the index) or gth_parity (overnight).rationumber | nullrequiredFutures price divided by the index level at that time.
contractstring | nullrequiredThe futures product the engine converted to; null without a futures price.futures_symbolstringrequiredThe futures product.ESMESNQMNQgreekstringrequiredThe measure: gamma, delta, vanna, charm, vega, theta, rho, vomma, veta, speed, zomma, color, ultima or the heat map metric.levelsarray<object>requiredThe key levels in the engine's order.3 fields insidefutures_pricenumber | nullrequiredThe level converted to the futures price, rounded to the tick.index_levelnumber | nullrequiredThe level on the index scale.namestringrequiredThe level: call_wall, put_wall, call_wall_above, put_wall_below, abs_gamma_strike, major_positive, major_negative, zero_gamma, zero_gamma_ex_0dte, max_pain, mvc, king, vanna_max, vanna_min, charm_max_abs or delta_key.
modelstringrequiredDealer positioning model.classic_oiflow_adjustedflow_onlyperspectivestringrequireddealer or customer (customer negates the values).dealercustomerpositioning_modelstringrequiredName and version of the positioning assumption, for example oi_signed_proxy-v1.rootsarray<string>requiredOption roots included.sessionstringrequiredSession valued.rthgthcurballtrading_datestringdaterequiredTrading date valued.underlying_symbolstringrequiredThe requested underlying.unitstringrequiredScale of the values.per_percentper_dollarrawunit_labelstringrequiredWhat one unit is, for example usd_per_pct: dollars of dealer hedging per 1% move.valuationobjectrequiredWhat the snapshot was valued on.7 fields insidechain_timestampinteger | nullunix-msrequiredTime of the option chain the valuation used. Unix epoch milliseconds (UTC).open_interest_datestring | nulldaterequiredDate of the open interest the positioning is based on.risk_free_ratenumber | nullrequiredContinuously compounded risk-free rate used.timestampinteger | nullunix-msrequiredValuation time. Unix epoch milliseconds (UTC).underlying_pricenumber | nullrequiredUnderlying price used.underlying_stalebooleanrequiredThe underlying price is older than the freshness limit.underlying_timestampinteger | nullunix-msrequiredTime of the underlying price. Unix epoch milliseconds (UTC).
metaobjectrequiredMeta object
Example response
{
"data": {
"basis": {
"as_of_time": 1792161000000,
"method": "ratio_live",
"ratio": 1.0012
},
"contract": "ES",
"futures_symbol": "ES",
"greek": "gamma",
"levels": [
{
"futures_price": 6057.25,
"index_level": 6050,
"name": "call_wall"
},
{
"futures_price": 5897,
"index_level": 5890,
"name": "zero_gamma"
}
],
"model": "classic_oi",
"perspective": "dealer",
"positioning_model": "oi_signed_proxy-v1",
"roots": [
"SPX",
"SPXW"
],
"session": "rth",
"trading_date": "2026-10-16",
"underlying_symbol": "SPX",
"unit": "per_percent",
"unit_label": "usd_per_pct",
"valuation": {
"chain_timestamp": 1792160995000,
"open_interest_date": "2026-10-15",
"risk_free_rate": 0.0412,
"timestamp": 1792161000000,
"underlying_price": 6021.4,
"underlying_stale": false,
"underlying_timestamp": 1792160999000
}
},
"meta": {
"as_of": 1760659200123,
"coverage": {
"complete": true
},
"delay_ms": 0,
"delayed": false,
"request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
"source": "opra"
}
}Values are illustrative. Missing values are null, never 0.
