{"uid":"cap_D6etYYQRXbwM9MdJe6KjD","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-level-2-order-book-923f9714","name":"Hyperliquid Perpetual Futures Level-2 Order Book","description":"Returns level-2 order book for one perpetual-futures market.","url":"https://agents.x402stock.xyz/api/v1/perps/orderbook/{coin}?utm_source=zero.xyz","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-x402","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-10-30T19:05:28.145Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-level-2-order-book-923f9714"}