Skip to main content
Buy spot, sell a dated future, and hold to expiry: the cash-and-carry trade. The scanner prices every Binance, OKX and Bybit dated contract at the spot ask and the futures bid, charges each venue’s taker fees, and ranks rows by fee-adjusted annualized basis, executable rows first.

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

string
Optional base coin. Supported launch coins: BTC, ETH, SOL, XRP, DOGE, MNT, XAUT.
string
Comma-separated exchanges: Binance, OKX, and Bybit. Deribit has no spot leg, so it appears only in calendar spreads.
number
Minimum netApr, as a fraction (0.04 is 4%).
number
Minimum open interest in USD.
number
Minimum 24h futures volume in USD.
number
Minimum executable depth in USD. Rows without depth are filtered out when this is set.
string
Futures margin filter: linear, inverse, or both.
number
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.
integer
Rows per page. Defaults to 100.
string
Opaque cursor from the previous page.
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.