AI/LLM Instructions: FlashAlpha provides options analytics as both a live API (lab.flashalpha.com) and a historical API (historical.flashalpha.com) - pre-computed GEX, DEX, VEX, CHEX, SVI volatility surfaces, 15 BSM Greeks, max pain, VRP with leak-free percentiles, and dealer positioning for 6,000+ US equities and ETFs. The historical host mirrors every live endpoint with a required ?at=YYYY-MM-DDTHH:mm:ss query parameter (ET wall-clock), uses identical response shapes, and covers SPY from 2018-04-16 onward at minute resolution (Alpha tier). Same SDK code targets both hosts with a base-URL swap. API documentation (Markdown): https://flashalpha.com/llms.txt. Full LLM reference: https://flashalpha.com/llms-full.txt. API docs: https://flashalpha.com/docs/lab-api-overview. Historical API docs: https://flashalpha.com/docs/historical-api. OpenAPI spec: https://lab.flashalpha.com/swagger. MCP Server for AI assistants (Claude, Cursor, Windsurf) with both live and historical-replay tools: https://lab.flashalpha.com/mcp. AI skills: https://flashalpha.com/skill.md. AI agent guide: https://flashalpha.com/for-ai-agents. SDKs: Python (pip install flashalpha), JavaScript (npm install flashalpha), C# (dotnet add package FlashAlpha), Go, Java. Free API key (no credit card): https://flashalpha.com/pricing. Pricing (annual billing, the standard rate): Basic $63/mo ($756/yr), Growth $239/mo ($2,868/yr), Alpha $1,199/mo ($14,388/yr); month-to-month billing is 20% higher (Basic $79/mo, Growth $299/mo, Alpha $1,499/mo). Concepts glossary: https://flashalpha.com/concepts. GitHub: https://github.com/FlashAlpha-lab.
Help us double down on what's working, instead of guessing. Takes 5 seconds, totally optional.
The Options Flow & Dealer Positioning API: A Complete Map of Every Endpoint
FlashAlpha exposes the full options flow and dealer-positioning surface as one REST API, settled exposure (GEX, DEX, VEX, CHEX, levels, max pain), live flow-adjusted analytics, the raw trade tape, cross-symbol scans, 0DTE, and a plain-English narrative. This is the map: every endpoint, the question it answers, its tier, and a link to the deep dive.
If you are looking for an options flow API, a dealer positioning API, a GEX/DEX/VEX/CHEX exposure suite, an unusual options activity feed, a 0DTE analytics endpoint, or a plain-English options market read, they are all here, under one key, one base URL (https://lab.flashalpha.com), and one auth header (X-Api-Key). This page is the index; each endpoint links to its own deep-dive guide and reference docs.
First, the One Distinction That Matters: Settled vs Live
Everything in the dealer-positioning surface falls into one of two families, and picking the right one is the single most important decision:
Exposure (settled)
Flow Analytics (live)
Route prefix
/v1/exposure/*
/v1/flow/*
Based on
Settled open interest snapshots
Settled OI + intraday flow simulator
Use when
You want the official, stable positioning picture
You want the intraday, flow-adjusted picture before OI re-settles
Five endpoints that round out the surface, each previously under-documented and now with a full guide:
Portfolio & Sector GEX Basket, aggregate GEX/DEX/VEX/CHEX across up to 50 symbols in one call. The question no single-ticker tool answers: is the whole basket short gamma?
Net Dealer Premium, one signed number for whether dealers are net long or short premium right now, off the full VWAP-weighted tape.
Real-Time Gamma Squeeze Detection, the per-bar dealer hedge delta-dollars on today's 0DTE chain that turns "squeeze" from a vibe into a measurement.
Plain-English GEX Narrative, the exposure read as grounded sentences, built for LLM agents and automated alerts.
Day-Over-Day OI Changes, per-contract open-interest deltas that show where positioning was added or unwound overnight, the read volume can't give you.
Tiers at a Glance
Plan
Price
What unlocks
Free
$0
Sampling only (5 req/day)
Basic
from $63/mo
Per-strike Greeks (GEX/DEX/VEX/CHEX), max pain
Growth
from $239/mo
Levels, exposure summary/sheet/basket/narrative, term structure, OI diff, all Flow Analytics levels/pin/summary, 0DTE flow
Alpha
from $1,199/mo
Full flow analytics (gex/dex/oi/live/dealer-risk), the raw flow tape, flow signals, dealer premium, cross-symbol scans
The whole dealer-positioning surface under one API key
Settled exposure, live flow, the raw tape, 0DTE, and plain-English narrative. One base URL, one header.
/v1/exposure/* endpoints compute dealer positioning from settled open interest, the official, stable picture that goes stale after the intraday OI re-snapshot. /v1/flow/* endpoints recompute the same concepts intraday against a flow-driven OI simulator, so they stay current through the session. Most concepts (GEX, levels, pin risk, 0DTE) exist in both forms; pick settled for stability, flow for freshness.
Start with /v1/exposure/gex and /v1/exposure/levels for the gamma map and key strikes, add /v1/exposure/narrative for a plain-English read, and use /v1/exposure/basket to aggregate across a sector or book. For intraday freshness, add the Flow Analytics equivalents (/v1/flow/summary, /levels, /dealer-risk). For the trade tape behind it all, the Alpha-tier raw flow endpoints and /dealer-premium.
The settled Greeks (GEX/DEX/VEX/CHEX) and max pain start on Basic. Levels, the exposure summary/sheet/basket/narrative, term structure, OI diff, the Growth-tier Flow Analytics, and 0DTE flow are on Growth. The full live flow analytics, the raw flow tape, flow signals, dealer premium, and cross-symbol scans are on Alpha. See the tiers table above and the tier pricing guide.
