{"uid":"cap_jpjMoUeAf9aDgMkfe7qNY","slug":"hyperliquid-perps-data-via-x402-crypto-microdata-aedc9998","name":"Hyperliquid Perps Data via x402 (Crypto Microdata)","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/crypto/perps?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_R3xJjA84re06sUsYbS09e","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 perpetuals market data (mark price, oracle price, open interest, funding rate) for BTC, ETH, or SOL from Hyperliquid, paid per-call in USDC via x402.","exampleAgentPrompt":"What's the current mark price, oracle price, open interest, and funding rate for BTC perps on Hyperliquid right now?","exampleUseCases":[{"title":"Funding rate arbitrage monitoring","prompt":"Check the current hourly funding rate and annualized APR for ETH perpetuals on Hyperliquid — I want to know if it's worth being long or short to collect funding."},{"title":"Open interest sentiment check","prompt":"What's the total open interest in BTC perps right now, both in coin terms and USD? I'm trying to gauge how much leverage is in the market."},{"title":"Mark vs oracle price divergence alert","prompt":"Pull the mark price and oracle price for SOL perps on Hyperliquid and tell me how far apart they are — I want to see if there's any significant basis."}],"resultDescription":"Returns a JSON object with the requested coin's perpetuals data including mark price, oracle price, open interest (in coin and USD), hourly funding rate, annualized funding APR percentage, the venue name (Hyperliquid), data source URLs, and an updated_at timestamp.","failureModes":["Payment failure: x402 USDC payment on Base not completed or insufficient balance — endpoint returns 402 Payment Required","Invalid coin: coin parameter not in [BTC, ETH, SOL] enum — likely 400 Bad Request","Upstream Hyperliquid API unavailable: stale or missing data returned","Network timeout from Cloudflare Worker to Hyperliquid source"],"whenToPreferThis":"Choose this endpoint when an AI trading or onchain agent needs real-time Hyperliquid perpetuals data (funding rates, open interest, mark/oracle prices) without setting up API keys — paying per-call in USDC via x402 is ideal for autonomous agents with onchain wallets. Prefer this over traditional REST APIs that require key registration when the agent operates autonomously and needs pay-as-you-go access to derivatives market data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:13.164Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perps-data-via-x402-crypto-microdata-aedc9998"}