{"uid":"cap_Obr1eM8g4jrevLuyqr4Wq","slug":"hyperliquid-orderbook-snapshot-5d5b6953","name":"Hyperliquid Orderbook Snapshot","description":"First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).","url":"https://hyperliquid-data.v1337.org/v1/markets/orderbook","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ID_fVNQtRUviqHtVR6Yo8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current orderbook (bids and asks) for a specified Hyperliquid perpetual market","exampleAgentPrompt":"Pull the current orderbook for BTC-PERP on Hyperliquid — show me the top 10 bids and asks so I can see the spread and liquidity depth right now.","exampleUseCases":[{"title":"Pre-trade liquidity check","prompt":"Before I place a large SOL-PERP order on Hyperliquid, can you pull the current orderbook and tell me how much size is sitting within 0.5% of the mid price on both sides?"},{"title":"Spread monitoring for arbitrage","prompt":"Fetch the current bid-ask spread and top 5 levels on the ETH-PERP Hyperliquid orderbook — I want to see if there's an arb opportunity opening up right now."},{"title":"Market microstructure research","prompt":"I'm analyzing Hyperliquid perp markets — grab me the full orderbook snapshot for AVAX-PERP so I can compare depth and imbalance between buys and sells."}],"resultDescription":"A structured orderbook snapshot containing arrays of bid and ask price levels with corresponding sizes, representing the current state of the limit order book for the requested Hyperliquid perpetual market. Typically includes price, quantity, and cumulative depth at each level.","failureModes":["Unknown or delisted market symbol returns a 404 or empty orderbook","Malformed request body (missing required fields) returns a 400 validation error","x402 payment failure or insufficient USDC balance returns a 402 Payment Required response","Hyperliquid node connectivity issues may result in stale or unavailable data","Rate limiting or node lag may cause delayed responses during high-volatility periods"],"whenToPreferThis":"Choose this endpoint when you need real-time orderbook depth specifically from Hyperliquid's perpetual futures markets and want first-party data computed from the operator's own node fills ledger rather than a third-party aggregator. Ideal for pre-trade analysis, spread monitoring, liquidity assessment, or microstructure research on Hyperliquid perps. The pay-per-call x402 model ($0.001 USDC) makes it cost-efficient for spot queries without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:59:30.470Z","isFirstParty":false}