Options · Exposure
Options exposure by delta
/v1/options/exposure/by-deltaoptionsExposureByDeltaGroups the contracts of the selection into seven buckets of absolute model delta (0 to 0.10, 0.10 to 0.25, 0.25 to 0.40, 0.40 to 0.60, 0.60 to 0.75, 0.75 to 0.90, 0.90 to 1; a bucket includes its lower edge, the last also 1) and reports for each the call, put, net and gross modeled exposure of the chosen measure, the open interest and the number of valued contracts. The buckets partition the valued contracts: their exposures add up to totals. Contracts the model cannot value are left out and counted in meta.coverage. The delta of a contract is the model delta of the valuation, not a quoted value. 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/by-delta" \
-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/by-delta?${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
14 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. |
greekqueryoptional | stringgammadeltavannacharmvegathetarhovommavetaspeedzommacolorultimadefault gamma | The exposure measured: gamma, delta, vanna, charm, vega, theta, rho, vomma, veta, speed, zomma, color or ultima. |
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. |
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
dataobjectrequiredModeled exposure by absolute delta bucket.34 fields insidebucketsarray<object>requiredThe seven delta buckets in ascending order.10 fields insidecall_exposurenumber | nullrequiredModeled exposure of the calls.call_open_interestintegerrequiredCall open interest of the bucket.contractsintegerrequiredValued contracts in the bucket.delta_maxnumberrequiredUpper edge of the absolute delta, excluded except for the last bucket.delta_minnumberrequiredLower edge of the absolute delta, included.gross_exposurenumber | nullrequiredSum of the absolute exposure of every contract in the bucket.net_exposurenumber | nullrequiredCalls plus puts.open_interestintegerrequiredCall plus put open interest.put_exposurenumber | nullrequiredModeled exposure of the puts.put_open_interestintegerrequiredPut open interest of the bucket.
greekstringrequiredThe measure: gamma, delta, vanna, charm, vega, theta, rho, vomma, veta, speed, zomma, color, ultima or the heat map metric.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.rthgthcurballtotalsobjectrequiredTotals over every bucket.4 fields insideabsolutenumber | nullrequiredAbsolute calls plus absolute puts.callnumber | nullrequiredCalls.netnumber | nullrequiredCalls plus puts.putnumber | nullrequiredPuts.
trading_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": {
"buckets": [
{
"call_exposure": 12000000,
"call_open_interest": 91200,
"contracts": 118,
"delta_max": 0.1,
"delta_min": 0,
"gross_exposure": 33000000,
"net_exposure": -9000000,
"open_interest": 235200,
"put_exposure": -21000000,
"put_open_interest": 144000
}
],
"greek": "vega",
"model": "classic_oi",
"perspective": "dealer",
"positioning_model": "oi_signed_proxy-v1",
"roots": [
"SPX",
"SPXW"
],
"session": "rth",
"totals": {
"absolute": 730000000,
"call": 410000000,
"net": 90000000,
"put": -320000000
},
"trading_date": "2026-10-16",
"underlying_symbol": "SPX",
"unit": "per_percent",
"unit_label": "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
}
},
"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.
