{"uid":"cap_ouBwk4YsRZ1gYNDSHYJke","slug":"hyperliquid-l2-orderbook-via-x402-7a9a479f","name":"Hyperliquid L2 Orderbook via 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/hyperliquid/node/l2-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_UcUaIWSAeBgZuzsr6Ccqo","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 the live L2 order book (bids, asks, spread, mid price) for BTC, ETH, or SOL perpetuals on Hyperliquid, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Pull the live Hyperliquid L2 order book for BTC perps with 10 levels on each side — I need the best bid, best ask, and spread in basis points.","exampleUseCases":[{"title":"Pre-trade liquidity check for perp entry","prompt":"Before I enter a large ETH perp position on Hyperliquid, show me the top 15 levels of the order book so I can estimate slippage."},{"title":"Real-time spread monitoring for arbitrage","prompt":"Check the current bid-ask spread in basis points for SOL perpetuals on Hyperliquid — I'm watching for spread compression opportunities."},{"title":"Mid-price feed for algorithmic pricing","prompt":"Give me the current mid price and best bid/ask for BTC perps on Hyperliquid with 5 levels of depth so my pricing model can update its reference price."}],"resultDescription":"Returns a JSON object containing the coin symbol, venue name ('hyperliquid'), best bid and ask prices, mid price, spread in basis points, arrays of bid and ask levels (each with price, size, and order count), data sources, and an updated_at timestamp.","failureModes":["Invalid coin symbol returns 400 (only BTC, ETH, SOL supported)","Depth out of range (must be 1-20) returns 422 validation error","Payment not received or x402 handshake fails returns 402 Payment Required","Hyperliquid upstream API unavailable causes 503 or stale data","Network timeout from Workers edge returns 504"],"whenToPreferThis":"Choose this endpoint when you need real-time L2 order book depth specifically from Hyperliquid for BTC, ETH, or SOL perpetuals, and you want pay-per-call micropayment access with no API key setup. Prefer it over CEX order book APIs when targeting Hyperliquid liquidity specifically, or over generic aggregators when you need venue-specific depth with spread in basis points already computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:06.892Z","isFirstParty":false,"canonicalSlug":"hyperliquid-l2-orderbook-via-x402-7a9a479f"}