DEV Community

Cover image for The Options Flow & Dealer Positioning API: A Complete Map of Every Endpoint
tomasz dobrowolski
tomasz dobrowolski

Posted on • Originally published at flashalpha.com

The Options Flow & Dealer Positioning API: A Complete Map of Every Endpoint

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 read on the options market, they all live behind one key, one base URL (https://lab.flashalpha.com), and one auth header (X-Api-Key).

This post is the index. Each endpoint links to its own deep-dive guide.

pip install flashalpha

from flashalpha import FlashAlpha
fa = FlashAlpha("YOUR_KEY")
gex = fa.gex("SPY")
print(f"Gamma flip: {gex['gamma_flip']}")
Enter fullscreen mode Exit fullscreen mode

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 you will make.

Exposure (settled) Flow Analytics (live)
Route prefix /v1/exposure/* /v1/flow/*
Based on Settled open interest snapshots Settled OI plus an intraday flow simulator
Use when You want the official, stable picture You want the flow-adjusted picture before OI re-settles
Goes stale After the intraday OI re-snapshot (~10:30 ET) Updates continuously with flow

The two are paired. Most exposure concepts (GEX, levels, pin risk, 0DTE) exist in both a settled and a live form. Pick settled for stability, flow for freshness. With that in hand, here is the full map.

1. Exposure & Greeks (settled positioning)

Per-strike Greeks, key levels, and term structure, computed from official open interest.

Question Endpoint Tier
Where is dealer gamma by strike? /v1/exposure/gex Basic+
What is dealer directional bias? /v1/exposure/dex Basic+
How does hedging react to vol & time? /v1/exposure/vex, /chex Basic+
Where are the call/put walls & flip? /v1/exposure/levels Growth+
Where is the pinning strike? /v1/maxpain Basic+
One unified per-strike Greek sheet? /v1/exposure/sheet Growth+
Which expiry drives the regime? /v1/exposure/term-structure Growth+
What positioning changed overnight? /v1/exposure/oi-diff Growth+
Is a sector or my book short gamma? /v1/exposure/basket Growth+
Give me the read in plain English /v1/exposure/narrative Growth+

2. Live Flow Analytics (flow-adjusted positioning)

The same concepts, recomputed intraday against the flow-driven OI simulator. Fresher than settled exposure during the session.

Question Endpoint Tier
What's the headline flow shift & direction? /v1/flow/summary Growth+
Where are the live walls & flip? /v1/flow/levels Growth+
What's the live pin risk? /v1/flow/pin-risk Growth+
How has dealer risk shifted on flow? /v1/flow/dealer-risk Alpha+
Full live GEX/DEX surface & OI state? /v1/flow/gex, /dex, /oi, /live Alpha+

3. The raw flow tape & cross-symbol scans

Trade-level flow and market-wide ranking. The "what is actually printing, and where" layer. Alpha plan.

Question Endpoint Tier
Recent prints, blocks, cumulative net flow? /v1/flow/options/{symbol}/... Alpha
Where's the unusual activity, ranked? /v1/flow/options/outliers, /leaderboard Alpha
Scored unusual options activity? /v1/flow/signals Alpha
Are dealers net long or short premium? /v1/flow/options/{symbol}/dealer-premium Alpha
Equity (stock) flow tape & bars? /v1/flow/stocks/{symbol}/... Alpha

4. 0DTE (same-day expiry)

Same-day options drive a disproportionate share of intraday price action. These endpoints are scoped to today's expiry.

Question Endpoint Tier
Live 0DTE regime snapshot? /v1/flow/zero-dte/snapshot Growth+
0DTE regime over time (chartable)? /v1/flow/zero-dte/series Growth+
Is a gamma squeeze building right now? /v1/flow/zero-dte/hedge-flow Growth+
0DTE analytics (settled)? /v1/exposure/zero-dte Growth+

Newest additions

Four endpoints that round out the surface:

  • 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 - 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.

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, summary/sheet/basket/narrative, term structure, OI diff, Flow Analytics levels/pin/summary, 0DTE flow
Alpha from $1,199/mo Full flow analytics, the raw flow tape, flow signals, dealer premium, cross-symbol scans

Prices shown are annual billing. Month-to-month is 20% higher. Free key, no credit card: https://flashalpha.com/pricing

FAQ

What's the difference between exposure and flow endpoints? /v1/exposure/* computes positioning from settled open interest, the stable picture that goes stale after the intraday OI re-snapshot. /v1/flow/* recomputes the same concepts intraday against a flow-driven simulator, so they stay current through the session.

Which endpoints do I need for dealer positioning? 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 book. For intraday freshness, add the Flow Analytics equivalents.

Is the whole surface on one plan? No. Settled Greeks and max pain start on Basic. Levels, the summary/sheet/basket/narrative, term structure, OI diff, Growth-tier Flow Analytics and 0DTE flow are on Growth. The full live flow analytics, the raw tape, signals, dealer premium and cross-symbol scans are on Alpha.


Originally published at flashalpha.com. The historical host mirrors every live endpoint with a ?at=YYYY-MM-DDTHH:mm:ss parameter, identical response shapes, SPY from 2018 onward at minute resolution. Same SDK code, base-URL swap.

Top comments (0)