{"uid":"cap_qfkfFYpWN_26kwABZp52y","slug":"x402stock-perpetual-futures-order-book-4be31b70","name":"x402stock Perpetual Futures 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?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","HEAD","DELETE"],"type":"string"},"pathParams":{"coin":{"type":"string"},"type":"object"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"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_-C4YiBKx-dWiet15fX3vW","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 the level-2 order book for a named perpetual-futures market on Hyperliquid, with aggregated bid/ask price levels, sizes, and resting order counts.","exampleAgentPrompt":"Pull the current level-2 order book for BTC perpetual futures from Hyperliquid — I want to see the top bid and ask price levels, sizes, and how many resting orders are at each level so I can gauge the spread and depth.","exampleUseCases":[{"title":"Pre-trade liquidity check for large perp order","prompt":"Before I place a large ETH perp trade on Hyperliquid, can you pull the current order book and tell me how much depth is available on the ask side and what the spread looks like?"},{"title":"Real-time spread monitoring for BTC perps","prompt":"Keep an eye on the BTC perpetual futures order book and let me know if the bid-ask spread widens significantly — I want to know the current spread first as a baseline."},{"title":"Comparing order book depth across coins","prompt":"I'm deciding between trading SOL and AVAX perps — can you grab the order book for both coins and compare their liquidity depth and spread so I can pick the more liquid one?"}],"resultDescription":"Returns aggregated level-2 order book data for the requested perpetual futures coin, including a list of bid price levels (each with price, size, and number of resting orders) and a list of ask price levels (same fields), plus a book timestamp indicating when the snapshot was taken. Enables calculation of spread, market depth, and liquidity profiles.","failureModes":["Invalid or unsupported coin symbol returns an error or empty book","Coin exists but has very thin liquidity, resulting in a sparse order book with few levels","Payment failure (insufficient USDC balance) blocks the request","Network or DEX downtime may cause stale or unavailable book data","Misspelling the coin path parameter returns no data or an error"],"whenToPreferThis":"Use this endpoint when you need real-time perpetual futures market microstructure data — specifically bid/ask depth, spread, and resting order counts — for coins traded on Hyperliquid. Prefer this over spot order book endpoints when the user is analyzing perp markets. Prefer this over trade history or OHLCV endpoints when the focus is on current liquidity and order queue depth rather than historical price action. No API key required; cost is $0.01 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:50:16.727Z","isFirstParty":false,"canonicalSlug":"x402stock-perpetual-futures-order-book-4be31b70"}