Skip to content

Options · Open interest and volume

Options open interest concentration

How concentrated open interest is across strikes and expirations: top shares and a concentration index.
GET/v1/options/open-interest/concentrationoptionsOpenInterestConcentration
On this page

For calls, puts and both, the share of the open interest held by the largest 1, 3, 5 and 10 strikes and by the largest 1, 3, 5 and 10 expirations, the Herfindahl index (the sum of squared shares: 1 when one strike or expiration holds everything, near 0 when it is spread thinly) and the largest ten keys with their open interest and share. Keys are strikes (as a decimal string) or expiration dates. Open interest is the previous close's figure, published each morning. Narrow the selection with the expiration and strike parameters. Two reads: open interest by strike and by expiration.

Example request

curl -sS --get "https://api.ordermap.si/v1/options/open-interest/concentration" \
  -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

11 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.
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.

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

  • dataobjectrequiredOpen interest concentration.67 fields inside
    • by_expirationobjectrequiredBy expiration.30 fields inside
      • callsobjectrequiredCalls.9 fields inside
        • herfindahlnumber | nullrequiredSum of squared shares.
        • toparray<object>requiredThe largest ten keys.3 fields inside
          • keystringrequiredA strike (decimal string) or an expiration date.
          • oiintegerrequiredOpen interest.
          • sharenumber | nullrequiredShare of the total, 0 to 1.
        • top_10_sharenumber | nullrequiredShare held by the largest 10.
        • top_1_sharenumber | nullrequiredShare held by the largest key, 0 to 1.
        • top_3_sharenumber | nullrequiredShare held by the largest 3.
        • top_5_sharenumber | nullrequiredShare held by the largest 5.
      • putsobjectrequiredPuts.9 fields inside
        • herfindahlnumber | nullrequiredSum of squared shares.
        • toparray<object>requiredThe largest ten keys.3 fields inside
          • keystringrequiredA strike (decimal string) or an expiration date.
          • oiintegerrequiredOpen interest.
          • sharenumber | nullrequiredShare of the total, 0 to 1.
        • top_10_sharenumber | nullrequiredShare held by the largest 10.
        • top_1_sharenumber | nullrequiredShare held by the largest key, 0 to 1.
        • top_3_sharenumber | nullrequiredShare held by the largest 3.
        • top_5_sharenumber | nullrequiredShare held by the largest 5.
      • totalobjectrequiredCalls and puts.9 fields inside
        • herfindahlnumber | nullrequiredSum of squared shares.
        • toparray<object>requiredThe largest ten keys.3 fields inside
          • keystringrequiredA strike (decimal string) or an expiration date.
          • oiintegerrequiredOpen interest.
          • sharenumber | nullrequiredShare of the total, 0 to 1.
        • top_10_sharenumber | nullrequiredShare held by the largest 10.
        • top_1_sharenumber | nullrequiredShare held by the largest key, 0 to 1.
        • top_3_sharenumber | nullrequiredShare held by the largest 3.
        • top_5_sharenumber | nullrequiredShare held by the largest 5.
    • by_strikeobjectrequiredBy strike.30 fields inside
      • callsobjectrequiredCalls.9 fields inside
        • herfindahlnumber | nullrequiredSum of squared shares.
        • toparray<object>requiredThe largest ten keys.3 fields inside
          • keystringrequiredA strike (decimal string) or an expiration date.
          • oiintegerrequiredOpen interest.
          • sharenumber | nullrequiredShare of the total, 0 to 1.
        • top_10_sharenumber | nullrequiredShare held by the largest 10.
        • top_1_sharenumber | nullrequiredShare held by the largest key, 0 to 1.
        • top_3_sharenumber | nullrequiredShare held by the largest 3.
        • top_5_sharenumber | nullrequiredShare held by the largest 5.
      • putsobjectrequiredPuts.9 fields inside
        • herfindahlnumber | nullrequiredSum of squared shares.
        • toparray<object>requiredThe largest ten keys.3 fields inside
          • keystringrequiredA strike (decimal string) or an expiration date.
          • oiintegerrequiredOpen interest.
          • sharenumber | nullrequiredShare of the total, 0 to 1.
        • top_10_sharenumber | nullrequiredShare held by the largest 10.
        • top_1_sharenumber | nullrequiredShare held by the largest key, 0 to 1.
        • top_3_sharenumber | nullrequiredShare held by the largest 3.
        • top_5_sharenumber | nullrequiredShare held by the largest 5.
      • totalobjectrequiredCalls and puts.9 fields inside
        • herfindahlnumber | nullrequiredSum of squared shares.
        • toparray<object>requiredThe largest ten keys.3 fields inside
          • keystringrequiredA strike (decimal string) or an expiration date.
          • oiintegerrequiredOpen interest.
          • sharenumber | nullrequiredShare of the total, 0 to 1.
        • top_10_sharenumber | nullrequiredShare held by the largest 10.
        • top_1_sharenumber | nullrequiredShare held by the largest key, 0 to 1.
        • top_3_sharenumber | nullrequiredShare held by the largest 3.
        • top_5_sharenumber | nullrequiredShare held by the largest 5.
    • open_interest_datestringdaterequiredDate of the open interest.
    • rootsarray<string>requiredOption roots included.
    • trading_datestringdaterequiredTrading date.
    • underlying_pricenumber | nullrequiredUnderlying price.
    • underlying_symbolstringrequiredThe requested underlying.
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "by_expiration": {
      "calls": {
        "herfindahl": 0.012,
        "top": [
          {
            "key": "6000",
            "oi": 183000,
            "share": 0.06
          }
        ],
        "top_10_share": 0.38,
        "top_1_share": 0.06,
        "top_3_share": 0.15,
        "top_5_share": 0.23
      },
      "puts": {
        "herfindahl": 0.012,
        "top": [
          {
            "key": "6000",
            "oi": 183000,
            "share": 0.06
          }
        ],
        "top_10_share": 0.38,
        "top_1_share": 0.06,
        "top_3_share": 0.15,
        "top_5_share": 0.23
      },
      "total": {
        "herfindahl": 0.012,
        "top": [
          {
            "key": "6000",
            "oi": 183000,
            "share": 0.06
          }
        ],
        "top_10_share": 0.38,
        "top_1_share": 0.06,
        "top_3_share": 0.15,
        "top_5_share": 0.23
      }
    },
    "by_strike": {
      "calls": {
        "herfindahl": 0.012,
        "top": [
          {
            "key": "6000",
            "oi": 183000,
            "share": 0.06
          }
        ],
        "top_10_share": 0.38,
        "top_1_share": 0.06,
        "top_3_share": 0.15,
        "top_5_share": 0.23
      },
      "puts": {
        "herfindahl": 0.012,
        "top": [
          {
            "key": "6000",
            "oi": 183000,
            "share": 0.06
          }
        ],
        "top_10_share": 0.38,
        "top_1_share": 0.06,
        "top_3_share": 0.15,
        "top_5_share": 0.23
      },
      "total": {
        "herfindahl": 0.012,
        "top": [
          {
            "key": "6000",
            "oi": 183000,
            "share": 0.06
          }
        ],
        "top_10_share": 0.38,
        "top_1_share": 0.06,
        "top_3_share": 0.15,
        "top_5_share": 0.23
      }
    },
    "open_interest_date": "2026-10-15",
    "roots": [
      "SPX",
      "SPXW"
    ],
    "trading_date": "2026-10-16",
    "underlying_price": 6021.4,
    "underlying_symbol": "SPX"
  },
  "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.