{"uid":"cap_5t3ETuwRcK5XcrqziqWFD","slug":"hyperliquid-perpetual-funding-rate-api-x402-31d123db","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/perp-funding?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_p7lSHg6bUiBqF6Mp0itM5","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 real-time perpetual futures funding rates, mark/oracle prices, and open interest for BTC, ETH, or SOL from Hyperliquid, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"What's the current Hyperliquid funding rate for BTC perps — give me the hourly rate, the annualized APR, and how much open interest is out there right now?","exampleUseCases":[{"title":"Funding arbitrage signal detection","prompt":"Check the current ETH perp funding rate on Hyperliquid — if the annualized APR is above 20%, flag it so I can consider a cash-and-carry trade."},{"title":"Pre-trade position sizing check","prompt":"Before I open a long SOL perp position, can you pull the current mark price, oracle price, and open interest on Hyperliquid so I can assess liquidity and drift?"},{"title":"Automated funding rate monitor for trading bot","prompt":"Every hour, check the BTC perp funding rate on Hyperliquid and alert me if the hourly rate flips negative or exceeds 0.01%."}],"resultDescription":"Returns a JSON object with mark price, oracle price, open interest (in units and USD), hourly funding rate, annualized funding APR percentage, the venue name (hyperliquid), source URLs, and an ISO 8601 timestamp of last update — keyed by coin symbol (BTC/ETH/SOL).","failureModes":["Payment not sent or insufficient USDC balance — 402 Payment Required returned","Invalid or unsupported coin symbol — falls back to default (BTC) or returns error","Hyperliquid upstream API downtime — stale or missing data","Network timeout on the Cloudflare Worker — connection error","Missing query param defaults to BTC silently — agent may receive wrong coin's data if param omitted"],"whenToPreferThis":"Choose this endpoint when your agent needs real-time Hyperliquid-specific perpetual funding rates, mark/oracle price spreads, or open interest data without API key management — especially in micropayment-native (x402) agent architectures where per-call USDC billing is preferred over subscriptions. Best suited for trading agents that need funding rate signals to evaluate carry trades, position costs, or market sentiment on BTC, ETH, or SOL perps specifically on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:13.236Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetual-funding-rate-api-x402-31d123db"}