Skip to content

Options · Exposure

Options exposure term structure

Modeled exposure by days-to-expiry bucket and by expiration, with concentration.
GET/v1/options/exposure/term-structureoptionsExposureTermStructure
On this page

The modeled dealer exposure grouped into the days-to-expiry buckets 0, 1-7, 8-30, 31-90 and 91+ and listed per expiration, each with call, put, net and gross exposure and its share of the gross exposure, and how concentrated the gross exposure is: the share of the largest expiration, of the three largest and the Herfindahl index (the sum of squared shares, 1 when one expiration holds everything). 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/term-structure" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode underlying_symbol=SPXW

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

Parameters

13 parameters, 1 required.

ParameterType and limitsDescription
underlying_symbolqueryrequiredstringat 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 ...
datequeryoptionalstringdateTrading date (YYYY-MM-DD). Default: the current session, else the most recent completed one.
sessionqueryoptionalstringrthgthdefault rthTrading 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_typequeryoptionalstringcallputCalls or puts. Omit for both.
date_of_expiryqueryoptionalstringdateOnly this expiration.
expirationsqueryoptionalarray<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_modequeryoptionalstring0dte1dteweeklymonthlylte30lte90Expiration set: 0dte, 1dte, weekly (within 7 days), monthly (third-Friday expirations), lte30 or lte90 (within 30 or 90 days).
min_dtequeryoptionalintegermin 0max 3650Minimum days to expiration (0 = expires on the trading date).
max_dtequeryoptionalintegermin 0max 3650Maximum days to expiration.
greekqueryoptionalstringgammadeltavannacharmdefault gammaThe exposure measured: gamma, delta, vanna or charm.
unitqueryoptionalstringper_percentper_dollarrawdefault per_percentScale 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).
modelqueryoptionalstringclassic_oiflow_adjusteddefault classic_oiDealer positioning model: classic_oi (open interest, calls long and puts short) or flow_adjusted (adjusted by classified prints since the open interest date).
perspectivequeryoptionalstringdealercustomerdefault dealerdealer (default) or customer, which negates the values only.

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

  • dataobjectrequiredExposure term structure.38 fields inside
    • bucketsarray<object>requiredDays-to-expiry buckets: 0, 1-7, 8-30, 31-90, 91+.7 fields inside
      • bucketstringrequiredDays to expiry.01-78-3031-9091+
      • callnumber | nullrequiredCall exposure.
      • expirationsintegerrequiredExpirations in the bucket.
      • grossnumber | nullrequiredAbsolute call plus absolute put exposure.
      • netnumber | nullrequiredCall plus put exposure.
      • putnumber | nullrequiredPut exposure.
      • share_of_grossnumber | nullrequiredShare of the gross exposure, 0 to 1.
    • concentrationobjectrequiredConcentration of the gross exposure across expirations.3 fields inside
      • herfindahlnumber | nullrequiredSum of squared shares: 1 when one expiration holds everything.
      • top_3_sharenumber | nullrequiredShare of the three largest expirations.
      • top_expiry_sharenumber | nullrequiredShare of the largest expiration.
    • expirationsarray<object>requiredExposure of each expiration, soonest first.7 fields inside
      • callnumber | nullrequiredCall exposure.
      • date_of_expirystringdaterequiredExpiration.
      • days_to_expiryintegerrequiredCalendar days to expiration.
      • grossnumber | nullrequiredAbsolute call plus absolute put exposure.
      • netnumber | nullrequiredCall plus put exposure.
      • putnumber | nullrequiredPut exposure.
      • share_of_grossnumber | nullrequiredShare of the gross exposure, 0 to 1.
    • 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_only
    • perspectivestringrequireddealer or customer (customer negates the values).dealercustomer
    • positioning_modelstringrequiredName and version of the positioning assumption, for example oi_signed_proxy-v1.
    • rootsarray<string>requiredOption roots included.
    • sessionstringrequiredSession valued.rthgthcurball
    • trading_datestringdaterequiredTrading date valued.
    • underlying_symbolstringrequiredThe requested underlying.
    • unitstringrequiredScale of the values.per_percentper_dollarraw
    • unit_labelstringrequiredWhat one unit is, for example usd_per_pct: dollars of dealer hedging per 1% move.
    • valuationobjectrequiredWhat the snapshot was valued on.7 fields inside
      • chain_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": [
      {
        "bucket": "0",
        "call": 4100000000,
        "expirations": 1,
        "gross": 7000000000,
        "net": 1200000000,
        "put": -2900000000,
        "share_of_gross": 0.45
      },
      {
        "bucket": "1-7",
        "call": 3000000000,
        "expirations": 4,
        "gross": 5000000000,
        "net": 1000000000,
        "put": -2000000000,
        "share_of_gross": 0.32
      }
    ],
    "concentration": {
      "herfindahl": 0.24,
      "top_3_share": 0.78,
      "top_expiry_share": 0.45
    },
    "expirations": [
      {
        "call": 4100000000,
        "date_of_expiry": "2026-10-16",
        "days_to_expiry": 0,
        "gross": 7000000000,
        "net": 1200000000,
        "put": -2900000000,
        "share_of_gross": 0.45
      }
    ],
    "greek": "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.