{"uid":"cap_lZopzY2bPWaAxMlyQ0Y-4","slug":"funding-rates-arbitrage-decision-api-b9203c7f","name":"Funding Rates Arbitrage Decision API","description":"Paid funding rate decision API for AI trading agents across up to 16 perp venues. Settled via x402 on Base mainnet (eip155:8453) using the Coinbase Mogami v2 facilitator; unpaid requests receive a 402 challenge that lists the per-route price.","url":"https://funding-rates-x402.data-labs.cloud/v1/funding/arbitrage","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"venues":{"type":"string","description":"Comma-separated list of venues to include. Omit for all configured venues."},"symbols":{"type":"string","description":"Comma-separated list of canonical uppercase base symbols (e.g. `BTC,ETH`). Omit to receive every symbol the configured venues report."},"minAnnualizedSpread":{"type":"number","description":"Minimum annualized spread (decimal, e.g. `0.05` for 5%). Opportunities below this threshold are filtered out."}}},"responseSchema":{"type":"object","required":["data","meta","warnings"],"properties":{"raw":{"type":"object","additionalProperties":true},"data":{"type":"object","required":["opportunities"],"properties":{"opportunities":{"type":"array","items":{"type":"object","required":["symbol","annualizedSpread","fundingRateSpread","recommendation","confidence","warnings","records","horizonClass","scoredAnnualizedSpread","horizonHaircut"],"properties":{"symbol":{"type":"string"},"records":{"type":"array","items":{"type":"object","required":["venue","symbol","fundingRate","nextFundingTime","funding_kind","funding_interval_hours"],"properties":{"venue":{"enum":["binance","bybit","mexc","gate","bitget","bingx","kucoin","htx","hyperliquid","aster","variational","lighter","pacifica","backpack","reya","paradex","nado","risex"],"type":"string"},"symbol":{"type":"string"},"fundingRate":{"type":"number","description":"Per-interval funding rate (decimal)."},"funding_kind":{"enum":["periodic","continuous_accrual"],"type":"string","description":"Cadence type. `periodic` venues pay funding on a discrete cadence (1h, 4h, 8h). `continuous_accrual` venues (Reya, Paradex) accrue continuously; the rate is already normalized per `funding_interval_hours`."},"nextFundingTime":{"type":["number","null"],"description":"Unix epoch ms of next funding payment, or null if not applicable."},"funding_interval_hours":{"type":"number","minimum":0}},"additionalProperties":false},"minItems":2},"warnings":{"type":"array","items":{"enum":["source_missing","source_stale","source_refresh_failed","unsupported_symbol","unsupported_venue","unmatched_filter","source_unavailable","insufficient_venues","interval_mismatch","fees_not_included","no_opportunity","invalid_min_annualized_spread"],"type":"string"}},"confidence":{"enum":["high","medium","low"],"type":"string"},"horizonClass":{"enum":["1h","4h","24h"],"type":"string","description":"CRY-476: derived from the longest funding interval of the two legs. 1h/4h pairs are uncalibrated by CRY-473; 8h+ pairs roll up into the 24h hold-horizon bucket."},"horizonHaircut":{"type":"object","required":["applied","multiplier","reason"],"properties":{"reason":{"type":["string","null"]},"applied":{"type":"boolean"},"multiplier":{"type":"number"}},"description":"CRY-476 confidence haircut metadata. `applied: true` means the opportunity's `scoredAnnualizedSpread` has been multiplied by `multiplier` (in [0,1]) because the (horizonClass, confidence) cell is under-calibrated. `reason` names the cell (e.g. `24h_medium_confidence_haircut`)."},"recommendation":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["venue","side"],"properties":{"side":{"enum":["long","short"],"type":"string"},"venue":{"enum":["binance","bybit","mexc","gate","bitget","bingx","kucoin","htx","hyperliquid","aster","variational","lighter","pacifica","backpack","reya","paradex","nado","risex"],"type":"string"}}},"minItems":2}}},"annualizedSpread":{"type":"number"},"fundingRateSpread":{"type":"number"},"scoredAnnualizedSpread":{"type":"number","description":"annualizedSpread × horizonHaircut.multiplier. Use this for ranking when the consumer's intent is to hold the position; use `annualizedSpread` for the raw funding-rate-diff edge."}}}}}},"meta":{"type":"object","required":["timestamp","source"],"properties":{"source":{"type":"object","required":["service"],"properties":{"feature":{"type":"string"},"service":{"type":"string","const":"funding-rates"},"version":{"type":"string"}}},"timestamp":{"type":"string","format":"date-time"}}},"warnings":{"type":"array","items":{"type":"string"}}}},"example":{"request":{"venues":"binance,bybit,hyperliquid","symbols":"BTC,ETH","minAnnualizedSpread":0.08},"response":{"data":{"opportunities":[{"symbol":"BTC","records":[{"venue":"binance","symbol":"BTC","fundingRate":0.00001824,"funding_kind":"periodic","nextFundingTime":1781769600000,"funding_interval_hours":8},{"venue":"bybit","symbol":"BTC","fundingRate":0.00009991,"funding_kind":"periodic","nextFundingTime":1781769600000,"funding_interval_hours":8}],"warnings":["fees_not_included"],"confidence":"medium","horizonClass":"24h","horizonHaircut":{"reason":"24h_medium_confidence_haircut","applied":true,"multiplier":0.6},"recommendation":{"legs":[{"side":"long","venue":"binance"},{"side":"short","venue":"bybit"}]},"annualizedSpread":0.08942865,"fundingRateSpread":0.00008167,"scoredAnnualizedSpread":0.05365719},{"symbol":"BTC","records":[{"venue":"hyperliquid","symbol":"BTC","fundingRate":-0.0000014591,"funding_kind":"periodic","nextFundingTime":null,"funding_interval_hours":1},{"venue":"bybit","symbol":"BTC","fundingRate":0.00009991,"funding_kind":"periodic","nextFundingTime":1781769600000,"funding_interval_hours":8}],"warnings":["fees_not_included","interval_mismatch"],"confidence":"medium","horizonClass":"24h","horizonHaircut":{"reason":"24h_medium_confidence_haircut","applied":true,"multiplier":0.6},"recommendation":{"legs":[{"side":"long","venue":"hyperliquid"},{"side":"short","venue":"bybit"}]},"annualizedSpread":0.122183166,"fundingRateSpread":0.0001013691,"scoredAnnualizedSpread":0.0733098996}]},"meta":{"source":{"feature":"funding-arbitrage","service":"funding-rates"},"timestamp":"2026-06-18T06:13:42.115Z"},"warnings":["fees_not_included","interval_mismatch"]}},"exampleRequest":{"venues":"binance,bybit,hyperliquid","symbols":"BTC,ETH","minAnnualizedSpread":0.08},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uxWoy7NTO8ehlCfFYRgIK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns cross-venue perpetual futures funding rate arbitrage opportunities with long/short leg recommendations and confidence scores across up to 16 perp venues","exampleAgentPrompt":"Check for funding rate arbitrage opportunities on BTC and ETH across Binance, Bybit, and Hyperliquid right now, and only show me opportunities with an annualized spread above 8%.","exampleUseCases":[{"title":"Monitor SOL perps funding arbitrage","prompt":"Find me the best funding rate arbitrage opportunities for SOL across all available venues right now, and let me know which exchange I should long and which I should short for each opportunity."},{"title":"High-confidence cross-venue arb signals","prompt":"Show me any funding rate arbitrage opportunities across crypto perp exchanges that have a high confidence rating and at least a 7% annualized spread that I could execute today."},{"title":"Real-time funding spread tracking","prompt":"What's the current funding rate spread between Binance and Hyperliquid for major coins like BTC, ETH, and XRP? Give me the ones with the biggest differences right now."}],"resultDescription":"Returns an array of arbitrage opportunities, each with the symbol, annualized spread, per-venue funding rate records (rate, interval, next funding time, cadence type), a recommendation object listing which venue to go long and which to go short, a confidence level (high/medium/low), and any applicable warnings such as stale data or interval mismatches. Also includes top-level meta and warnings fields.","failureModes":["402 Payment Required — no valid MPP payment receipt provided; response includes per-route pricing challenge","No opportunities returned if minAnnualizedSpread threshold is too high or no spread exists at query time","'source_stale' or 'source_refresh_failed' warnings if venue data is outdated","'insufficient_venues' warning if fewer than 2 venues return data for a symbol","'unsupported_symbol' or 'unsupported_venue' warning for unrecognized inputs","'interval_mismatch' warning when comparing venues with different funding cadences","'fees_not_included' warning reminding that trading fees are not factored into spread calculations"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a ready-made, actionable cross-venue funding rate arbitrage signal with leg recommendations rather than raw funding rate data it must analyze itself. Prefer this over raw data feeds when you want confidence scoring, filtering by minimum spread, and multi-venue normalization (including both periodic and continuous accrual venues like Reya and Paradex) in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-08-24T04:45:18.154Z","isFirstParty":false}