{"uid":"cap_gOKhTkEWDDpjz2gDxFtBE","slug":"hyperliquid-perpetuals-carry-funding-rate-data-x402-898dafd2","name":"Hyperliquid Perpetuals Carry/Funding Rate Data (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/v1/perpetuals/carry?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_Vxd0TChHJtXdzWqPnro0D","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 carry data (mark price, oracle price, open interest, hourly funding rate, annualized funding APR) for BTC, ETH, or SOL from Hyperliquid via a pay-per-call x402 micropayment model.","exampleAgentPrompt":"What's the current funding rate and annualized carry APR for BTC perpetuals on Hyperliquid? I want to know if there's a positive carry opportunity.","exampleUseCases":[{"title":"Funding arbitrage opportunity scanner","prompt":"Check the current annualized funding APR for ETH perpetuals on Hyperliquid — I want to know if the carry is high enough to justify a cash-and-carry trade."},{"title":"Perp trading cost before opening position","prompt":"Before I open a long SOL perpetual, tell me the current hourly funding rate and open interest on Hyperliquid so I know what carrying this position will cost me."},{"title":"Automated funding rate monitor alert","prompt":"What is the BTC perpetual funding APR on Hyperliquid right now? I'm checking whether the rate has crossed above 20% annualized so I can decide whether to close my long."}],"resultDescription":"Returns a JSON object with mark price, oracle price, open interest (count and USD value), hourly funding rate, and annualized funding APR percentage for the requested coin perpetual on Hyperliquid, plus the venue name, data sources, and update timestamp.","failureModes":["Payment failure if USDC balance on Base is insufficient or x402 payment is rejected","Invalid coin parameter (only BTC, ETH, SOL accepted) returns a validation error","Hyperliquid API upstream outage may result in stale or unavailable data","Rate limiting or network timeout from the Cloudflare Worker host"],"whenToPreferThis":"Choose this endpoint when you need real-time perpetual futures funding/carry data specifically from Hyperliquid without setting up API keys, and you want to pay per call via USDC micropayment (x402). Prefer over direct Hyperliquid API calls when building AI agents that need lightweight, no-auth access to funding metrics alongside other crypto data from the same provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:28.356Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetuals-carry-funding-rate-data-x402-898dafd2"}