Options · Exposure
Options exposure sheet
/v1/options/exposure/sheetoptionsExposureSheetThe modeled dealer exposure of up to eight measures (gamma, delta, vanna, charm, vega, theta, rho, vomma, veta, speed, zomma, color, ultima) at every strike of one valuation, so that the measures share one set of strikes, one underlying price and one chain. strikes lists the strikes with their open interest; every entry of metrics holds, in the order of strikes, the call, put and net exposure at each strike (null where the model cannot value that side), the unit_label, the totals over the whole selection and, when a strike window narrows the rows, the totals of the window. The values equal what /v1/options/exposure/by-strike returns for each measure. 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. Besides gamma, delta, vanna and charm the measure can be vega, theta, rho, vomma, veta, ultima, speed, zomma or color; unit_label names the unit: dollars per volatility point for vega, dollars per calendar day for theta, dollars per 1% rate move for rho, vega dollars per volatility point per volatility point for vomma, vega dollars per volatility point per day for veta, vomma per volatility point for ultima, and gamma exposure per 1% move, per volatility point or per day for speed, zomma and color. The dollar-valued Greeks (vega, theta, rho, vomma, veta and ultima) do not scale with the unit parameter: unit is echoed and meta.coverage.unit_equivalent is dollar; speed, zomma and color follow the unit of gamma. With the flow_only model the dealer position is the classified prints since the open interest date alone, without the open interest itself, so it shows what the day's flow changed; when no flow is available the positions are 0, meta.coverage.complete is false and meta.coverage.flow_complete says so.
Example request
curl -sS --get "https://api.ordermap.si/v1/options/exposure/sheet" \
-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/sheet?${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
18 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. |
min_queryoptional | number> 0max 1000000 | Lowest strike in dollars. |
max_queryoptional | number> 0max 1000000 | Highest strike in dollars. |
strikes_queryoptional | integermin 1max 500 | This many listed strikes either side of the strike nearest the underlying price. |
strike_queryoptional | numbermin 0.1max 100 | Strikes within this percent of the underlying price. |
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). The dollar-valued Greeks do not scale with it. |
modelqueryoptional | stringclassic_oiflow_adjustedflow_onlydefault classic_oi | Dealer positioning model: classic_oi (open interest, calls long and puts short), flow_adjusted (adjusted by classified prints since the open interest date) or flow_only (those prints alone, without the open interest). |
perspectivequeryoptional | stringdealercustomerdefault dealer | dealer (default) or customer, which negates the values only. |
metricsqueryoptional | array<string>comma-separated in one parametergammadeltavannacharmvegathetarhovommavetaspeedzommacolorultima1 to 8 items | The exposures to value, 1 to 8, in the order of the response: gamma, delta, vanna, charm, vega, theta, rho, vomma, veta, speed, zomma, color or ultima. Default: gamma, delta, vanna and charm. |
timestampqueryoptional | integerunix-msmin 946684800000max 4102444800000 | Value the snapshot at this retained minute (Unix milliseconds) instead of the latest. The minute must lie in a session whose history your plan covers; with date it must fall in that session. An instant outside the regular hours is read from the overnight session unless session is given. |
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
dataobjectrequiredSeveral modeled exposures by strike.37 fields insidemetricsarray<object>requiredThe requested exposures, in request order.16 fields insidecall_exposurearray<number>requiredCall exposure at each strike of strikes, in the same order; null where the model cannot value it.metricstringrequiredThe measure.net_exposurearray<number>requiredNet exposure (calls plus puts) at each strike of strikes.put_exposurearray<number>requiredPut exposure at each strike of strikes.totalsobjectrequiredTotals over the whole selection.4 fields insideabsolutenumber | nullrequiredAbsolute calls plus absolute puts.callnumber | nullrequiredCalls.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 of this measure is, for example usd_per_pct.window_totalsobject | nullrequiredTotals over the strikes of the sheet when a strike window narrows them; null otherwise.4 fields insideabsolutenumber | nullrequiredAbsolute calls plus absolute puts.callnumber | nullrequiredCalls.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
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.rthgthcurballstrikesarray<object>requiredThe strikes of the sheet in ascending order, with their open interest.3 fields insidecall_open_interestintegerrequiredCall open interest.put_open_interestintegerrequiredPut open interest.strikenumberrequiredStrike in dollars.
trading_datestringdaterequiredTrading date valued.underlying_symbolstringrequiredThe requested underlying.unitstringrequiredScale of the values.per_percentper_dollarrawvaluationobjectrequiredWhat 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": {
"metrics": [
{
"call_exposure": [
110000000,
420000000
],
"metric": "gamma",
"net_exposure": [
-190000000,
230000000
],
"put_exposure": [
-300000000,
-190000000
],
"totals": {
"absolute": 15500000000,
"call": 9100000000,
"net": 2700000000,
"put": -6400000000
},
"unit_equivalent": null,
"unit_label": "usd_per_pct",
"window_totals": null
},
{
"call_exposure": [
2000000,
5100000
],
"metric": "vega",
"net_exposure": [
-2400000,
2200000
],
"put_exposure": [
-4400000,
-2900000
],
"totals": {
"absolute": 730000000,
"call": 410000000,
"net": 90000000,
"put": -320000000
},
"unit_equivalent": "dollar",
"unit_label": "usd_per_volpt",
"window_totals": null
}
],
"model": "classic_oi",
"perspective": "dealer",
"positioning_model": "oi_signed_proxy-v1",
"roots": [
"SPX",
"SPXW"
],
"session": "rth",
"strikes": [
{
"call_open_interest": 4120,
"put_open_interest": 9810,
"strike": 5950
},
{
"call_open_interest": 8120,
"put_open_interest": 7010,
"strike": 6000
}
],
"trading_date": "2026-10-16",
"underlying_symbol": "SPX",
"unit": "per_percent",
"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.
