Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Options Open Interest History Data

How many contracts are open at each strike and expiry, day after day, so you can see where positions are being built and where they're being closed.

Coverage

What you get

Item Detail
Product code OPT-OI
Coverage US-listed equity, ETF and index options, per contract, plus a roll-up per underlying
Granularity Daily, as published by OCC
History Free: 30 days. Starter: 2 years. Pro and up: full history plus per-underlying aggregates
Delivery REST; included in our end-of-day options files
Update speed Once a day, before the next session opens

Open interest is one of the few options numbers that isn't a guess. OCC counts the contracts that clear overnight and publishes one figure per contract per day. What most sources don't keep is the history, which is the part that tells you something.

Schema

Schema

Field Type Required Description
date string yes Date the OI applies to, YYYY-MM-DD
symbol string yes OCC option symbol
underlying_symbol string yes Underlying ticker
expiration_date string yes YYYY-MM-DD
strike_price number yes Strike
option_type string yes call or put
open_interest number yes Open contracts
previous_open_interest number optional Prior day value
open_interest_change number optional open_interest minus previous_open_interest
open_interest_change_pct number optional Change as a decimal
volume number optional Prior day volume
volume_oi_ratio number optional volume / open_interest

The per-underlying endpoint adds call_open_interest, put_open_interest and put_call_oi_ratio.

Example record:

{
  "date": "2026-11-18",
  "symbol": "AAPL261218C00230000",
  "underlying_symbol": "AAPL",
  "expiration_date": "2026-12-18",
  "strike_price": 230.0,
  "option_type": "call",
  "open_interest": 21455,
  "previous_open_interest": 20143,
  "open_interest_change": 1312,
  "open_interest_change_pct": 0.0651,
  "volume": 6204,
  "volume_oi_ratio": 0.289
}

Sample data

Sample data

We haven't published a free open interest sample yet; it ships with the same OPRA-licensed build as our options prices. A sample file is available on request for any underlying.

Use cases

Use cases

Opening vs closing. Volume alone can't tell you. If a strike trades 6,000 contracts and open_interest_change the next morning is +1,300, at least that many were new positions. A falling OI means traders were closing.

Finding crowded strikes. Rank strikes by open_interest for the monthly expiry. Large OI at round-number strikes is where hedging flows concentrate as expiry gets close, and it's the input to gamma exposure estimates.

Unusual activity filters. A volume_oi_ratio above 1 means more contracts traded today than were open yesterday. That's the first filter most flow scanners apply.

Put/call positioning over time. Plot put_call_oi_ratio for SPY or a single stock across months and compare it with price. It moves slowly, which makes it a regime gauge more than a timing signal.

Code

Code examples

Example: OI by strike for one expiration.

curl "https://api.marketdata.co/v1/options/open-interest?underlying=AAPL&expiration_date=2026-12-18&date=2026-11-18" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, the strikes where OI grew most overnight.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/options/open-interest",
    params={"underlying": "AAPL", "date": "2026-11-18"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
oi = pd.DataFrame(resp.json()["results"])
top = oi.sort_values("open_interest_change", ascending=False).head(10)
print(top[["symbol", "strike_price", "option_type", "open_interest", "open_interest_change"]])

Pricing

Pricing

Plan Open interest
Free, $0 30 days of history
Starter, $29/mo 2 years
Pro, $79/mo Full history, per-underlying aggregates
Business, $249/mo Full history, commercial use

Open interest isn't sold separately as a file. It's a column in every historical options dataset. Prices are early access and may change.

Among the vendors we studied, plans with open interest history cost $29.99 to $3,000 a month, median $149.99, across 7 prices.

Side by side

How we compare

11 of the 50 providers we studied sell open interest history. Some chain APIs leave the field out entirely; others keep a year or two. We start it on the Free plan, list prices openly, and use the same contract symbol as our chain and EOD data, so OI joins to price and Greeks without a lookup table.

FAQ

Frequently asked questions

When is open interest updated?

Once a day. OCC publishes it overnight, so the figure you see on the morning of the 19th reflects positions after the close on the 18th. Our date is the date it applies to.

Why doesn't OI change during the day?

Because nobody knows the true figure until trades clear. Any intraday "live OI" is an estimate built from volume, and we don't sell estimates as OI.

What's the difference between volume and open interest?

Volume counts contracts traded in a day. Open interest counts contracts still open at the end of it, so a contract bought and sold the same day adds to volume but not to OI.

Is OI split-adjusted?

No. After a split OCC adjusts the contracts themselves, often creating a new root. We keep OI as published for each contract.

What format is the history in?

JSON from the API, and CSV inside the EOD files. Column names match.

Keep reading