{"uid":"cap_qUFTPQsYTYWTAJqsczNSY","slug":"hyperliquid-perpetuals-order-book-depth-c359b594","name":"Hyperliquid Perpetuals Order Book Depth","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/hyperliquid-libro-pago?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":["moneda"],"properties":{"moneda":{"type":"string","description":"Asset, e.g. BTC, ETH, SOL, HYPE"},"niveles":{"type":"integer","description":"Levels per side (1-20, default 10)"}}},"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":{"nota":{"type":["string","null"]},"activo":{"type":["string","null"]},"fuente":{"type":["string","null"]},"spread":{"type":["number","null"]},"ventas":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"precio":{"type":["null","number"]},"tamano":{"type":["null","number"]},"ordenes":{"type":["null","number"]}}}},"compras":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"precio":{"type":["null","number"]},"tamano":{"type":["null","number"]},"ordenes":{"type":["null","number"]}}}},"momento":{"type":["string","null"]},"spread_pb":{"type":["number","null"]},"mejor_venta":{"type":["number","null"]},"mejor_compra":{"type":["number","null"]},"precio_medio":{"type":["number","null"]},"profundidad_usd":{"type":["object","null"],"properties":{"1%":{"type":["object","null"],"properties":{"ventas":{"type":["number","null"]},"compras":{"type":["number","null"]}}},"2%":{"type":["object","null"],"properties":{"ventas":{"type":["number","null"]},"compras":{"type":["number","null"]}}},"0.5%":{"type":["object","null"],"properties":{"ventas":{"type":["number","null"]},"compras":{"type":["number","null"]}}}}}}}}}}},"responseSchema":{"type":"json","example":{"nota":"Profundidad aproximada, con el libro agregado de Hyperliquid (20 niveles por lado).","activo":"ETH","fuente":"Hyperliquid (datos abiertos)","spread":0.1,"ventas":[{"precio":2721.3,"tamano":9.8106,"ordenes":3},{"precio":2721.4,"tamano":19.6975,"ordenes":3},{"precio":2721.5,"tamano":36.9922,"ordenes":11},{"precio":2721.6,"tamano":62.0813,"ordenes":9},{"precio":2721.7,"tamano":111.5755,"ordenes":17}],"compras":[{"precio":2721.2,"tamano":10.6164,"ordenes":6},{"precio":2721.1,"tamano":1.2147,"ordenes":5},{"precio":2721,"tamano":1.2147,"ordenes":5},{"precio":2720.9,"tamano":15.5023,"ordenes":6},{"precio":2720.8,"tamano":29.7899,"ordenes":7}],"momento":"2026-10-02T14:53:27+00:00","spread_pb":0.367,"mejor_venta":2721.3,"mejor_compra":2721.2,"precio_medio":2721.25,"profundidad_usd":{"1%":{"ventas":46808022,"compras":59229054},"2%":{"ventas":86066756,"compras":102648588},"0.5%":{"ventas":42536775,"compras":46015761}}}},"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_jPkTA3JVUwQlorJcDRNzs","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 real-time order book for a Hyperliquid perpetual asset, including best bid/ask, spread in basis points, mid price, top N levels per side, and USD liquidity depth at ±0.5%, ±1%, and ±2% of mid price.","exampleAgentPrompt":"What does the ETH perpetual order book look like on Hyperliquid right now — give me the top 10 levels per side, the spread in basis points, and how much USD liquidity sits within 1% of mid?","exampleUseCases":[{"title":"Pre-trade slippage estimation for large order","prompt":"I'm about to buy $2 million worth of BTC perps on Hyperliquid — can you pull the order book and tell me how much slippage I should expect based on the liquidity within 0.5%, 1%, and 2% of mid?"},{"title":"Real-time spread monitoring for arb strategy","prompt":"What's the current best bid, best ask, and spread in basis points for SOL perpetuals on Hyperliquid? Show me the top 5 levels per side."},{"title":"Market microstructure snapshot for research","prompt":"Can you get me a full order book snapshot for HYPE perpetuals on Hyperliquid with 20 levels per side, including the mid price and USD depth at all three bands?"}],"resultDescription":"Returns a JSON object with: the asset ticker, best bid (mejor_compra) and best ask (mejor_venta), spread in price units and in basis points (spread_pb), mid price (precio_medio), arrays of bid and ask levels each containing price, size, and order count, USD liquidity depth buckets at ±0.5%, ±1%, and ±2% from mid (split by buys and sells), a timestamp, and a data source note.","failureModes":["Unsupported or misspelled asset symbol returns null or error response","Levels parameter outside 1-20 range may be clamped or rejected","Hyperliquid API downtime causes stale or missing data","Network latency may cause slightly outdated order book snapshots","Payment failure (x402) results in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need real-time Hyperliquid perpetual order book data specifically — including granular depth, spread in basis points, and USD liquidity bands for slippage estimation. It is purpose-built for Hyperliquid perps and returns pre-computed depth metrics that would otherwise require multiple raw API calls and local aggregation. Prefer this over generic exchange APIs when the target market is Hyperliquid and you need actionable microstructure data for trade sizing or timing decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:41:47.853Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetuals-order-book-depth-c359b594"}