Schema
The fields that matter
A flow alert in our OPT-FLOW schema carries these fields, among others:
premium: price × size × 100. The dollar amount spent, which is a better size measure than contract count.side: whether the trade was at or near theask(likely buyer-initiated), at thebid(likely seller), or in between.structure:sweep(one order split across several exchanges to fill fast),block(one large print), orsplit.volume,open_interestandvolume_oi_ratio: whether today's volume is large compared with existing positions.is_opening: our estimate of whether the trade opened a new position.days_to_expirationandimplied_volatility: what kind of bet it is.
Worked example (illustrative numbers)
Two alerts on the same stock, same afternoon:
| strike_price | option_type | days_to_expiration | size | price | premium | side | structure | volume | open_interest |
|---|---|---|---|---|---|---|---|---|---|
| 55 | call | 9 | 3,000 | 1.20 | 360,000 | ask | sweep | 4,100 | 600 |
| 45 | put | 65 | 5,000 | 2.10 | 1,050,000 | bid | block | 5,200 | 22,000 |
The call alert has every sign of a fresh directional bet. It was bought at the ask, swept across exchanges for speed, short dated, and today's volume is almost seven times the open interest. Unless the open interest jumps tomorrow by thousands of contracts, you can't confirm it opened, but it's a good candidate.
The put alert is bigger in dollars but much less clear. It traded at the bid, so someone probably sold it. Open interest was already 22,000, so it may be a fund closing or rolling a hedge. "Bearish $1M put block" is how a feed might label it; "large put sale, possibly closing" is closer to the truth.
Code
Filter flow in Python
"""Example: keep alerts that look like fresh, aggressive positioning."""
import pandas as pd
flow = pd.read_csv("flow_alerts.csv", parse_dates=["timestamp"])
strong = flow[
(flow["premium"] >= 250_000)
& (flow["side"].isin(["ask", "above_ask"]))
& (flow["volume_oi_ratio"] > 2)
& (flow["days_to_expiration"].between(1, 60))
]
summary = (strong.groupby(["underlying_symbol", "option_type"])["premium"]
.agg(["sum", "count"])
.sort_values("sum", ascending=False))
print(summary.head(15))
The output is premium bought aggressively, by underlying and option type, after removing small trades and trades into existing open interest. A name with heavy call premium and little put premium on the same day is the pattern most flow traders look for. Then check the next day's open interest for those strikes. If it rose by roughly the size of the alerts, the trades were opening. Otherwise they were closing or day trades.
Watch out
Common mistakes
Trusting the bullish or bearish label. Labels usually come from side and option type alone. A call bought at the ask can be one leg of a spread, or a hedge for a short stock position.
Ignoring multi-leg trades. A large call print paired with an equal put print at the same moment is often a risk reversal or a collar. Look for matching prints in the same second before reading either leg alone.
Counting contracts instead of premium. 5,000 contracts at $0.05 is $25,000. 300 contracts at $8.00 is $240,000. Rank by premium.
Skipping the open interest check. Flow is only interesting if it opened a position. Tomorrow's open interest change is the cheapest confirmation you have.
Reacting to delayed data as if it were live. Our delayed flow runs 15 minutes behind. That is fine for research and end-of-day review, but don't treat a delayed sweep as a signal to chase.
Details
Get the data
Flagged sweeps, blocks and unusual activity, with the context to judge them. What you'll get:
premium,side,structure,volume_oi_ratio,is_opening,sentimentand the rules that triggered each alert.
- Options flow data, available in early access. Flow alerts 15 minutes delayed with 1 year of history are planned for Pro ($79/mo); real time for Business ($249/mo).
- Daily roll-ups: options net premium data
- A free flow sample file is available on request.
FAQ
Frequently asked questions
How do you read options flow?
Start with premium, side and structure: how much money, whether it was bought or sold, and whether it was a sweep or a block. Then compare volume with open interest to judge whether it opened a new position. Confirm the next day by checking whether open interest rose.
What is an options sweep?
A sweep is one order split across several exchanges to fill quickly at the best available prices. Traders read it as urgency, since the buyer or seller accepted worse prices on some exchanges to get filled at once.
Is unusual options activity a buy signal?
Not by itself. Many large trades are hedges, spreads or closing trades. Unusual activity is a lead to investigate, and most of it doesn't lead to a tradable move.
What is the difference between a block and a sweep?
A block is a single large trade, often negotiated, printed on one exchange. By contrast, a sweep is many smaller fills across exchanges in quick succession. Blocks are more often institutional hedges; sweeps more often signal urgency.
Keep reading