{"uid":"cap_iHNvUwWH6QjFkJthEuEni","slug":"hyperliquid-perpetual-funding-rate-lookup-0487b234","name":"Hyperliquid Perpetual Funding Rate Lookup","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/v1/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_zBKYhPP-iQS7X4_rPX7cX","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 current mark price, oracle price, open interest, and hourly/APR funding rates for BTC, ETH, or SOL perpetual futures on Hyperliquid via x402 micropayment","exampleAgentPrompt":"What's the current hourly funding rate and annualized APR for BTC perpetuals on Hyperliquid, and how does the mark price compare to the oracle price right now?","exampleUseCases":[{"title":"Funding rate arbitrage signal detection","prompt":"Check the current Hyperliquid funding rate for ETH perps — give me the hourly rate and the annualized APR so I can decide whether to go long or short to collect funding."},{"title":"Open interest surge monitoring","prompt":"What's the current open interest in USD for BTC perpetuals on Hyperliquid? I want to see if there's been a big buildup before I trade."},{"title":"Mark vs oracle price deviation check","prompt":"Pull the mark price and oracle price for SOL on Hyperliquid right now — I need to know how wide the spread is before placing a perp trade."}],"resultDescription":"Returns a JSON object with mark price, oracle price, open interest (raw and USD), hourly funding rate, annualized funding APR percentage, venue name (hyperliquid), data source URLs, and an ISO 8601 timestamp of last update — all for the requested coin (BTC, ETH, or SOL).","failureModes":["Payment failure: x402 USDC payment on Base not completed or insufficient balance","Invalid coin: coin parameter not in allowed enum (BTC/ETH/SOL) returns error","Upstream outage: Hyperliquid API unavailable causes stale or missing data","Rate limit: excessive calls without valid payment rejected","Network timeout: Cloudflare Worker timeout on slow upstream response"],"whenToPreferThis":"Choose this endpoint when you need real-time Hyperliquid-specific perpetual funding rates and open interest for BTC, ETH, or SOL without setting up an API key — especially in onchain or autonomous agent contexts where x402 micropayments via USDC on Base are available. Prefer this over general crypto data APIs when Hyperliquid-specific mark/oracle price spread or funding APR is specifically required for trading decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:50.856Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetual-funding-rate-lookup-0487b234"}