Options · Exposure, levels, volatility and OI

Options open interest change

Change in open interest per contract between the two latest open interest dates.

GET/v1/options/open-interest/changeoptionsOpenInterestChange

API Developer MCP tool: options_open_interest_change Paginated History-bounded Dataset: options

On this page

Example request
Parameters
Response
Example response
Related

The contracts whose open interest changed between the two most recent open interest dates, with the previous and current figures, the change and the percent change; contracts new on the latest date are flagged. Sorted by the size of the change unless sort says otherwise. Pages follow a snapshot by row offset: if the underlying data was refreshed between pages the response carries the warning snapshot_changed, and rows may repeat or be skipped.

Example request

curl -sS --get "https://api.ordermap.si/v1/options/open-interest/change" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode underlying_symbol=SPXW

const params = new URLSearchParams({
  underlying_symbol: "SPXW",
});
const res = await fetch(`https://api.ordermap.si/v1/options/open-interest/change?${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);
// Paginated: repeat with cursor_id set to pagination.next_cursor_id until it is null.

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

Parameters

16 parameters, 1 required.

Parameter	Type and limits	Description
`underlying_symbol`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 ...
`date`queryoptional	stringdate	Trading date (YYYY-MM-DD). Default: the most recent open interest date.
`contract_type`queryoptional	stringcallput	Calls or puts. Omit for both.
`date_of_expiry`queryoptional	stringdate	Only this expiration.
`expirations`queryoptional	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.
`expiry_mode`queryoptional	string0dte1dteweeklymonthlylte30lte90	Expiration set: 0dte, 1dte, weekly, monthly, lte30 or lte90.
`min_dte`queryoptional	integermin 0max 3650	Minimum days to expiration (0 = expires on the trading date).
`max_dte`queryoptional	integermin 0max 3650	Maximum days to expiration.
`min_strike`queryoptional	number> 0max 1000000	Lowest strike in dollars.
`max_strike`queryoptional	number> 0max 1000000	Highest strike in dollars.
`min_change`queryoptional	integermin 0max 1000000000	Minimum absolute change in contracts.
`min_change_percent`queryoptional	numbermin 0max 1000000000	Minimum absolute change in percent.
`sort`queryoptional	stringabs_changechangechange_percentcurrentpreviousdefault abs_change	Sort field: abs_change (default), change, change_percent, current or previous.
`order`queryoptional	stringdescascdefault desc	Descending (largest first) or ascending.
`limit`queryoptional	integerdefault 100min 1max 500	Maximum rows to return.
`cursor_id`queryoptional	stringat most 1024 characters	Opaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

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

dataarray<object>required9 fields inside
- changeintegerrequiredCurrent minus previous.
- change_percentnumber | nullrequiredChange in percent of the previous open interest; null when it was zero.
- contract_typestringrequiredCall or put.callput
- current_open_interestintegerrequiredOpen interest on the latest date.
- date_of_expirystringdaterequiredExpiration date.
- is_new_listingbooleanrequiredThe contract was listed after the previous date.
- previous_open_interestintegerrequiredOpen interest on the previous date.
- strikenumberrequiredStrike in dollars.
- underlying_symbolstringrequiredOption root of the contract.
metaobjectrequiredMeta object
paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "change": 5900,
      "change_percent": 32.42,
      "contract_type": "call",
      "current_open_interest": 24100,
      "date_of_expiry": "2026-10-16",
      "is_new_listing": false,
      "previous_open_interest": 18200,
      "strike": 6050,
      "underlying_symbol": "SPXW"
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "opra"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 100,
    "next_cursor_id": null,
    "next_url": null
  }
}

Values are illustrative. Missing values are null, never 0.

Example request

Parameters

Response

200 response body

Example response

Related