{"uid":"cap_vZEI3h07FmJN7oTISM4Fr","slug":"hyperliquid-historical-funding-rates-e23b60ab","name":"Hyperliquid Historical Funding Rates","description":"Historical funding rates for one Hyperliquid perpetual over a time window — funding rate, premium and timestamp per hour.","url":"https://hyperliquid.use.x402atlas.com/funding","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"],"properties":{"end":{"type":"integer","minimum":0,"description":"Optional end (ms epoch)"},"coin":{"type":"string","maxLength":32,"description":"Perp asset symbol (e.g. BTC)"},"start":{"type":"integer","minimum":0,"description":"Optional start (ms epoch); defaults to 7 days ago"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"coin":{"type":"string"},"count":{"type":"integer","description":"Number of funding entries returned"},"funding":{"type":"array","items":{"type":"object","properties":{"coin":{"type":"string"},"time":{"type":"string","format":"date-time"},"premium":{"type":"string","description":"Premium (string for full precision)"},"funding_rate":{"type":"string","description":"Funding rate (string for full precision)"}}}},"queried_at":{"type":"string","format":"date-time","description":"When this response was generated"}}}}}}},"responseSchema":{"type":"json","example":{"coin":"BTC","count":1,"funding":[{"coin":"BTC","time":"2026-07-10T11:00:00Z","premium":"0.0001","funding_rate":"0.0000125"}],"queried_at":"2026-07-10T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_alGE18oBFAe6Y3YV_D3_k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly historical funding rates, premiums, and timestamps for a single Hyperliquid perpetual asset over a specified time window.","exampleAgentPrompt":"Pull the hourly funding rate history for BTC on Hyperliquid for the past 7 days — I want to see the funding rate and premium for each period.","exampleUseCases":null,"resultDescription":"An array of hourly funding entries for the requested perpetual asset, each containing the coin symbol, ISO 8601 timestamp, funding rate (string for full precision), and premium (string for full precision), along with the total count of entries and the time the query was generated.","failureModes":["Missing required 'coin' query parameter returns an error","Invalid or unrecognized coin symbol returns empty or error response","Start/end timestamps outside available data range may return empty funding array","Malformed epoch integer values (e.g. negative) rejected by schema validation","Payment not received or x402 flow incomplete results in 402 response"],"whenToPreferThis":"Use this endpoint when you need historical per-hour funding rate and premium data for a specific Hyperliquid perpetual over a configurable time window. Prefer it over predicted/live funding endpoints when backtesting strategies, auditing past carry costs, or analyzing funding rate trends. It is the right choice for time-series funding analysis rather than snapshot or cross-venue comparison.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:14.693Z","isFirstParty":false}