{"uid":"cap_D6etYYQRXbwM9MdJe6KjD","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-level-2-order-book-923f9714","name":"Hyperliquid Perpetual Futures Level-2 Order Book","description":"The level-2 order book for one perpetual-futures market: aggregated bid and ask price levels, each with size and the number of resting orders, as of the book timestamp. Pass the coin in the path (e.g. BTC). Use to gauge liquidity, spread, and depth. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock, a market & economic data API (x402, USDC).","url":"https://agents.x402stock.xyz/api/v1/perps/orderbook/{coin}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Hyperliquid perpetual coin symbol, e.g. BTC or ETH."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","coin","bids","asks"],"properties":{"asks":{"type":"array","items":{"type":"object","required":["price","size","orders"],"properties":{"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"orders":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"bids":{"type":"array","items":{"type":"object","required":["price","size","orders"],"properties":{"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"orders":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"coin":{"type":"string"},"as_of":{"type":"string"},"venue":{"type":"string"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a2QevokbLhhyVj_L35PDP","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns the aggregated level-2 order book (bids and asks with price, size, and order count) for a specified Hyperliquid perpetual-futures market.","exampleAgentPrompt":"Show me the current level-2 order book for BTC perpetual futures on Hyperliquid — I want to see the bids, asks, sizes, and number of resting orders at each price level.","exampleUseCases":[{"title":"Pre-trade liquidity check for large order","prompt":"Before I put in a big BTC perp trade, can you pull the Hyperliquid order book for BTC and tell me how much size is sitting within 0.5% of the mid price on both sides?"},{"title":"Spread monitoring for arbitrage opportunity","prompt":"What's the current bid-ask spread on the ETH perpetual futures order book on Hyperliquid right now? I want to see the top bid and ask prices."},{"title":"Market depth comparison across coins","prompt":"Can you grab the level-2 order books for SOL and AVAX perpetuals on Hyperliquid so I can compare which market has deeper liquidity?"}],"resultDescription":"Returns a JSON object with the coin symbol, venue name ('Hyperliquid'), a timestamp ('as_of'), and two arrays — 'bids' and 'asks' — each containing price level objects with the price (number or null), aggregated size (number or null), and number of resting orders (number or null) at that level.","failureModes":["Invalid or unsupported coin symbol returns an error or empty book arrays","Coin symbol not listed on Hyperliquid perpetuals results in a 404 or empty response","Temporary Hyperliquid DEX unavailability may cause stale or missing data","Malformed path parameter (e.g. lowercase when uppercase required) may yield no results"],"whenToPreferThis":"Use this endpoint when you need real-time, granular order book depth data for Hyperliquid perpetual futures markets — specifically when assessing liquidity, bid-ask spread, or the number of resting orders at each price level before executing a trade or conducting market microstructure analysis. Prefer this over spot crypto data endpoints when the target instrument is a perpetual futures contract on Hyperliquid's on-chain DEX.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T06:44:53.824Z","isFirstParty":false}