{"uid":"cap_klFoye2QYQ6vZnqICmMlT","slug":"hyperliquid-perpetuals-funding-rate-open-interest-x402-bf93b89c","name":"Hyperliquid Perpetuals Funding Rate & Open Interest (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/hyperliquid/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_gYZnxTWj04h3aPeH9mENR","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 rate and open interest data for BTC, ETH, or SOL from Hyperliquid, paid per-call via x402 USDC micropayment on Base.","exampleAgentPrompt":"What's the current Hyperliquid funding rate and open interest for BTC perpetuals — give me the hourly rate and the annualized APR?","exampleUseCases":[{"title":"Carry trade direction decision","prompt":"Check the Hyperliquid funding rate for ETH perps — is the annualized APR high enough that it's worth being short to collect funding, and how much open interest is there?"},{"title":"BTC perp mark vs oracle divergence check","prompt":"What's the difference between the mark price and oracle price for BTC on Hyperliquid right now, and what's the current funding rate?"},{"title":"SOL perpetuals funding monitoring","prompt":"Pull the latest Hyperliquid funding data for SOL perps — I want the hourly funding rate and total open interest in USD so I can decide whether to enter a position."}],"resultDescription":"Returns a JSON object with mark price, oracle price, open interest (raw and USD-denominated), hourly funding rate, annualized funding rate as a percentage, the venue name (hyperliquid), data sources, and an updated_at timestamp. All data is sourced live from Hyperliquid's public info API.","failureModes":["Invalid or unsupported coin symbol returns an error (only BTC, ETH, SOL supported)","Payment failure via x402 if USDC balance on Base is insufficient","Hyperliquid upstream API unavailability causes stale or missing data","Network timeout on the Cloudflare Worker edge function","Missing coin query param defaults to BTC silently — may confuse agents expecting explicit validation"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs real-time Hyperliquid-specific perpetuals data — particularly funding rates and open interest — without setting up API keys. Ideal for pay-per-call agent architectures using x402 micropayments on Base. Prefer this over generic crypto APIs when Hyperliquid-specific mark/oracle price divergence or funding APR is specifically needed for carry trade analysis or position sizing decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:16.116Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetuals-funding-rate-open-interest-x402-bf93b89c"}