{"uid":"cap_GFeLkYoCeruARoCKF2mOz","slug":"swaphunt-funding-rate-history-fd100111","name":"SwapHunt Funding Rate History","description":"Settled funding rates for one Binance USDT perpetual, up to 365 days, with average, range, share of positive periods and the percentile of the latest rate. Annualized at the symbol's own interval (1h, 4h or 8h). Use to judge whether today's funding is unusual for that coin.","url":"https://x402.swaphunt.dev/v1/derivatives/funding-rates/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"days":{"type":"integer","default":90,"description":"Lookback in days, 1-365"},"symbol":{"type":"string","default":"BTC","description":"Hyperliquid perpetual coin, e.g. BTC (BTCUSDT also accepted)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pqY8eaH0cM5buHKPgaGuo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns settled funding rate history for a Binance USDT perpetual contract (up to 365 days), with statistics including average, range, share of positive periods, and percentile ranking of the latest rate.","exampleAgentPrompt":"Is the current ETHUSDT funding rate unusual? Pull the last 180 days of funding rate history and tell me what percentile today's rate falls in, along with the average and whether it's been mostly positive or negative.","exampleUseCases":[{"title":"Detecting anomalous funding spikes","prompt":"The BTCUSDT funding rate looks really high right now — can you check the last 365 days of history and tell me what percentile today's rate is at and how it compares to the average?"},{"title":"Evaluating carry trade opportunity","prompt":"I'm thinking of shorting SOLUSDT perps to collect funding — can you pull 90 days of funding rate history and tell me how often the rate has been positive and what the average annualized rate looks like?"},{"title":"Pre-trade funding cost assessment","prompt":"Before I open a long on ETHUSDT perps, can you check the last 60 days of funding rate history so I know if I'm likely to pay a lot in funding fees relative to what's been normal?"}],"resultDescription":"Returns a dataset of settled funding rates for the requested symbol over the lookback window, along with computed statistics: average rate, min/max range, percentage of periods with positive funding, the current rate's percentile rank within that history, and rates annualized based on the symbol's funding interval (1h, 4h, or 8h).","failureModes":["Invalid symbol returns an error or empty result — only Binance USDT perpetuals are supported","Days parameter outside 1-365 range may be rejected or clamped","Symbol not traded as a USDT perpetual on Binance will return no data","Network or upstream Binance API failure may return a 5xx error","Very new coins with limited history may return fewer data points than requested"],"whenToPreferThis":"Use this endpoint when you need to contextualize a current funding rate against historical norms — e.g., deciding whether today's rate is a statistical outlier, assessing carry trade viability, or sizing the funding cost risk of a position. Prefer this over live-rate endpoints when you need statistical context (percentile, average, range) rather than just the current value.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T00:35:37.160Z","isFirstParty":false,"canonicalSlug":"swaphunt-funding-rate-history-fd100111"}