Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-FLOW-AGG |
| Coverage | US-listed options, rolled up by underlying, sector and the whole market (MARKET) |
| Granularity | 1m, 5m and 1d buckets |
| History | Same as options flow: 1 year on Pro, 2 years on Business |
| Delivery | REST |
| Update speed | 15-minute delayed on Pro, real time on Business; daily market tide on every plan |
Individual flow alerts are noisy. One big put could be a hedge, a spread leg or a bet. Summing every trade by the side it hit smooths that out and gives you a line you can chart against price, which is what most people mean by "market tide".
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
timestamp |
string | yes | Bucket start, ISO 8601 UTC |
interval |
string | yes | 1m, 5m, 1d |
scope |
string | yes | Underlying ticker, sector name, or MARKET |
call_premium |
number | yes | Total call premium |
put_premium |
number | yes | Total put premium |
net_call_premium |
number | yes | Call premium at ask minus at bid |
net_put_premium |
number | yes | Put premium at ask minus at bid |
bullish_premium |
number | optional | Calls bought plus puts sold |
bearish_premium |
number | optional | Puts bought plus calls sold |
call_volume |
number | yes | Call contracts |
put_volume |
number | yes | Put contracts |
buy_volume |
number | optional | Contracts at or above ask |
sell_volume |
number | optional | Contracts at or below bid |
mid_volume |
number | optional | Contracts at mid |
trade_count |
number | optional | Trades in bucket |
volume_vs_avg |
number | optional | Volume / 90-day average (daily scope) |
Example record:
{
"timestamp": "2026-11-18T15:05:00Z",
"interval": "5m",
"scope": "MARKET",
"call_premium": 412850000.0,
"put_premium": 368120000.0,
"net_call_premium": 18420000.0,
"net_put_premium": -6310000.0,
"bullish_premium": 201440000.0,
"bearish_premium": 176930000.0,
"call_volume": 1284310,
"put_volume": 1102775,
"buy_volume": 905220,
"sell_volume": 861940,
"mid_volume": 619925,
"trade_count": 214882,
"volume_vs_avg": null
}
Sample data
Sample data
There's no free net premium sample yet, because the roll-ups are computed from licensed OPRA trades. A sample file is available on request for a ticker or the whole market over a day you pick.
Use cases
Use cases
Market tide chart. Plot cumulative net_call_premium and net_put_premium for scope = MARKET in 5-minute buckets against SPY. When net call premium climbs while the index drifts down, someone is buying the dip with options.
Ticker rankings. Rank underlyings by bullish_premium minus bearish_premium for the day. It's a quick shortlist of names with one-sided flow.
Spotting heavy days. volume_vs_avg on daily rows compares today's options volume with the 90-day average. A reading well above 1 marks an unusually busy day and is worth a look.
Sector rotation. Use a sector name as scope and compare net premium across sectors week by week to see where options money is moving.
Code
Code examples
Example: whole-market net premium in 5-minute buckets.
curl "https://api.marketdata.co/v1/options/flow/summary?scope=MARKET&interval=5m&date=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, cumulative net premium through the day.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/flow/summary",
params={"scope": "MARKET", "interval": "5m", "date": "2026-11-18"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
tide = pd.DataFrame(resp.json()["results"])
tide["timestamp"] = pd.to_datetime(tide["timestamp"], utc=True)
tide = tide.set_index("timestamp")
print(tide[["net_call_premium", "net_put_premium"]].cumsum().tail())
Pricing
Pricing
| Plan | Net premium and flow summaries |
|---|---|
| Free, $0 | Daily market-level tide |
| Pro, $79/mo | All scopes and intervals, 15 minutes delayed, bundled with options flow |
| Business, $249/mo | Real time, commercial internal use |
Flow summaries come with the options flow product at no extra cost. They aren't sold as a separate dataset. Prices are early access and may change.
Among the 5 vendors we studied that sell this, prices run from $0 to $1,499 a month, median $99.
Side by side
How we compare
5 of the 50 providers we studied sell net premium or market tide data, and two of those are web-only. Every seller bundles it with flow, and so do we. The difference is that the daily market tide is free here, the side buckets are defined in the schema rather than left vague, and the numbers sum straight from our flow and trade records, so you can check any bucket against the trades inside it.
FAQ
Frequently asked questions
What does net call premium mean?
Call premium traded at or above the ask, minus call premium traded at or below the bid. A positive number means more calls were bought aggressively than sold aggressively.
How are mid-price trades counted?
They're counted in call_premium, put_premium and mid_volume, but not in the net figures, because we can't tell which side started them.
Do bullish and bearish premium double count?
No. bullish_premium is calls bought plus puts sold, bearish_premium is puts bought plus calls sold, and each trade lands in one of them or neither.
What time zone are buckets in?
UTC, stamped at the start of each bucket. Daily buckets follow the US options trading day.
Is the free daily tide delayed?
It's published after the close. Intraday tide needs Pro or Business.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: Reading options flow