Options flow signals API: real orders that match seven tested flow patterns
By Faizan Ahmad. Updated .
The Tradytics options flow signals API serves Signals: live options flow orders that match one of seven flow patterns from a study of 560 million pattern and horizon combinations, each tracked to expiry. Pro, $69 a month.
The study ran on 10.9 million options prints over 378 sessions, joined to real 1-minute stock bars and real option quotes. Each signal is the contract the flow bought, priced at the ask at the print's second, marked every 5 minutes and settled at expiry, with the flow behind it. Pro includes 300 calls a minute and 50,000 a day, on the same key as options flow, dark pool, dealer exposure and the AI Fund's trades.
What the Signals API returns
| Endpoint | What it returns |
|---|---|
GET /signals | Signals newest first, cursor-paged, filtered by pattern (source), symbol, status (open or settled) or day |
GET /signals/{id} | One signal with every 5-minute mark of its contract and the flow behind it: the contract's prints and the ticker's flow in the minutes before it fired |
Base URL https://tradytics.com/api/public/v1. Every request sends Authorization: Bearer YOUR_KEY. Keys are made on the API keys page.
A real response
A Repeat flow signal on November 5, 2026: MSFT December 4 $530 puts bought at 10:48 AM New York, 879 contracts at the $19.08 ask with MSFT at $556.16.
GET /signals?limit=1
{
"data": [
{"id": 509, "day": "2026-11-05", "source": "repeat-flow", "kind": "Repeat flow",
"fired_at": "2026-11-05 10:48:06", "ticker": "MSFT", "cp": "P", "strike": 530.0,
"expiry": "2026-12-04", "price": 19.08, "bid": 18.39, "ask": 19.08,
"premium": 110112, "size": 879, "oi": 8759, "spot": 556.16,
"title": "Repeated MSFT put buying points to downside",
"status": "open", "return": -0.1556, "best": 0.1778}
]
}
One signal with its marks: a ZETA November 20 $35 call from Repeat flow on November 3, 2026, entered at the $1.38 ask and marked every 5 minutes after (first four marks shown):
GET /signals/480
{
"data": {
"id": 480, "day": "2026-11-03", "source": "repeat-flow", "fired_at": "2026-11-03T10:35:39",
"ticker": "ZETA", "cp": "C", "strike": 35.0, "expiry": "2026-11-20", "ask": 1.38, "status": "open",
"marks": [
{"at": "2026-11-03 10:45:00", "value": 1.31},
{"at": "2026-11-03 10:55:00", "value": 1.35},
{"at": "2026-11-03 11:00:00", "value": 1.4},
{"at": "2026-11-03 11:15:00", "value": 1.345}
]
}
}
The fields
| Field | Meaning |
|---|---|
source, kind | The flow pattern the order matched, as an id and a name |
fired_at, day | When the signal fired, New York time, and its session |
ticker, cp, strike, expiry | The contract: underlying, C or P, strike and expiry |
ask, bid, price | The quote at the print's second; ask is the entry |
premium, size, oi, spot | The order's dollars and contracts, the contract's open interest and the stock price |
title | The signal in one line |
status | open, or settled once the contract expires |
return, best | The latest 5-minute mark (or the settlement) against the entry ask, and the highest mark so far, as fractions |
The seven patterns
Signals come from seven sources, each a pattern found in the study of 560 million combinations: Repeat flow (repeat-flow), Opening calls (opening-calls), Heavy calls (heavy-calls), ETF repeat (etf-repeat-calls), ITM puts (itm-puts), Call burst (burst-calls) and Index tide (index-tide-calls). A trained filter hides the weakest prints before a signal fires. Every signal is a real order from the full OPRA tape, priced where you could have bought it, and followed with real quotes to the end. More in the signal patterns and how Signals are built; the feed is at Signals.
How it joins the other datasets
- Options flow: every other order in the same contract and ticker that session, with its side.
- Dealer exposure: where the signal's strike sits against the call wall, put wall and gamma flip.
- Ranked dark pool: whether a top-ranked block printed in the stock around the signal.
- Bars: the stock's path from the fire time to expiry.
The backtester runs the same kind of flow rule in plain words on every order since March 31, 2025, with options filled at the real bid and ask.
From Claude, ChatGPT or Cursor
The Tradytics MCP server at https://tradytics.com/mcp gives agents Signals as a tool, with a signal's full timeline and marks. Ask "What signals fired on MSFT this week?" and the assistant reads them itself, on your Pro limits. More in the Tradytics API and MCP server.
Limits and plan
| Tradytics Pro | |
|---|---|
| Price | $69 a month or $499 a year, with the full app included |
| Rate limits | 300 calls a minute, 50,000 a day |
| Signals in the app | Live on Plus and Pro; a day late on Free |
| Also on the key | Options flow since March 31, 2025, ranked dark pool, dealer gamma, delta, vanna and charm, the options market, Probabilities, AI Fund trades, the scanner, research and market data |
| MCP server | Included |
How it compares
Checked on each platform's own site, November 5, 2026.
| Platform | Market data APIs compared |
|---|---|
| Tradytics | In Pro, $69 a month with the full app: 300 calls a minute, 50,000 a day; options flow since March 2025, ranked dark pool, dealer exposure, Probabilities, Signals and AI Fund trades; MCP server |
| Unusual Whales | Separate: $99 a month (1-year lookback, 25,000 requests a month), $150 (2 years), $375 (WebSocket); MCP with 100+ tools; Polymarket only |
| Quant Data | $149.99 a month, 365+ days of history, 240 requests a minute; MCP |
| Bullflow | $129 a month or pay per request; flow, dealer gamma and dark pool; MCP |
| Quiver Quantitative | From $30 a month; alternative data, no options flow or dark pool prints; MCP |
| Barchart OnDemand | Usage-based pricing; option history and unusual activity; no MCP |
| Cheddar Flow, SpotGamma, OptionStrat, Market Chameleon, MenthorQ, TradeAlgo, InsiderFinance, BlackBoxStocks, Koyfin | No API |
Common questions
Is there an options flow signals API?
Yes. GET /signals returns real orders from the live options flow that match one of seven flow patterns tested across 560 million pattern and horizon combinations, in Pro for $69 a month.
How is a signal priced?
At the ask at the second the order printed, the price you could have bought the contract at. It is marked every 5 minutes and settled at expiry, and every mark is in GET /signals/{id}.
Which flow patterns do the signals use?
Seven: Repeat flow, Opening calls, Heavy calls, ETF repeat, ITM puts, Call burst and Index tide. Each signal names its pattern in source and kind.
Can I see the flow behind a signal?
Yes. GET /signals/{id} returns the contract's prints and the ticker's flow in the minutes before the signal fired, next to its marks.
Can Claude or ChatGPT read Tradytics signals?
Yes. The Tradytics MCP server includes a Signals tool, so Claude, ChatGPT and Cursor can list signals and read one's timeline on your Pro plan.