{"uid":"cap_yFCIdrtKhk6ZDMmURkByo","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-funding-d4dedb2c","name":"Hyperliquid Perpetual Futures Historical Funding Rate Series","description":"Returns historical hourly funding-rate series for one perpetual-futures market.","url":"https://agents.x402stock.xyz/api/v1/perps/funding/{coin}?utm_source=zero.xyz","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":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":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-x402","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":1,"lastUsedAt":"2026-10-15T06:55:46.440Z","lastSuccessfullyRanAt":"2026-10-15T06:55:46.440Z","lastHealthCheckAt":"2026-10-26T18:39:08.553Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-funding-d4dedb2c"}