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
Related
- Asset hub: Options
- Docs: API reference: options chain
- Learn: Open interest explained