{"uid":"cap_GL2y-0Vx-6UM90hZwAa6J","slug":"cross-venue-btc-eth-futures-spot-basis-api-16c64845","name":"Cross-Venue BTC/ETH Futures-Spot Basis API","description":"Cross-venue BTC + ETH perp-vs-spot basis across Binance/Bybit/OKX. Per-venue mark/spot/basis/basis_bps/fundingRate/fundingRate_apr_pct, per-symbol aggregate_basis, max_dispersion_bps, avg_funding_apr_pct, verdict (contango>+5bps / flat / backwardation<-5bps). Cash-and-carry arbitrage signal beyond single-venue feeds.","url":"https://nonvisceral-eloisa-mousily.ngrok-free.dev/api/futures-spot-basis","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"source":{"type":"string"},"per_symbol":{"type":"object","description":"Keyed by symbol (BTC, ETH). per_venue + aggregate_basis + max_dispersion_bps + avg_funding_apr_pct + n_venues_reachable + venues_used + verdict."},"updated_at":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2OyzO_zZb5RZxu__bJxJO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-venue and aggregated futures-spot basis, funding rates, and contango/backwardation verdict for BTC and ETH across Binance, Bybit, and OKX","exampleAgentPrompt":"What's the current BTC and ETH perp-vs-spot basis across Binance, Bybit, and OKX right now — are they in contango or backwardation, and is there a meaningful cash-and-carry arb signal?","exampleUseCases":[{"title":"Cash-and-carry arb opportunity scanner","prompt":"Check if there's a profitable cash-and-carry arbitrage opportunity for BTC perps vs spot right now — show me the basis in bps across Binance, Bybit, and OKX and whether it's in contango."},{"title":"Cross-venue basis dispersion alert","prompt":"How dispersed is the BTC futures-spot basis across Binance, Bybit, and OKX right now? I want to know the max dispersion in basis points and which venue is the outlier."},{"title":"ETH funding cost comparison for hedged positions","prompt":"I'm holding spot ETH and want to short ETH perps to hedge — what's the current funding rate APR across Binance, Bybit, and OKX, and what's the aggregate average funding cost I'd be paying?"}],"resultDescription":"A JSON object keyed by symbol (BTC, ETH), each containing per-venue data (mark price, spot price, basis, basis_bps, funding rate, funding rate APR %), plus aggregate metrics: aggregate_basis, max_dispersion_bps, avg_funding_apr_pct, number of venues reached, venues used, and a verdict string indicating contango (>+5bps), flat, or backwardation (<-5bps). Also includes a top-level source and updated_at timestamp.","failureModes":["One or more upstream venues (Binance/Bybit/OKX) unreachable — n_venues_reachable may be less than 3, reducing aggregate reliability","Stale data if upstream exchange APIs are slow or rate-limiting","No query parameters required so no input validation errors expected","ngrok free-tier URL may have uptime or rate-limit constraints","Payment failure (x402) if USDC balance is insufficient for the $0.02 per-call fee"],"whenToPreferThis":"Choose this endpoint when you need a cross-venue, multi-symbol view of the perp-vs-spot basis and funding rates in a single call rather than polling each exchange individually. It is especially valuable for cash-and-carry arbitrage signal detection, cross-venue dispersion analysis, and funding-rate hedging cost estimation across BTC and ETH simultaneously. Prefer it over single-venue feeds when venue-to-venue discrepancies matter or when you want a machine-readable contango/backwardation verdict without building your own aggregation logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:55.209Z","isFirstParty":false}