Options flow API for real-time and historical trades

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

Options trades, sweep activity, and contract details flow through Bullflow into dashboards, custom alerts, and research tools. Market activityBullflowYour tools Process & enrichSSE / JSON
Market activity → Bullflow → your tools · Illustrative data flow

Turn options activity into tools of your own

Bullflow groups related sweep executions and enriches trades with contract details, Greeks, and SigScore. You decide what to build.

Illustrative options dashboard with a watchlist of incoming SPY, NVDA, and AAPL trades.

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.

Illustration of ticker activity passing through premium and SigScore filters to produce a matching sweep alert.

Build alerts around your own criteria

Filter incoming activity by ticker, premium, or SigScore. Turn your own criteria into alerts for the trades that matter to you.

Illustrative five-session chart comparing trade volume and net premium trends for historical research.

Explore the activity behind the move

Query historical options flow, then add net premium or gamma exposure from the wider API to explore the bigger picture.

Start streaming with a single connection

Connect with your API key. Receive new options trades as Server-Sent Events and put each JSON event to work.

View API reference
GET Live options flow · cURL

Your first connection

curl --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

Live options flow · Python
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.

Query historical options flow

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.

Trade event · Example JSON
{
  "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.

What to know before you connect

What is an options flow API?

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.

Is options order flow available live and historically?

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.

How do I get access to the options flow API?

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.

Can I use the data in a commercial product?

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.

Is there a free options flow API?

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.

Which APIs provide options flow data?

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.

Build your next trading tool with Bullflow

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.