Follow the trades that matter to you
Build a watchlist or dashboard around incoming trades, with contract details, execution prices, and premiums in every view.
Bring real-time options order flow into your own tools. Stream trades with sweep detection, premiums, Greeks, and unusual-activity scores in structured JSON.
Live stream in beta · Subscription required
Bullflow groups related sweep executions and enriches trades with contract details, Greeks, and SigScore. You decide what to build.
Build a watchlist or dashboard around incoming trades, with contract details, execution prices, and premiums in every view.
Filter incoming activity by ticker, premium, or SigScore. Turn your own criteria into alerts for the trades that matter to you.
Query historical options flow, then add net premium or gamma exposure from the wider API to explore the bigger picture.
Connect with your API key. Receive new options trades as Server-Sent Events and put each JSON event to work.
View API referencecurl --no-buffer \
'https://api.bullflow.io/v1/streaming/live-options-flow' \
--header 'X-API-Key: YOUR_API_KEY'The live stream is in beta. API-key access requires an API subscription: $129 monthly or $1,188 billed yearly ($99 per month equivalent). Bullflow Premium subscribers can also connect through OAuth with api:read permission. Prepaid credits do not include streaming. Keep credentials on your server.
HTTPS / Server-Sent Events
import json
import os
import requests
# Install requests and set BULLFLOW_API_KEY in your environment.
with requests.get(
"https://api.bullflow.io/v1/streaming/live-options-flow",
headers={"X-API-Key": os.environ["BULLFLOW_API_KEY"]},
stream=True, timeout=(10, 35),
) as response:
response.raise_for_status()
for line in response.iter_lines(chunk_size=1, decode_unicode=True):
if line and line.startswith("data:"):
message = json.loads(line[5:].strip())
if message.get("event") == "trade":
print(message["data"])Minimal Python example using requests. For production, handle disconnects and reconnect with backoff; honor Retry-After on 429 responses. Reconnecting does not replay missed trades.
curl --get 'https://api.bullflow.io/v1/data/historicalOptionsFlow' \
--header "X-API-Key: $BULLFLOW_API_KEY" \
--data-urlencode 'date=2026-10-30' \
--data-urlencode 'ticker=SPY' \
--data-urlencode 'limit=100'Choose an available past trading date. This example requests one page; use the returned cursor for more. Historical flow costs 5 prepaid credits per successful request, with credit purchases starting at $5. API subscriptions also cover this endpoint.
{
"event": "trade",
"data": {
"ticker": "SPY",
"optionType": "C",
"strikePrice": 650,
"tradeType": "SWEEP",
"side": "Ask",
"premium": 150000,
"tradeSize": 500,
"sigScore": 0.85
}
}Illustrative trade event excerpt. See the API reference for the complete response.
An unusual options flow API gives your software access to options trades and the context needed to investigate unusual activity. Bullflow includes sweep detection, trade premiums, execution details, Greeks, and SigScore, an unusualness score from 0 to 1. It provides market data, not a prediction of future prices.
Yes. The live options flow stream delivers newly published trades over Server-Sent Events (SSE). Historical trades are available through a separate endpoint with date, ticker, contract, and premium filters. The live stream does not replay missed trades when you reconnect.
Choose an API subscription, generate a key in your API dashboard, and send it in the X-API-Key header. Each key supports one active live-flow connection. Prepaid credits cover supported REST requests, but do not include streaming. OAuth access is also available with an active Bullflow Premium or API subscription.
Standard Bullflow API subscriptions cover personal use. Contact Bullflow before including the data in a commercial product or redistributing it to customers so we can discuss the appropriate license.
Yes. GET /v1/optionsFlowClosingSnapshotSummary?ticker=SPY needs no key or payment and returns the latest available closing session’s totals and up to 12 of its largest trades by premium. Historical options flow costs 5 prepaid credits per successful request, with credits starting at $5. The live stream requires an API subscription, or Bullflow Premium through OAuth.
Options flow APIs can provide raw trades or classified activity. With raw feeds, developers classify sweeps, blocks and unusual trades themselves. Classified flow APIs, such as Bullflow’s, identify sweeps and blocks and provide unusualness scores. Coverage, classification methods and access vary by provider.
Choose an API subscription, create your key, and bring unusual options activity into your workflow.
API subscriptions are for personal use; contact us about commercial licensing.