{"uid":"cap_eYPTZZz5Le7-ZZ5652Akx","slug":"cryptofeed402-btc-funding-rate-history-879f846f","name":"cryptofeed402 BTC Funding Rate History","description":"AI-to-AI crypto data. Paid routes use x402 (USDC on Base mainnet eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913); unpaid calls return 402 with payment requirements. Not financial advice.","url":"https://cryptofeed402.site/funding/history/BTC?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"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","pattern":"^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$","description":"Hyperliquid perp ticker, case-insensitive; HIP-3 as dex:TICKER (xyz:TSLA)"}}},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"End, YYYY-MM-DD or ISO 8601 UTC; default now"},"from":{"type":"string","description":"Start, YYYY-MM-DD or ISO 8601 UTC (instead of hours)"},"hours":{"type":"string","pattern":"^[0-9]{1,4}$","description":"Last N hours, 1-720 for 1h (default 168), 1-2160 for 4h/8h/1d"},"interval":{"enum":["1h","4h","8h","1d"],"type":"string","description":"1h raw settlements (default) or UTC buckets"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["symbol","count","points"],"properties":{"as_of":{"type":"string"},"count":{"type":"integer"},"stats":{"type":"object"},"venue":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"premium":{"type":["number","null"]},"rate_8h":{"type":"number"},"rate_hourly":{"type":"number"},"annualized_pct":{"type":"number"}}}},"symbol":{"type":"string"},"window":{"type":"object"},"coverage":{"type":"object"},"interval_hours":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"count":168,"stats":{"max_annualized_pct":21.9,"min_annualized_pct":-3.1,"mean_annualized_pct":10.2},"venue":"hyperliquid","points":[{"time":"2026-10-20T00:00:00.000Z","premium":-0.0002,"rate_8h":0.0001,"rate_hourly":0.0000125,"annualized_pct":10.95}],"symbol":"BTC","interval_hours":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v0INBLe24NeLB89glhiTf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical perpetual funding rate data for a Hyperliquid perp ticker (e.g. BTC) over a configurable time window and interval.","exampleAgentPrompt":"Pull the last 7 days of BTC perpetual funding rate history from Hyperliquid with 1-hour intervals and show me the annualized rate trend and summary stats.","exampleUseCases":[{"title":"Funding rate trend analysis for BTC","prompt":"Show me BTC's perpetual funding rate history on Hyperliquid for the past 30 days using daily intervals — I want to see how annualized rates have trended and what the min, max, and average were."},{"title":"Short-term funding spike detection","prompt":"Pull the last 24 hours of BTC funding rate data from Hyperliquid at 1-hour intervals so I can see if there were any unusual spikes or sign flips."},{"title":"Backtesting funding cost for a date range","prompt":"Get BTC perp funding rates on Hyperliquid from 2025-01-01 to 2025-03-31 with 8-hour intervals — I need the annualized percentages to estimate carry costs for a long position I held during that period."}],"resultDescription":"A JSON object containing the ticker symbol, total data point count, venue name (hyperliquid), interval in hours, a window/coverage summary, aggregated stats (min/max/mean annualized %), and an array of time-series points each with timestamp, premium, 8h rate, hourly rate, and annualized percentage.","failureModes":["402 Payment Required if USDC payment via x402 is not provided or is insufficient","Invalid symbol format returns an error (must match ^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$)","Hours parameter out of range (must be 1-720 for 1h, 1-2160 for 4h/8h/1d)","Invalid date format for from/to parameters","No data available for very old or future date ranges","Ticker not listed on Hyperliquid returns empty or error response"],"whenToPreferThis":"Use this endpoint when you need historical perpetual funding rate time-series data specifically from Hyperliquid for any supported perp ticker. Prefer this over spot price endpoints when the goal is analyzing carry costs, funding arbitrage, or long-term rate trends. Choose the interval parameter based on your resolution needs (1h for granular, 1d for macro views). This is purpose-built for AI agents via x402 micropayment, so it suits automated pipelines that need historical funding data without manual authentication setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:03:05.941Z","isFirstParty":false,"canonicalSlug":"cryptofeed402-btc-funding-rate-history-879f846f"}