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

Data product · Early access

Options Flow and Unusual Options Activity Data

A filtered feed of the option trades worth looking at (sweeps, blocks, size above open interest), each with the premium, where it printed against the bid and ask, and the exact rule that flagged it.

Coverage

What you get

Item Detail
Product code OPT-FLOW
Coverage US-listed equity, ETF and index options
Granularity One alert per flagged trade or sweep
History Pro: 1 year. Business: 2 years
Delivery REST on Pro; REST and WebSocket on Business; monthly files
Update speed 15-minute delayed on Pro, real time on Business

Most flow tools show you a list of big trades labelled "bullish" and leave it there. We think you should see why. Every alert carries alert_rules, the list of conditions it met, and the raw inputs behind sentiment, so you can rebuild or overrule our call.

Schema

Schema

Field Type Required Description
alert_id string yes Unique ID
timestamp string yes Execution time, ISO 8601 UTC
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
days_to_expiration integer optional Calendar days
price number yes Average fill price
size number yes Total contracts
premium number yes Total USD premium
underlying_price number yes Underlying at execution
bid number yes NBBO bid at execution
ask number yes NBBO ask at execution
side string yes above_ask, ask, mid, bid, below_bid
structure string yes sweep, block, split, single
exchange_count integer optional Venues hit (sweeps)
conditions array of string optional OPRA condition codes
volume number optional Contract volume so far today
open_interest number optional Prior day OI
volume_oi_ratio number optional volume / open_interest
is_opening boolean optional Estimated opening trade (size above OI)
sentiment string yes bullish, bearish, neutral
implied_volatility number optional IV at fill
alert_rules array of string optional Why it was flagged, e.g. premium_over_100k, iso_sweep

Example record:

{
  "alert_id": "fl_20261118_000391",
  "timestamp": "2026-11-18T15:07:22.481203000Z",
  "symbol": "SPY261127C00600000",
  "underlying_symbol": "SPY",
  "expiration_date": "2026-11-27",
  "strike_price": 600.0,
  "option_type": "call",
  "days_to_expiration": 9,
  "price": 3.12,
  "size": 1850,
  "premium": 577200.0,
  "underlying_price": 594.85,
  "bid": 3.05,
  "ask": 3.10,
  "side": "above_ask",
  "structure": "sweep",
  "exchange_count": 6,
  "conditions": ["S"],
  "volume": 9420,
  "open_interest": 4310,
  "volume_oi_ratio": 2.19,
  "is_opening": true,
  "sentiment": "bullish",
  "implied_volatility": 0.142,
  "alert_rules": ["premium_over_100k", "iso_sweep", "volume_over_oi"]
}

Sample data

Sample data

No free flow sample yet. It's built from live OPRA trades and quotes, which we can't share until our licence is in place. A sample file is available on request for a day and a list of tickers.

Use cases

Use cases

Following aggressive sweeps. Filter structure = sweep, side in ask or above_ask, and is_opening = true. A buyer who splits an order across venues and pays the offer to fill it fast is telling you something about urgency.

Checking a flow signal before you act. Look at volume_oi_ratio and days_to_expiration together. A big call buy that's 5x open interest in a 7-day option means something different from one that's 0.1x OI in a LEAP, even with the same premium.

Backtesting "unusual activity" claims. Pull a year of alerts, join each underlying_symbol and timestamp to our stock bars, and measure what the underlying did over the next 1, 5 and 20 days. It's the test most flow services never show you.

Discord and alert bots. Business gives you the WebSocket stream for your own use. Posting alerts to a public channel or app is redistribution and needs an Enterprise licence.

Code

Code examples

Example: today's flagged sweeps for NVDA.

curl "https://api.marketdata.co/v1/options/flow?underlying=NVDA&structure=sweep&date=2026-11-18" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, bullish opening premium by ticker.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/options/flow",
    params={"date": "2026-11-18", "min_premium": 250000},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
flow = pd.DataFrame(resp.json()["results"])
opening = flow[(flow["is_opening"] == True) & (flow["sentiment"] == "bullish")]
print(opening.groupby("underlying_symbol")["premium"].sum().sort_values(ascending=False).head(15))

Pricing

Pricing

Plan Options flow
Pro, $79/mo Alerts 15 minutes delayed, 1 year history, REST
Business, $249/mo Real time over REST and WebSocket, 2 years history, commercial internal use
Enterprise Redistribution (bots, apps), priced on request

A file of every flagged trade in the full market is planned at $49 per month of data. Net premium and flow summaries come bundled; see options net premium data. Prices are early access and may change.

In our research, 6 prices for options flow run from $69 to $1,499 a month, median $124.50.

Side by side

How we compare

9 of the 50 providers we studied sell options flow. Most sell it as a web dashboard, very few sell history as files, and commercial use usually jumps to hundreds a month. We publish the rules behind every alert, sell monthly files you keep, and price real-time commercial internal use at $249. The record shares field names with our options tick data, so you can drop down to the raw trades behind any alert.

FAQ

Frequently asked questions

What makes a trade "unusual"?

A trade is flagged when it meets one or more rules, such as premium over $100,000, an intermarket sweep, or size above open interest. The rules it met are listed in alert_rules on each record.

What's the difference between a sweep and a block?

A sweep is one order filled across several exchanges in quick succession, usually because the buyer wanted size immediately. A block is a single large print, often negotiated.

How is sentiment decided?

From the side and the option type: calls bought at the ask and puts sold at the bid are bullish, and the reverse are bearish. Mid-price fills are neutral. It's a guess about intent, so treat it as one.

Is is_opening certain?

No, it's an estimate. A trade bigger than the prior day's open interest must include some opening contracts, but we can't know for sure until OCC publishes the next morning's OI.

What time zone are alerts in?

UTC, ISO 8601. Convert to New York time for display.

Keep reading