Cross-venue book
Consolidated best bid and offer across every venue we collect, with the venue named on each side, plus how far apart venues are quoting the same contract.
/options/chain returns. The chain’s
bid and ask come from the aggregated row, which is based on a single venue.
This endpoint is the genuine best-of, and by construction its spread is never
wider than any individual venue’s.
Scope
Computed only for contracts inside the liquid band: 0.85 to 1.15 moneyness, 2 or more days to expiry. Outside that band implied vol stops carrying information. Deep-ITM contracts have almost no vega, so a trivial price difference reads as tens of vol points. Before the band was applied, the widest apparent “dislocation” in a live run was 52 vol points on a 60,000 strike with spot at 77,600, which is an artefact rather than a signal. Contracts quoted by a single venue are omitted, since every field here is a comparison. A symbol with no multi-venue coverage returns404 rather than an
empty list, because an empty list reads as “spreads are zero”.
Units
All prices are coin-denominated, and the response states this inprice_unit.
Most venues publish option premium in USD or USDT; those are converted at
ingest. Deribit quotes its linear (USDC-settled) assets in USD and is converted
the same way, while its BTC and ETH options are inverse and already coin-
denominated. Do not infer the unit from magnitude: comparing an unconverted USD
premium against a coin premium is exactly how a spread of -195% gets published.
Reading the fields
true only when two different venues make the top of book. When false,
one venue is best on both sides, so the spread shown is that venue’s own and
there is no consolidation benefit to report.true when both sides come from a deep venue (Deribit, Bybit, OKX, Binance).
When false the best price is coming from a thinner venue. Still worth
seeing, but not a number to lean on.median_spread_pct so the headline is not dragged
below what trading actually costs, and sorted after every tradeable spread so
the first page is books you can act on. On a typical BTC chain a majority of
in-band contracts are crossed, so ordering on the raw number would bury the
executable ones. Use crossed_only=true to select them.Coverage
Venue coverage is not uniform, and the response tells you which venues actually contributed viavenues per contract and coverage.venues overall.
See also
Options chain
Venues
Authorizations
Your BackQuant API key (same key as v1)
Headers
Query Parameters
Trading symbol: BTCUSDT, ETHUSDT, SOLUSDT, or HYPEUSDT.
BTCUSDT, ETHUSDT, SOLUSDT, HYPEUSDT Comma-separated expiry tokens, e.g. 26DEC25,27MAR26.
Restrict to calls or puts.
call, put Return only contracts where best bid vol exceeds best ask vol. Read the note on crossed above before acting on this.
Ordering for the returned contracts. The two spread sorts rank tradeable (non-negative) spreads first and crossed books last - see Ordering above.
spread, spread_pct, dispersion, strike Max contracts returned.
1 <= x <= 1000Response
Successful Response
