List cross-exchange opportunities
GET /v1/arbitrage/cross-exchange
Returns one row per asset: its executable pair with the highest netApr, else its best no_depth pair (book-priced, a venue reports no size), else its largest gross differential (indicative). Legs pair within one instrument-master asset, so lot spellings of one coin (BONK, 1000BONK, KBONK) pair with each other and prices compare per asset unit. Rows rank executable first by netApr, then no_depth rows (a venue reports no book size), then the other indicative rows, each by netApr where they have one, else gross apr.
The board is composed every 5 minutes by a scheduled job, never per request, and is stale after 10 minutes; each pair is priced again at the time of the request from its legs’ own quote times, so a quote older than 10 minutes makes the row indicative (stale_quote). An asset needs current funding with a verified per-market settlement interval on at least two selected venues. Only funding rates inside the 10-minute freshness window are paired, and a venue that reports a market as not trading (halted, settling, delisted or pre-launch) is left out for it. With no board to serve the endpoint answers 503 (service_unavailable, Retry-After: 30).
Query parameters
Comma-separated list of venues to include, e.g.
Binance, OKX, Bybit, Hyperliquid, WhiteBIT, Kraken, Lighter. Omit to include all venues. X-Data-Venues lists the venues a filter can offer.Minimum open interest in USD on the smaller leg. Defaults to
0 (no floor). A leg with unknown OI fails a positive floor. The floor applies to each asset’s chosen pair: a failing asset leaves, it is not re-paired.Minimum 24h perp volume in USD on the smaller leg. Defaults to
0 (no floor). A leg with unknown volume fails a positive floor.Underlying filter. One of
all (default), crypto, or rwa — the latter covering equity, commodity, FX and index perps. Pairing always stays within one asset class.Narrative filter. One of
all (default), memes, ai-agents, layer-1 or defi: keeps only crypto coins in that narrative’s CoinGecko category, the constituents the narratives endpoint lists. A coin the category does not list, and every RWA perp, is left out when a sector is set. The free route reads it too.Return at most this many rows, the first in board order. Omit it (and
cursor) for every row. On v1 a limited answer carries pagination.Opaque cursor from the previous page’s
pagination.cursor (100 rows a page when limit is omitted).Response headers
Besides the freshness headers, both the v1 and the free route send:X-Data-Missing: each configured venue that is not a quoted member of the board, comma-separated asVenue:reason.not_live(every contract halted; the venue is not asked),stale(no funding row inside the funding SLA),no_ticker(its rows are served unpriced: its ticker or book reads failed). edgeX, ApeX and GRVT publish no bulk ticker, so their legs are priced from per-contract top-of-book reads of the board’s contracts (up to 60 per venue, 5 at a time, cached 60 s). Absent when every venue is a quoted member.X-Data-Venues: the venues a venue filter may offer, comma-separated: the configured venues less thosenot_liveorstale(a venue whose funding rows are all past the funding SLA, such as a halted venue, is not offered).
Response
Formulas
All rates are decimal fractions. Each leg’s funding rate is per its own market’s interval (longIntervalHours, shortIntervalHours); both are normalized to hourly before they are compared, so mixed 1h/4h/8h legs compare correctly. A tool that annualizes every rate as if it were 8-hourly shows a 1-hour leg 8× smaller and a 4-hour leg 2× smaller than it pays.
netFundingRate = (shortRate / shortIntervalHours − longRate / longIntervalHours) × intervalHours, at the faster leg’s cadence (intervalHours).apr = |netFundingRate| × 8760 / intervalHours(gross, simple).spreadRate = (longAsk − shortBid) / midpointfrom both books (spreadSource: book), else from last or mark prices (reference), elsenull. Prices are per asset unit (a1000PEPEcontract’s price ÷ 1000).roundTripFeeRate = 2 × long-venue taker fee + 2 × short-venue taker fee, each venue’s standard (VIP 0) perpetual rate.netApr = apr − (roundTripFeeRate + max(spreadRate, 0)) × 365 / 30, only on book-priced rows. A favourable (negative) spread is never credited as income.breakEvenDays = (roundTripFeeRate + max(spreadRate, 0)) ÷ (apr / 365);nullwithout anetApr.
executable when its spread is book-priced, the legs’ prices are within 5% of each other, both quotes are at most 10 minutes old at the time of the request, and both venues report top-of-book depth of at least $10,000. Unknown depth is not evidence of a fill. Otherwise it is indicative. The board ranks executable rows first, then no_depth rows, then the other indicative rows:
Response fields
Each object in thedata array is the chosen long/short pair for one asset.
Underlying category:
crypto, equity, commodity, fx, or index. A pair’s two legs always share it.apr after both venues’ taker fees and the adverse entry spread over a 30-day hold. Present only on book-priced rows; every executable row has one.Two perpetual taker fills on each venue at its standard fee, as a fraction of notional.
The smaller of the long venue’s ask size and the short venue’s bid size in USD, among the venues that report one. With only one venue reporting it is that leg’s figure, an upper bound, and the row is
indicative; null when neither venue reports depth.executable or indicative (see Formulas). Indicative rows keep every figure and rank below executable ones.Whether the legs are one instrument:
eligible, unpriced (a leg has no price to check), else the first check that failed: identity_mismatch, not_live, contract_type, margin_type or price_gap (more than 20% apart).Open interest in USD on the long leg, from the venue’s ticker, else the contract’s latest stored open interest.
null when unknown, never 0.ISO 8601 time of the sooner of the two legs’ next settlements, or
null when neither venue reports it.The long leg’s own next settlement. On a mixed-interval pair (4h against 8h) the slower leg’s larger print lands at its own time, which
nextSettlement does not show.Indicative row (a leg without a price)

