# Funding Rate History (Perps) > Funding Rate History (Perps) is a paid API for AI agents from derivs.duoleads.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-15). 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. ## Facts - Endpoint: GET https://derivs.duoleads.com/v1/funding-history?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-15 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/funding-rate-history-perps-e1c61afe - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1_8FQtfKAlUa_drdh4XwH Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability funding-rate-history-perps-e1c61afe ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works Funding rate history of one coin on one exchange (Bybit, Hyperliquid, dYdX, Gate, Kraken, Deribit or OKX), up to 30 days: every past funding print with interval, 8h rate and APR, plus avg/min/max/% positive and the window covered. Historical perpetual swap funding for backtests and carry studies on BTC, ETH, SOL and more. Data only. Bad input is free; a venue that fails is not charged. ## Output 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. ## Request schema (JSON Schema) ```json { "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" } } } } } ``` ## Response schema (JSON Schema) ```json { "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": [] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/funding-rate-history-perps-e1c61afe/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from derivs.duoleads.com](https://www.zero.xyz/host/derivs.duoleads.com/llms.txt)