{"uid":"cap_At7ra0FNeutl1Cfe9QLG9","slug":"hyperliquid-order-book-via-x402-micropayment-51d6c38b","name":"Hyperliquid Order Book via x402 Micropayment","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/crypto/orderbook?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)"},"depth":{"type":"integer","maximum":20,"minimum":1,"description":"Levels per side (default 5)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mid":80860.5,"asks":[{"n":3,"px":80861,"sz":0.8}],"bids":[{"n":4,"px":80860,"sz":1.2}],"coin":"BTC","venue":"hyperliquid","sources":["https://api.hyperliquid.xyz/info"],"best_ask":80861,"best_bid":80860,"spread_bps":0.124,"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_8hw55V7rUbkkgqkaBzeYq","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":"Fetches real-time Hyperliquid perpetual order book (bids, asks, spread) for BTC, ETH, or SOL, paid per-call with USDC on Base via x402.","exampleAgentPrompt":"What does the BTC perp order book look like on Hyperliquid right now — give me the top 5 levels on each side and the spread in basis points.","exampleUseCases":[{"title":"Pre-trade liquidity check for large perp","prompt":"Before I place a large SOL perp order, show me the top 10 bid and ask levels on Hyperliquid so I can estimate slippage."},{"title":"Spread monitoring for arbitrage bot","prompt":"Pull the current ETH Hyperliquid order book — I need the best bid, best ask, and spread in bps to decide whether to trigger my arb strategy."},{"title":"Mid price feed for portfolio valuation","prompt":"What is the current mid price for BTC on Hyperliquid? I need it to mark my open perp positions to market."}],"resultDescription":"Returns a JSON object with the coin ticker, venue name (hyperliquid), ordered arrays of bid and ask levels (each with price, size, and order count), best bid, best ask, mid price, spread in basis points, data sources array, and an ISO8601 updated_at timestamp.","failureModes":["Unsupported coin symbol returns validation error — only BTC, ETH, SOL are accepted","Depth out of range (< 1 or > 20) returns a 400-style error","x402 payment failure if agent wallet has insufficient USDC on Base","Hyperliquid upstream outage causes stale or missing data","Network timeout from Cloudflare Worker if Hyperliquid API is slow"],"whenToPreferThis":"Choose this endpoint when your AI agent needs low-latency, pay-per-call perpetual order book data from Hyperliquid without API key registration. Ideal for trading bots, arbitrage agents, or portfolio tools that need real-time bid/ask depth and spread for BTC, ETH, or SOL perps, and that pay with USDC on Base via x402. Prefer alternatives if you need spot markets, other venues, or coins beyond the three supported.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:17.161Z","isFirstParty":false,"canonicalSlug":"hyperliquid-order-book-via-x402-micropayment-51d6c38b"}