{"uid":"cap_tFT1MjQpjS_TC34gqbqjy","slug":"hyperliquid-l2-order-book-d74d7e02","name":"Hyperliquid L2 Order Book","description":"Live L2 order book for one Hyperliquid asset — bids and asks with price, size and order count, up to 20 levels per side.","url":"https://hyperliquid.use.x402atlas.com/book","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","required":["coin"],"properties":{"coin":{"type":"string","maxLength":32,"description":"Asset symbol (perp e.g. BTC, or spot pair e.g. PURR/USDC)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asks":{"type":"array","items":{"type":"object","properties":{"n":{"type":"integer","description":"Number of orders at this level"},"px":{"type":"string","description":"Price (string for full precision)"},"sz":{"type":"string","description":"Size (string for full precision)"}}}},"bids":{"type":"array","items":{"type":"object","properties":{"n":{"type":"integer","description":"Number of orders at this level"},"px":{"type":"string","description":"Price (string for full precision)"},"sz":{"type":"string","description":"Size (string for full precision)"}}}},"coin":{"type":"string"},"time":{"type":"string","format":"date-time","description":"Book timestamp reported by Hyperliquid"},"queried_at":{"type":"string","format":"date-time","description":"When this response was generated"}}}}}}},"responseSchema":{"type":"json","example":{"asks":[{"n":2,"px":"64251.0","sz":"0.8"}],"bids":[{"n":3,"px":"64249.0","sz":"1.5"}],"coin":"BTC","time":"2026-07-10T12:00:00Z","queried_at":"2026-07-10T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Sa3JMNXslQywT2RRbWEkJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live L2 order book (bids and asks) for a single Hyperliquid asset with price, size, and order count up to 20 levels per side.","exampleAgentPrompt":"Pull the current L2 order book for BTC on Hyperliquid — I want to see the full bids and asks with prices and sizes.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing arrays of bid and ask levels, each with price (px), size (sz), and number of orders (n) at that level, along with the asset symbol, the book timestamp reported by Hyperliquid, and the time the response was generated. Up to 20 levels are returned per side.","failureModes":["Missing or invalid 'coin' query parameter returns an error","Unknown or delisted asset symbol returns no data or an error","Network timeout from Hyperliquid upstream results in a 5xx response","Rate limiting or payment failure returns a 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need real-time market depth data (bids and asks) for a specific Hyperliquid asset — either a perpetual (e.g. BTC) or a spot pair (e.g. PURR/USDC). Prefer this over mid-price endpoints when you need full book depth, spread analysis, or liquidity assessment rather than just the last price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:04.666Z","isFirstParty":false}