Options · Exposure
Options exposure summary
/v1/options/exposure/summaryoptionsExposureSummaryThe call, put, net and gross modeled dealer exposure of gamma, delta, vanna and charm for the selection in one response, with the underlying price, the exposure regime, the gamma tilt, the share of gamma in the nearest expiration (and the same-day share, which equals it when the nearest expiration is the trading date and is 0 otherwise), the gamma flip, the call and put walls and each one's distance from the underlying price in percent. All four measures use the same unit setting; unit_labels names what a unit is for each. With metrics, the totals of further measures (vega, theta, rho, vomma, veta, speed, zomma, color or ultima) come back in metrics, in request order, each with its unit_label; delta, vanna and charm and the extra measures are then read from one exposure sheet, so a request makes two engine reads instead of four. The dollar-valued Greeks do not scale with unit (unit_equivalent is dollar). 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/exposure/summary" \
-H "Authorization: Bearer $ORDERMAP_API_KEY" \
--data-urlencode underlying_symbol=SPXWconst params = new URLSearchParams({
underlying_symbol: "SPXW",
});
const res = await fetch(`https://api.ordermap.si/v1/options/exposure/summary?${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
13 parameters, 1 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 ... |
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. |
unitqueryoptional | stringper_percentper_dollarrawdefault per_percent | Scale of the values: per_percent (dollars of dealer hedging per 1% move of the underlying), per_dollar (per $1 move) or raw (shares, or per unit of the greek). |
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). |
perspectivequeryoptional | stringdealercustomerdefault dealer | dealer (default) or customer, which negates the values only. |
metricsqueryoptional | array<string>comma-separated in one parametervegathetarhovommavetaspeedzommacolorultima1 to 5 items | Further measures whose totals to return in metrics, at most 5, in response order: vega, theta, rho, vomma, veta, speed, zomma, color or ultima. |
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
dataobjectrequiredModeled exposure summary.61 fields insidecall_wallnumber | nullrequiredStrike of the largest positive call gamma exposure.charmobjectrequiredCharm exposure.4 fields insidecallnumber | nullrequiredCalls.grossnumber | nullrequiredAbsolute calls plus absolute puts.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
deltaobjectrequiredDelta exposure.4 fields insidecallnumber | nullrequiredCalls.grossnumber | nullrequiredAbsolute calls plus absolute puts.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
distance_to_call_wall_pctnumber | nullrequiredCall wall relative to the underlying price, percent.distance_to_put_wall_pctnumber | nullrequiredPut wall relative to the underlying price, percent.distance_to_zero_gamma_pctnumber | nullrequiredGamma flip relative to the underlying price, percent.gammaobjectrequiredGamma exposure.4 fields insidecallnumber | nullrequiredCalls.grossnumber | nullrequiredAbsolute calls plus absolute puts.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
gamma_tiltnumber | nullrequiredPositive call gamma exposure divided by the absolute negative put gamma exposure.metricsarray<object>The totals of the extra measures asked for with metrics, in request order; absent without metrics.8 fields insidemetricstringrequiredThe measure.totalsobjectrequiredTotals of the measure.4 fields insidecallnumber | nullrequiredCalls.grossnumber | nullrequiredAbsolute calls plus absolute puts.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
unit_equivalentstring | nullrequireddollar when the measure is a dollar value that the unit parameter does not scale.dollarnullunit_labelstringrequiredWhat one unit is, for example usd_per_volpt.
modelstringrequiredDealer positioning model.classic_oiflow_adjustedflow_onlynext_expiry_sharenumber | nullrequiredShare of absolute gamma exposure in the nearest expiration, 0 to 1.perspectivestringrequireddealer or customer (customer negates the values).dealercustomerpositioning_modelstringrequiredName and version of the positioning assumption, for example oi_signed_proxy-v1.put_wallnumber | nullrequiredStrike of the largest negative put gamma exposure.regimestring | nullrequiredExposure regime: positive, neutral or negative; a description of the model, not a forecast.positiveneutralnegativenullrootsarray<string>requiredOption roots included.sessionstringrequiredSession valued.rthgthcurballspotnumber | nullrequiredUnderlying price.trading_datestringdaterequiredTrading date valued.underlying_symbolstringrequiredThe requested underlying.unitstringrequiredScale of the values.per_percentper_dollarrawunit_labelsobjectrequiredWhat one unit is for each measure, for example usd_per_pct.4 fields insidecharmstringCharm.deltastringDelta.gammastringGamma.vannastringVanna.
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).
vannaobjectrequiredVanna exposure.4 fields insidecallnumber | nullrequiredCalls.grossnumber | nullrequiredAbsolute calls plus absolute puts.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
zero_dte_gamma_sharenumber | nullrequiredShare of absolute gamma exposure expiring on the trading date: next_expiry_share when the nearest expiration is the trading date, otherwise 0.zero_gammanumber | nullrequiredGamma flip: the underlying price where modeled net gamma changes sign.
metaobjectrequiredMeta object
Example response
{
"data": {
"call_wall": 6050,
"charm": {
"call": -210000000,
"gross": 350000000,
"net": -350000000,
"put": -140000000
},
"delta": {
"call": 42000000000,
"gross": 73000000000,
"net": 11000000000,
"put": -31000000000
},
"distance_to_call_wall_pct": 0.48,
"distance_to_put_wall_pct": -1.18,
"distance_to_zero_gamma_pct": -2.18,
"gamma": {
"call": 9100000000,
"gross": 15500000000,
"net": 2700000000,
"put": -6400000000
},
"gamma_tilt": 1.42,
"model": "classic_oi",
"next_expiry_share": 0.38,
"perspective": "dealer",
"positioning_model": "oi_signed_proxy-v1",
"put_wall": 5950,
"regime": "positive",
"roots": [
"SPX",
"SPXW"
],
"session": "rth",
"spot": 6021.4,
"trading_date": "2026-10-16",
"underlying_symbol": "SPX",
"unit": "per_percent",
"unit_labels": {
"charm": "usd_per_day",
"delta": "usd_per_pct",
"gamma": "usd_per_pct",
"vanna": "usd_per_volpt"
},
"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
},
"vanna": {
"call": 1200000000,
"gross": 2000000000,
"net": 400000000,
"put": -800000000
},
"zero_dte_gamma_share": 0.38,
"zero_gamma": 5890
},
"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.
