{"uid":"cap_NVCJuSy3-C1zCrTTn13_a","slug":"hyperliquid-perpetual-funding-rate-api-x402-a47d99fb","name":"Hyperliquid Perpetual Funding Rate API (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/funding-rate?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"],"type":"string"},"queryParams":{"type":"object","properties":{"coin":{"enum":["BTC","ETH","SOL"],"type":"string","examples":["BTC","ETH","SOL"],"description":"Perp coin (default BTC)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coins":{"BTC":{"mark_px":80860,"oracle_px":80870,"open_interest":30000,"funding_hourly":0.0000125,"funding_apr_pct":10.95,"open_interest_usd":2426000000}},"venue":"hyperliquid","sources":["https://api.hyperliquid.xyz/info"],"updated_at":"2026-10-28T11:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1oPJbmrJfHiuAjby_Un1j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live perpetual futures funding rate, mark price, oracle price, and open interest for BTC, ETH, or SOL from Hyperliquid, paid per-call via x402/USDC on Base.","exampleAgentPrompt":"What's the current hourly funding rate and annualized APR for BTC perpetuals on Hyperliquid right now?","exampleUseCases":[{"title":"Basis trade profitability check","prompt":"Is the current ETH perpetual funding rate on Hyperliquid high enough to make a cash-and-carry basis trade worthwhile — what's the annualized APR right now?"},{"title":"Funding rate arbitrage monitoring","prompt":"Check the SOL perp funding rate on Hyperliquid — I want to know if it's positive or negative and what the hourly rate is so I can decide which side to be on."},{"title":"Market sentiment gauge via open interest","prompt":"What's the current BTC open interest in USD on Hyperliquid and what's the mark price vs oracle price spread? I'm trying to gauge how much leverage is in the market."}],"resultDescription":"Returns a JSON object with mark price, oracle price, open interest (raw and USD), hourly funding rate, annualized funding APR percentage, the venue name (hyperliquid), source URLs, and an updated_at timestamp for the requested coin.","failureModes":["Payment not made via x402/USDC — returns 402 Payment Required","Invalid or unsupported coin symbol — only BTC, ETH, SOL accepted","Upstream Hyperliquid API unavailable — may return 502 or stale data","Malformed query parameter — returns 400 Bad Request","Network timeout from Cloudflare Worker edge"],"whenToPreferThis":"Choose this endpoint when your AI agent needs real-time Hyperliquid perpetual funding rates and open interest without setting up API keys, and can pay $0.005 USDC per call via the x402 micropayment protocol on Base. Ideal for trading agents that need live funding data for BTC, ETH, or SOL perps to evaluate basis trades, funding arbitrage, or market sentiment without maintaining a centralized API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:39.933Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetual-funding-rate-api-x402-31d123db"}