{"uid":"cap_1rjjrEyffiB3bd6pJmPhN","slug":"x402stock-perpetual-futures-funding-rate-history-3242a5a5","name":"x402stock Perpetual Futures Funding Rate History","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?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"},"pathParams":{"coin":{"type":"string"},"type":"object"},"queryParams":{"type":"object","properties":{"end":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"hours":{"type":"integer","default":24,"maximum":720,"exclusiveMinimum":0},"start":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0}}}},"additionalProperties":false}}},"responseSchema":null,"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_8N64hh1yiPzR_wl-ddR8q","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 the historical hourly funding-rate series for a single perpetual-futures market on Hyperliquid DEX, including funding rate, annualized APR, and premium, most recent first.","exampleAgentPrompt":"Pull the Hyperliquid funding rate history for BTC perps over the last 168 hours so I can see if the funding regime has been consistently positive and estimate the carry cost.","exampleUseCases":[{"title":"Carry trade opportunity analysis","prompt":"What has the annualized funding APR been for ETH perpetuals on Hyperliquid over the last 72 hours? I want to know if there's a decent carry trade opportunity right now."},{"title":"Funding spike investigation","prompt":"Can you pull the BTC perpetual funding rate history from Hyperliquid between January 10th 00:00 UTC and January 12th 00:00 UTC? I heard there was a big funding spike and want to see exactly what happened."},{"title":"Long-term funding regime study","prompt":"Show me the full 720-hour funding rate history for SOL perps on Hyperliquid — I'm trying to understand whether the market has been predominantly long-biased over the past month."}],"resultDescription":"An array of hourly data points for the specified perpetual market, returned most recent first. Each point includes the funding rate, the annualized APR equivalent, and the market premium. The response covers up to 720 hours of history and can be scoped by hours count or explicit epoch-ms start/end timestamps.","failureModes":["Invalid or unsupported coin symbol returns an error or empty dataset","hours parameter exceeding 720 results in a validation error","start/end timestamps in wrong format or inverted range may return no data or an error","Payment of $0.01 USDC not included or failed results in HTTP 402 response","Hyperliquid data unavailability or outages may cause empty or partial responses"],"whenToPreferThis":"Choose this endpoint when you need historical hourly funding rate data specifically from the Hyperliquid perpetual DEX, including annualized APR and premium metrics, without requiring an API key. It is ideal for carry trade analysis, funding regime studies, and cost-of-carry calculations for on-chain perp markets. Prefer this over centralized exchange funding APIs when you want decentralized, on-chain data from Hyperliquid specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:55:09.916Z","isFirstParty":false,"canonicalSlug":"x402stock-perpetual-futures-funding-rate-history-3242a5a5"}