Skip to content

Options · Exposure

Options exposure sheet

Up to eight modeled dealer exposures by strike from one valuation, with call, put and net values and totals per measure.
On this page

The 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=SPXW

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

Parameters

18 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.
min_strikequeryoptionalnumber> 0max 1000000Lowest strike in dollars.
max_strikequeryoptionalnumber> 0max 1000000Highest strike in dollars.
strikes_aroundqueryoptionalintegermin 1max 500This many listed strikes either side of the strike nearest the underlying price.
strike_percentqueryoptionalnumbermin 0.1max 100Strikes within this percent of the underlying price.
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). The dollar-valued Greeks do not scale with it.
modelqueryoptionalstringclassic_oiflow_adjustedflow_onlydefault classic_oiDealer 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).
perspectivequeryoptionalstringdealercustomerdefault dealerdealer (default) or customer, which negates the values only.
metricsqueryoptionalarray<string>comma-separated in one parametergammadeltavannacharmvegathetarhovommavetaspeedzommacolorultima1 to 8 itemsThe 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.
timestampqueryoptionalintegerunix-msmin 946684800000max 4102444800000Value 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

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

  • dataobjectrequiredSeveral modeled exposures by strike.37 fields inside
    • metricsarray<object>requiredThe requested exposures, in request order.16 fields inside
      • call_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 inside
        • absolutenumber | 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.dollarnull
      • unit_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 inside
        • absolutenumber | nullrequiredAbsolute calls plus absolute puts.
        • callnumber | nullrequiredCalls.
        • netnumber | nullrequiredCalls plus puts.
        • putnumber | nullrequiredPuts.
    • 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
    • strikesarray<object>requiredThe strikes of the sheet in ascending order, with their open interest.3 fields inside
      • call_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_dollarraw
    • 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": {
    "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.