Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-BARS |
| Coverage | US-listed equity, ETF and index options |
| Granularity | 1m standard; 5m, 1h and other intervals on request |
| History | Starter: 2 years. Pro: 5 years. Business: full history |
| Delivery | REST; WebSocket bars on Pro; CSV files per underlying |
| Update speed | 15-minute delayed on Starter, real time from Pro |
Option contracts trade far less often than their underlying. A mid-strike monthly on a large-cap might print a few times an hour, and a far out-of-the-money weekly might not print at all. We don't make up bars for minutes with no trades. To still give you a price for those quiet stretches, each bar can carry close_bid and close_ask.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
timestamp |
string | yes | Start of the bar, ISO 8601 UTC |
interval |
string | yes | 1m, 5m, 1h etc. |
symbol |
string | yes | OCC option symbol |
underlying_symbol |
string | yes | Underlying ticker |
open |
number | yes | First trade price |
high |
number | yes | Highest trade |
low |
number | yes | Lowest trade |
close |
number | yes | Last trade |
volume |
number | yes | Contracts traded |
trade_count |
number | optional | Number of trades |
vwap |
number | optional | Volume-weighted average price |
close_bid |
number | optional | NBBO bid at bar end |
close_ask |
number | optional | NBBO ask at bar end |
underlying_close |
number | optional | Underlying price at bar end |
Every bar is stamped at the start of its interval, the same as our stock and crypto bars.
Example record:
{
"timestamp": "2026-11-18T18:41:00Z",
"interval": "1m",
"symbol": "AAPL261218C00230000",
"underlying_symbol": "AAPL",
"open": 6.38,
"high": 6.43,
"low": 6.36,
"close": 6.41,
"volume": 37,
"trade_count": 9,
"vwap": 6.40,
"close_bid": 6.35,
"close_ask": 6.45,
"underlying_close": 228.40
}
Sample data
Sample data
We don't have a free intraday options sample yet, because the bars are built from licensed OPRA trades. A sample file is available on request: tell us the underlying, the expiry and a day.
Use cases
Use cases
0DTE and short-dated backtests. Same-day SPX options move most in the last hours of the session. Daily bars show you nothing useful here; minute bars with close_bid and close_ask let you test entries at 13:00 New York time and exits at 15:30.
Entry timing around the open. Compare the first 15 bars after the open with the rest of the day to see when spreads tighten enough to trade. The spread is close_ask minus close_bid on each bar.
Option vs underlying lag. underlying_close is on every bar. Regress the option's minute returns against the underlying's to see how closely it tracks, or where it lags.
Code
Code examples
Example: 1-minute bars for one contract on one day.
curl "https://api.marketdata.co/v1/options/bars?symbol=SPY261218C00600000&interval=1m&start=2026-11-18&end=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, mid-price series from the bars, forward-filled for quiet minutes.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/bars",
params={"symbol": "SPY261218C00600000", "interval": "1m", "start": "2026-11-18", "end": "2026-11-18"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
bars = pd.DataFrame(resp.json()["results"])
bars["timestamp"] = pd.to_datetime(bars["timestamp"], utc=True)
bars = bars.set_index("timestamp")
bars["mid"] = (bars["close_bid"] + bars["close_ask"]) / 2
mid = bars["mid"].resample("1min").last().ffill()
print(mid.between_time("14:30", "15:00"))
Pricing
Pricing
| Plan | Intraday option bars |
|---|---|
| Starter, $29/mo | 1-minute bars, 15-minute delayed, 2 years |
| Pro, $79/mo | Real-time bars over REST and WebSocket, 5 years |
| Business, $249/mo | Full history, commercial use |
Planned files: $29 per underlying per year (all contracts, 1-minute), or $199 per month of the full US market. Prices are early access and may change.
In our research, plans with intraday option bars cost from $0 to $1,550 a month, median $94.99, across 6 prices.
Side by side
How we compare
Just 9 of the 50 providers we studied sell intraday option bars. File leases run into the thousands at the top end, and the retail APIs keep a few years at most. We list the per-underlying file price, let you keep what you buy, and stamp bars the same way as our stock bars. Since the contract symbol matches our EOD and Greeks data, you can mix daily and intraday in one study.
FAQ
Frequently asked questions
Why are there gaps in the bars?
No trade means no bar. Plenty of contracts go many minutes without a print, so use close_bid and close_ask from the last bar, or our chain snapshots, for a price in between.
Are timestamps start or end of bar?
Start. The 14:31:00Z bar covers trades from 14:31:00 up to 14:31:59.999.
What time zone do you use?
UTC for every timestamp. The regular options session runs 14:30 to 21:00 UTC in winter and 13:30 to 20:00 UTC in summer.
Do you include the underlying price?
Yes, as underlying_close, the underlying's price at the end of each bar. It's optional and present when we have both feeds for that minute.
Can I get other intervals?
1m is the base. Other intervals are built from it on request, and you can resample 1m yourself in pandas.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: Tick data vs bar data, How to backtest with 1-minute data