{"uid":"cap_yFCIdrtKhk6ZDMmURkByo","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-funding-d4dedb2c","name":"Hyperliquid Perpetual Futures Historical Funding Rate Series","description":"The historical hourly funding-rate series for one perpetual-futures market, each point with the funding rate, annualized APR, and premium, most recent first. Pass the coin in the path (e.g. BTC) and tune the window with `?hours=` (default 24, max 720) or an explicit `?start=`/`?end=` epoch-ms range. Use to study funding regimes and carry. Free on-chain DEX data (venue: Hyperliquid), no key.","url":"https://agents.x402stock.xyz/api/v1/perps/funding/{coin}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["coin"],"properties":{"end":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"coin":{"type":"string","description":"Hyperliquid perpetual coin symbol, e.g. BTC or ETH."},"hours":{"type":"integer","default":24,"maximum":720,"exclusiveMinimum":0},"start":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0}}},"responseSchema":{"type":"object","required":["source","as_of","venue","coin","count","history"],"properties":{"coin":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"venue":{"type":"string"},"source":{"type":"string","const":"x402stock"},"history":{"type":"array","items":{"type":"object","required":["time","funding_rate_hourly","funding_apr_percent","premium"],"properties":{"time":{"anyOf":[{"type":"string"},{"type":"null"}]},"premium":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_apr_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_rate_hourly":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HRYH84g1Qx4Vv5Sdal2NB","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns the historical hourly funding-rate time series for a Hyperliquid perpetual futures market, including funding rate, annualized APR, and premium, most recent first.","exampleAgentPrompt":"Pull the last 72 hours of hourly funding rate history for BTC perpetual futures on Hyperliquid — I want to see the funding rate, annualized APR, and premium for each point.","exampleUseCases":[{"title":"Funding regime analysis for carry trade","prompt":"Give me the full 30-day hourly funding rate history for ETH perps on Hyperliquid — I want to understand the funding regime and whether there's been a consistent carry opportunity."},{"title":"Spike detection around market event","prompt":"Pull the BTC perpetual funding rate history from January 15th to January 20th 2025 on Hyperliquid so I can see how funding reacted during that price move."},{"title":"Real-time funding monitoring dashboard","prompt":"Fetch the last 24 hours of SOL perpetual funding rates from Hyperliquid including the hourly rate, annualized APR, and premium so I can track whether funding is staying positive."}],"resultDescription":"A JSON object containing the coin symbol, venue (Hyperliquid), source, as_of timestamp, count of data points, and a history array of hourly records each with: time (ISO string), funding_rate_hourly (decimal), funding_apr_percent (annualized percentage), and premium (decimal). Records are ordered most recent first.","failureModes":["Invalid or unsupported coin symbol returns an error or empty history","hours value exceeding 720 is rejected","Invalid epoch-ms for start/end causes a bad request error","Conflicting use of hours with start/end may return unexpected results","Hyperliquid data unavailability for a given time range may return null values in individual fields"],"whenToPreferThis":"Use this endpoint when you need historical hourly granularity of funding rates for Hyperliquid perpetual futures — specifically when studying funding regimes, carry opportunities, or annualized APR trends. Prefer this over generic crypto APIs when you need Hyperliquid-specific on-chain DEX data with premium and APR pre-computed. No API key required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:42:22.534Z","isFirstParty":false}