Open Interest by Contract

GET

/options/v1/open-interest

Retrieve daily open interest for US options contracts as reported by OPRA, one row per contract per trading day. Each record includes the contract's underlying ticker, OCC root, contract type, expiration date, strike price, and its open interest. Filter by ticker or root, and by date for a single day or a date range.

The date field is the trading session each figure is for. New data arrives every morning for the prior session, so the latest date available is the previous trading day.

Use Cases: Open interest trend analysis, liquidity and positioning research, options flow modeling, backtesting.

Options BasicFree

Options Starter$29/mo

Options Developer$79/mo

Options Advanced$199/mo

Options Business$1,999/mo

Historical Options Analytics Business$1,249/mo

Plan AccessIncluded in select Options plans

Options BasicFree

Not included

Options Starter$29/mo

Not included

Options Developer$79/mo

Not included

Options Advanced$199/mo

End-of-day

Options Business$1,999/mo

Not included

Historical Options Analytics Business$1,249/mo

End-of-day

Plan RecencyEnd-of-day (updated daily)

Options BasicFree

Not included

Options Starter$29/mo

Not included

Options Developer$79/mo

Not included

Options Advanced$199/mo

All history

Options Business$1,999/mo

Not included

Historical Options Analytics Business$1,249/mo

All history

Plan HistoryRecords date back to September 1, 2022

Query Parameters

ticker

string

The options ticker symbol (e.g., O:SPY260123C00687000).

root

string

The OCC root symbol of the contract (e.g., SPXW). Differs from the underlying for weekly roots and for contracts adjusted after a corporate action (e.g., AMCR1).

contract_type

enum (string)

The contract type. Possible values: call, put.

expiration_date

string

The date the contract expires (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.

date

string

The trading date the open interest applies to (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.

limit

integer

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.

sort

string

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'date' if not specified. The sort order defaults to 'desc' if not specified.

fields

string

A comma-separated list of fields to return for each result (e.g. `contract_type,date,expiration_date`). If omitted, all fields are returned. When set, each result contains only the fields you list; every other field is dropped, even fields a full response always includes. Nested fields can be specified using dot notation (for example, `parent.child`).

Response Format

JSONArrow

Standard JSON response, a human-readable, text-based data format of fields and values. Learn more about JSON responses

Response Attributes

next_url

string

optional

If present, this value can be used to fetch the next page.

request_id

string

A request id assigned by the server.

results

array (object)

The results for this request.

contract_type

string

optional

The contract type. Possible values: call, put.

date

string

The trading date the open interest applies to (formatted as YYYY-MM-DD).

expiration_date

string

optional

The date the contract expires (formatted as YYYY-MM-DD).

open_interest

integer

optional

The number of outstanding contracts that have not been closed or exercised, as of the last open interest update of the day.

root

string

optional

The OCC root symbol of the contract (e.g., SPXW). Differs from the underlying for weekly roots and for contracts adjusted after a corporate action (e.g., AMCR1).

strike_price

number

optional

The strike price of the contract.

ticker

string

The options ticker symbol (e.g., O:SPY260123C00687000).

underlying_ticker

string

optional

The ticker of the contract's underlying (e.g., SPX). Weekly and adjusted roots are folded in, so SPXW contracts report SPX and AMCR1 contracts report AMCR; see root to tell them apart.

status

enum (OK)

The status of this request's response.

Code Examples

curl -X GET "https://api.massive.com/options/v1/open-interest?limit=100&sort=date.desc&apiKey=YOUR_API_KEY"

Query URL

GET

https://api.massive.com/options/v1/open-interest?apiKey=YOUR_API_KEY

Run query unavailable

Create account or sign in to Massive

Scroll to see updated query response

Response Object

{
  "next_url": "https://api.massive.com/options/v1/open-interest?cursor=YXA9ZGF0ZT0yMDI2LTAxLTIyJnRpY2tlcj1POlNQWTI2MDEyM0MwMDY4NzAwMCZsaW1pdD0yJnNvcnQ9ZGF0ZS5kZXNj",
  "request_id": "6f1d2c9a8b7e4d3c2b1a0f9e8d7c6b5a",
  "results": [
    {
      "contract_type": "put",
      "date": "2026-01-22",
      "expiration_date": "2026-01-23",
      "open_interest": 9871,
      "root": "SPY",
      "strike_price": 687,
      "ticker": "O:SPY260123P00687000",
      "underlying_ticker": "SPY"
    },
    {
      "contract_type": "call",
      "date": "2026-01-22",
      "expiration_date": "2026-01-23",
      "open_interest": 15234,
      "root": "SPY",
      "strike_price": 687,
      "ticker": "O:SPY260123C00687000",
      "underlying_ticker": "SPY"
    }
  ],
  "status": "OK"
}

// Run a query to see a response

{ "next_url": "https://api.massive.com/options/v1/open-interest?cursor=YXA9ZGF0ZT0yMDI2LTAxLTIyJnRpY2tlcj1POlNQWTI2MDEyM0MwMDY4NzAwMCZsaW1pdD0yJnNvcnQ9ZGF0ZS5kZXNj", "request_id": "6f1d2c9a8b7e4d3c2b1a0f9e8d7c6b5a", "results": [ { "contract_type": "put", "date": "2026-01-22", "expiration_date": "2026-01-23", "open_interest": 9871, "root": "SPY", "strike_price": 687, "ticker": "O:SPY260123P00687000", "underlying_ticker": "SPY" }, { "contract_type": "call", "date": "2026-01-22", "expiration_date": "2026-01-23", "open_interest": 15234, "root": "SPY", "strike_price": 687, "ticker": "O:SPY260123C00687000", "underlying_ticker": "SPY" } ], "status": "OK" }