Bullflow API

Real-time unusual options flow alerts API and MCP server

Stream low-latency options flow alerts over server-sent events (SSE), connect AI agents through MCP, manage custom alerts, and query net GEX, net VEX, and peak return data. Bullflow API is designed for traders and developers building automated scanners, notification systems, and research pipelines.

Get Started Read API Docs

What you get with Bullflow API

Real-time Bullflow alerts

Receive algorithmic options flow alerts as they are detected.

Custom alert delivery

Create custom filters in Bullflow and stream them through the same feed.

Developer-first integration

Simple endpoints, production-ready payloads, and straightforward onboarding.

Historical backtesting

Replay one trading day over SSE with saved custom alerts and Bullflow algo alerts in timestamp order.

Peak return data

Query contract-level peak price and peak percent return after a trade timestamp.

Net GEX and net VEX data

Fetch strike and expiration-level gamma and vanna exposure for an underlying ticker.

Alert management

Create saved custom alerts and retrieve existing custom alert configurations through JSON endpoints.

MCP server for AI agents

Connect coding agents to Bullflow API tools so they can inspect docs, draft requests, and build alert workflows faster.

API endpoints

Stream and backtest alerts, manage custom alerts, fetch net GEX and net VEX, and score option contracts with post-trade peak return data.

GET /v1/streaming/alerts

Stream Bullflow algo alerts and custom alert matches for your API key account in real time over SSE.

GET /v1/streaming/backtesting

Replay a historical trading day over SSE with date and speed controls, ready events, heartbeat events, alert payloads, and a completion summary.

GET /v1/data/netgex

Return net GEX by strike and expiration for an underlying ticker, including call, put, and net GEX rows.

GET /v1/data/netvex

Return net VEX by strike and expiration for an underlying ticker, including call, put, and net VEX rows.

GET /v1/data/peakReturn

Submit an option symbol, old price, and trade timestamp to receive the highest price and peak percent return reached after that trade.

GET /v1/alerts/custom-alerts

Return saved custom alerts for the account associated with your API key.

POST /v1/alerts/create-alert

Create a saved custom alert for your API key account using clean filter fields and dashboard-style quick filters.

Read the endpoint docs

MCP server for AI agents

The Bullflow MCP server lets AI coding agents connect directly to structured API docs and supported Bullflow tools. Agents can use it to accelerate integration work, generate cleaner request code, inspect endpoint behavior, and create more intelligent alert workflows with live alerts, net GEX, net VEX, peak return, and custom alert context. 

https://api.bullflow.io/mcp?key=YOUR_API_KEY

Agent-ready API context

Give Cursor, Claude Code, Codex, and other AI agents a structured Bullflow API surface instead of scattered documentation.

Faster integration loops

Agents can discover endpoint metadata, draft requests, test payload shapes, and wire alert workflows with less manual copy-paste.

Smarter alert design

Combine live flow, net GEX, net VEX, peak return, and saved alert tools so agents can help build richer filters and more context-aware alert logic.

Python quickstart

Connect to the live alerts stream and print the first alert symbol:

import json
import requests
from types import SimpleNamespace

with requests.get(
    "https://api.bullflow.io/v1/streaming/alerts",
    params={"key": "YOUR_API_KEY"},
    stream=True,
) as stream:
    stream.raise_for_status()
    for line in stream.iter_lines(decode_unicode=True):
        if not line or not line.startswith("data: "):
            continue
        payload = json.loads(line[6:], object_hook=lambda d: SimpleNamespace(**d))
        if payload.event != "alert":
            continue
        print(payload.data.symbol)
        break

Simple API pricing

Monthly plan: $129/month. Yearly plan: $99/month billed annually. Both include Bullflow platform access, the real-time Alerts API, MCP server access, custom alert endpoints, historical backtesting, net GEX, net VEX, and peak return data.

Start Subscription View Pricing Details

Common API questions

  • How does it work? Connect to the stream endpoint and process real-time alert payloads in your app.
  • Can I create custom alerts? Yes. Custom dashboard alerts are delivered through the API feed, and historical backtesting evaluates replayed trades against your current saved custom alert set.
  • Can I backtest alerts? Yes. Use the backtesting endpoint to replay a historical trading day over SSE with saved custom alerts and Bullflow algo alerts in timestamp order.