{"uid":"cap___pW9m8cWWwxe_PcUhijI","slug":"hyperliquid-perpetuals-snapshot-x402-76aa6e9f","name":"Hyperliquid Perpetuals Snapshot (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/snapshot?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_5s0Rkv57hBoEGsnP8sUg2","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 a real-time perpetuals market snapshot for BTC, ETH, or SOL from Hyperliquid, including mark price, oracle price, open interest, hourly funding rate, and annualized funding APR.","exampleAgentPrompt":"What are the current mark price, oracle price, open interest, and funding rate for BTC perpetuals on Hyperliquid right now?","exampleUseCases":[{"title":"Funding rate arbitrage signal check","prompt":"Check the current hourly funding rate and annualized APR for ETH perps on Hyperliquid — I want to know if it's worth going short to collect funding right now."},{"title":"Open interest spike detection","prompt":"What is the current open interest in USD for BTC perpetuals on Hyperliquid? I'm watching for unusual spikes that might signal a big move."},{"title":"Mark vs oracle price divergence alert","prompt":"Get me the mark price and oracle price for SOL perps on Hyperliquid — I want to see if there's a meaningful divergence between them right now."}],"resultDescription":"A JSON object containing the perpetuals snapshot for the requested coin, including mark_px (mark price), oracle_px (oracle price), open_interest (in coin units), open_interest_usd, funding_hourly (hourly funding rate), funding_apr_pct (annualized funding rate as a percentage), the venue name ('hyperliquid'), source URLs, and an updated_at timestamp.","failureModes":["Invalid coin symbol returns an error (only BTC, ETH, SOL accepted)","Payment failure via x402 if USDC balance on Base is insufficient","Hyperliquid upstream API downtime causes stale or missing data","Network timeout on the Workers edge if Hyperliquid source is slow","Missing coin query param defaults to BTC (not an error, but may surprise callers expecting a different coin)"],"whenToPreferThis":"Choose this endpoint when you need real-time Hyperliquid perpetuals data (funding rates, open interest, mark/oracle prices) for BTC, ETH, or SOL without setting up API keys — especially suited for autonomous AI trading agents that can pay $0.005 USDC per call via the x402 micropayment protocol on Base. Prefer this over direct Hyperliquid API calls when operating in an agent environment with built-in x402 payment capability and no credential management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:25.850Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetuals-snapshot-x402-76aa6e9f"}