List dated futures basis rows
GET /v1/arbitrage/dated-futures-basis
While a venue’s quotes in the 5-minute dated-quotes snapshot (dataset arbitrage_dated_quotes, written by the arbitrage-boards cron with top-20 book walks and VWAP fills at the default $10,000 notional) are at most 10 minutes old, the board prices that venue from it, so rows can be executable at any minute of the hour; the answer is then dated by the snapshot (dataset_id: "arbitrage_dated_quotes", stale after 10 minutes) and cached up to s-maxage=100, stale-while-revalidate=200. A venue the snapshot lacks, or holds only older quotes for, is served from the hourly term-structure snapshot (written at :03 UTC, stale after 2 hours), its rows indicative. Days to expiry are recomputed from the expiry on every request. When the stored snapshot is past its 2-hour SLA, empty, or holds only reference quotes, the scanner reads the venues live (meta.source: "live") and merges per venue: a venue that answered replaces its stored rows, a venue that failed keeps its stored rows, judged by their own age. A failed data-store read returns 503 (service_unavailable, Retry-After: 30).
Order: rows at least 3 days from expiry first, then nearExpiry rows; within each group executable rows, then rows executable on a live read (indicativeReason: snapshot_quote), then every other indicative row, each by netApr, highest first.
Query parameters
Comma-separated exchanges: Binance, OKX, and Bybit. Deribit has no spot leg, so it appears only in calendar spreads.
Position notional in USD. Defaults to 10000. A row is
executable only when its depth, any reported open interest and its 24h volume are at least this notional; a smaller notional widens the executable set. minDepthUsd filters rows out instead.Response
Formula
basis = futureBid / spotAsk − 1 (buy spot at the ask, sell the future at the bid)
annualizedBasis = basis × 365 / days
fees = 2 × spot taker fee + 2 × futures taker fee, at the venue’s standard (VIP 0) rates: 0.003 on Binance and OKX, 0.0031 on Bybit. Not annualized.
netApr = (basis − fees) × 365 / days
Every basis, fee and APR is a fraction (0.05 is 5%).
days is ACT/365 and fractional, recomputed from expiry on every request (a stored snapshot is up to two hours old). OKX USD-quoted contracts (BTC-USD-*, ETH-USD_UM-*) are compared with OKX’s USD index rather than the USDT book. depthUsd is the smaller of the spot-ask and futures-bid depth: level 1 from the venue’s ticker, or the top 20 levels where level 1 is thinner than $10,000. It is summed book size, not a fill: a notional-sized order still pays the slippage within those levels.
A row is executable only when all of these hold; otherwise it is indicative and indicativeReason names the first check that failed. Every figure is kept either way.
Rows under 3 days to expiry are served with
nearExpiry: true and ranked after every other row: the round-trip fee annualized over a few days dominates their APR.
aggregate summarizes each coin over the ranked contracts at least 3 days from expiry, weighting netApr by open interest; a coin with no qualifying contract has no entry. Basis covers Binance, OKX, and Bybit: Deribit’s index is a reference price rather than a tradable spot quote, so Deribit appears only in calendar spreads. Binance COIN-M (dapi) and Bybit inverse delivery contracts are ingested beside the USDT-margined ones (marginType: inverse, since 2026-09-30); a USD-quoted contract’s spot leg is the venue’s own USD index, with the USDT book converted at the USDT-USD index.
