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

Data product · Early access

Options Net Premium and Flow Summary Data

Options flow added up: how much call and put premium traded, how much was bought at the ask versus sold at the bid, per ticker, per sector or for the whole market, minute by minute.

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