{"uid":"cap_WMujJk_2Hjst7jWLaGpXm","slug":"vextorium-hyperliquid-orderbook-33f4139b","name":"Vextorium Hyperliquid Orderbook","description":"Order book of a Hyperliquid perpetual: best bid/ask, spread in basis points, mid price, top levels and USD liquidity within ±0.5%, ±1% and ±2% of mid. Use it to estimate slippage before trading.","url":"https://api.vextorium.com/v1/hyperliquid-orderbook?utm_source=zero.xyz","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":{"required":["currency"],"properties":{"levels":{"type":"integer","description":"Levels per side (1-20, default 10)"},"currency":{"type":"string","description":"Asset, e.g. BTC, ETH, SOL, HYPE"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"buys":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"size":{"type":["null","number"]},"price":{"type":["null","number"]},"orders":{"type":["null","number"]}}}},"note":{"type":["string","null"]},"asset":{"type":["string","null"]},"sells":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"size":{"type":["null","number"]},"price":{"type":["null","number"]},"orders":{"type":["null","number"]}}}},"moment":{"type":["string","null"]},"source":{"type":["string","null"]},"spread":{"type":["number","null"]},"best_buy":{"type":["number","null"]},"avg_price":{"type":["number","null"]},"best_sell":{"type":["number","null"]},"depth_usd":{"type":["object","null"],"properties":{"1%":{"type":["object","null"],"properties":{"buys":{"type":["number","null"]},"sells":{"type":["number","null"]}}},"2%":{"type":["object","null"],"properties":{"buys":{"type":["number","null"]},"sells":{"type":["number","null"]}}},"0.5%":{"type":["object","null"],"properties":{"buys":{"type":["number","null"]},"sells":{"type":["number","null"]}}}}},"spread_bp":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"buys":[{"size":10.6164,"price":2721.2,"orders":6},{"size":1.2147,"price":2721.1,"orders":5}],"note":"Approximate depth, from the Hyperliquid aggregated book (20 levels per side).","asset":"ETH","sells":[{"size":9.8106,"price":2721.3,"orders":3},{"size":19.6975,"price":2721.4,"orders":3}],"moment":"2026-10-02T14:53:27+00:00","source":"Hyperliquid (open data)","spread":0.1,"best_buy":2721.2,"avg_price":2721.25,"best_sell":2721.3,"depth_usd":{"1%":{"buys":59229054,"sells":46808022},"2%":{"buys":102648588,"sells":86066756},"0.5%":{"buys":46015761,"sells":42536775}},"spread_bp":0.367}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IRgFuwiHn2ZF-OLddQpJU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current bid/ask orderbook for a given asset on Hyperliquid, including price levels, sizes, spread, and market depth in USD.","exampleAgentPrompt":"What does the Hyperliquid order book look like for ETH right now? Show me the top 5 levels per side including prices, sizes, and the bid-ask spread.","exampleUseCases":[{"title":"Pre-trade spread check for ETH","prompt":"Before I place a large ETH trade on Hyperliquid, can you pull the current order book and tell me the bid-ask spread in basis points and how much USD depth is available within 0.5% of the mid price?"},{"title":"Market depth monitor for HYPE token","prompt":"Check the Hyperliquid order book for HYPE and tell me how many USD of buy and sell orders are stacked within 1% and 2% of the current price — I want to see if there's enough liquidity."},{"title":"Best price lookup before algo execution","prompt":"What are the current best bid and best ask prices for SOL on Hyperliquid, and what's the average mid price across the top 20 levels per side?"}],"resultDescription":"Returns a structured JSON object containing: arrays of bid and ask price levels each with price, size, and order count; the best bid (best_buy) and best ask (best_sell); average mid price; absolute spread and spread in basis points; USD market depth at 0.5%, 1%, and 2% from mid; the asset symbol; data source label; and a UTC timestamp of the snapshot.","failureModes":["Unknown or unsupported asset symbol returns an error or null data","Hyperliquid API downtime causes empty or failed response","Invalid levels value outside 1-20 range may cause validation error","Malformed request body missing required currency field returns 400-level error","Stale data possible during periods of extreme market activity"],"whenToPreferThis":"Choose this endpoint when you need real-time Hyperliquid-specific orderbook data including depth, spread, and level-by-level order counts. It is ideal for pre-trade analysis, liquidity assessment, and market microstructure monitoring on the Hyperliquid perpetuals exchange. Prefer this over generic CEX order book APIs when the user explicitly wants Hyperliquid data or is trading on that platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:40:31.453Z","isFirstParty":false,"canonicalSlug":"vextorium-hyperliquid-orderbook-33f4139b"}