Models
Pass
?positioning=flow or ?positioning=std. Omit the param to get flow.
Every response that rebuilds live exposure reports the effective model in:
data.positioningwhen presentmeta.extra.positioningandmeta.extra.positioning_requestedmeta.extra.positioning_fallback_reasonwhen flow was requested but std ran instead
Aggregation
Live signed surfaces use:- Chain - multi-venue options chain (Deribit, Bybit, OKX, Binance) for greeks and OI.
- Tape (flow only) - multi-venue aggressor trades for the same coins. Size is coin-normalized so venues can be summed.
qty is flow sold-bought or std signed OI.
Details also appear under meta.extra.aggregation (chain_venues,
flow_venues, flow_method, gex_scale, note).
Coin coverage
If flow is empty for BTC/ETH, the API also falls back to std and sets a
reason such as
flow_tape_empty or flow_qty_all_zero.
Live vs history
Customer flow vs dealer hedge flow
Do not mix these up:
Positive on dealer-flow ≈ estimated dealer buying the underlying to
re-hedge. Positive on delta-flow ≈ net customer buy-side delta notional.
