{"uid":"cap_V8qduKghbr8o_B0ApU1tg","slug":"hyperliquid-perpetuals-funding-rate-history-4ae21bf6","name":"Hyperliquid Perpetuals Funding Rate History","description":"One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.","url":"https://klymax402.com/api/hl-funding/api/history","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"coin":{"type":"string","description":"Coin ticker symbol (e.g. BTC, ETH, SOL, DOGE). Must match a Hyperliquid perp market."},"hours":{"type":"number","description":"Lookback window in hours. Default: 24. Max: 720 (30 days). Each funding period is 8 hours, so 24h returns ~3 entries."}}},"responseSchema":{"type":"json","example":{"coin":"example","hours":1,"entries":[],"summary":{},"timestamp":"example"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BWbbSYZSSJe8cB19dfSCQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical funding rate entries and summary statistics for a Hyperliquid perpetuals market over a configurable lookback window.","exampleAgentPrompt":"Can you pull the Hyperliquid funding rate history for BTC over the last 72 hours and tell me whether longs or shorts have been paying more?","exampleUseCases":[{"title":"DeFi trader funding rate review","prompt":"What's been the funding rate history for ETH perps on Hyperliquid over the past 7 days? I want to know if it's been consistently positive and what the average has been."},{"title":"Arbitrage opportunity scouting","prompt":"Check the Hyperliquid funding rate history for SOL for the last 48 hours — I'm trying to figure out if there's a cash-and-carry arb opportunity worth running."},{"title":"Funding cost analysis for open position","prompt":"I've had a long BTC perp open on Hyperliquid for about 3 days — can you pull the funding rate history for the last 72 hours so I can estimate how much I've paid in funding?"}],"resultDescription":"Returns a JSON object containing the queried coin ticker, the requested lookback hours, an array of individual funding rate entries (each covering an 8-hour funding period), a summary object with aggregate statistics (e.g. average, total, direction bias), and a timestamp indicating when the data was fetched.","failureModes":["Invalid or unsupported coin ticker not listed as a Hyperliquid perp market — endpoint returns an error or empty entries","Hours value exceeds 720 (30-day max) — request rejected or clamped","Payment not received or insufficient USDC balance — 402 Payment Required response","Network or upstream Hyperliquid API unavailability — 500 or timeout error","Malformed input schema (e.g. non-numeric hours) — 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need historical Hyperliquid-specific perpetual funding rate data, including per-period entries and summary statistics, for any coin listed on Hyperliquid perp markets. Prefer this over generic crypto data APIs when you specifically need Hyperliquid funding history (not spot prices, order books, or funding from other exchanges like Binance or dYdX). Ideal for DeFi trading agents, funding arbitrage bots, and position cost analysis workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:05.426Z","isFirstParty":false}