{"uid":"cap_1_8FQtfKAlUa_drdh4XwH","slug":"funding-rate-history-perps-e1c61afe","name":"Funding Rate History (Perps)","description":"Perp funding rates, open interest, futures basis, implied volatility, liquidations, order book depth and a perp screener for crypto perpetual futures across 8 exchanges (Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX), paid per call over x402 with USDC on Base. No account, no API key.","url":"https://derivs.duoleads.com/v1/funding-history?utm_source=zero.xyz","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","required":["coin","venue"],"properties":{"coin":{"type":"string","maxLength":32,"minLength":1,"description":"Coin symbol: BTC, ETH, SOL ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE)."},"days":{"type":"string","default":"7","pattern":"^[0-9]{1,2}$","description":"Days back, 1-30. Default 7."},"venue":{"enum":["bybit","hyperliquid","dydx","gate","kraken","deribit","okx"],"type":"string","description":"The exchange whose funding history to return."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coin":"BTC","colo":null,"days":7,"as_of":"2026-10-14T23:00:00Z","stale":false,"stats":{"n":21,"avg_apr_pct":2.25664,"avg_rate_8h":0.00002060857143,"max_rate_8h":0.00008676,"min_rate_8h":-0.00002132,"pct_positive":61.9048},"units":{"rate":"fraction per funding interval","times":"ISO 8601 UTC","apr_pct":"simple annualised percent = rate * 24 / interval_h * 365 * 100","rate_8h":"fraction per 8 hours = rate * 8 / interval_h","interval_h":"hours between funding payments (per print: the gap to its neighbouring print, whole hours 1-8)"},"venue":"bybit","prints":[{"rate":0.00001078,"time":"2026-10-08T00:00:00Z","apr_pct":1.18041,"rate_8h":0.00001078,"interval_h":8},{"rate":-0.00001339,"time":"2026-10-08T08:00:00Z","apr_pct":-1.46621,"rate_8h":-0.00001339,"interval_h":8}],"symbol":"BTCUSDT","coverage":{"to":"2026-10-14T16:00:00Z","from":"2026-10-08T00:00:00Z","complete":true,"requested_from":"2026-10-07T23:00:00Z"},"see_also":{"params":["coin"],"reason":"Current funding on every venue, with predicted next funding (incl. Binance and Bybit via Hyperliquid).","endpoint":"https://derivs.duoleads.com/v1/funding-rates"},"disclaimer":"Data only, not investment advice, not a benchmark; not affiliated with any exchange","interval_h":8,"request_id":"01KEXAMPLE0000000000000000","venue_as_of":"2026-10-14T23:00:00Z","venues_missing":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tOcGaAiA-IzGTt8ZE86mO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical perpetual futures funding rate time-series for a given coin and exchange, with per-print rates, annualised APR, and summary statistics over 1–30 days.","exampleAgentPrompt":"Pull me the BTC funding rate history on Bybit for the last 14 days — I want to see each funding print, the average 8-hour rate, and the annualised APR over the period.","exampleUseCases":[{"title":"Basis trade funding cost analysis","prompt":"I'm running a cash-and-carry trade on ETH — can you get me the full funding rate history for ETH on Hyperliquid over the last 30 days so I can calculate my average carry income and see how often it went negative?"},{"title":"Funding rate regime monitoring","prompt":"Has SOL's perpetual funding rate on OKX been mostly positive or negative over the past week? Show me every print and the percentage of time it was positive."},{"title":"Historical rate comparison for strategy backtest","prompt":"I need the BTC perp funding history on dYdX for the last 14 days — give me each print with timestamps and the annualised APR so I can backtest a funding arbitrage strategy."}],"resultDescription":"A JSON object containing the requested coin, venue, and lookback window; a list of individual funding prints each with timestamp, raw rate, 8-hour normalised rate, interval hours, and annualised APR; aggregate statistics (count, average APR, average 8h rate, max/min 8h rate, percent positive); coverage metadata (from/to datetimes, completeness flag); and unit definitions for all rate fields.","failureModes":["Missing required 'coin' or 'venue' parameter returns a 400 validation error","Unsupported venue name returns a 400 enum validation error","Coin symbol not listed on the requested venue returns an empty or error response","Days value outside 1–30 range is rejected by pattern validation","Payment failure or insufficient USDC balance via x402 returns 402 Payment Required","Exchange data unavailable or stale may result in incomplete coverage with stale flag set to true"],"whenToPreferThis":"Choose this endpoint when you need a time-series of historical funding rate prints for a specific coin on a specific exchange, with per-interval granularity and aggregate statistics. Prefer it over the current funding rates endpoint when you need trend analysis, backtest data, carry cost modelling, or regime detection over days rather than a point-in-time snapshot. It is the right choice when the exact sequence, timing, and sign of each funding payment matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T12:32:44.157Z","isFirstParty":false,"canonicalSlug":"funding-rate-history-perps-e1c61afe"}