{"uid":"cap_Thqj-I2ZceEFlgNfSFkmF","slug":"laevitas-hyperliquid-l2-orderbook-754dcdd3","name":"Laevitas Hyperliquid L2 Orderbook","description":"Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.\n\n## Authentication\n\nUse an API key for authenticated REST requests:\n\n```http\nX-API-Key: your-api-key-here\n```\n\nMost data endpoints also support x402 pay-per-request without an API key.\n\n| Resource | Path |\n| --- | --- |\n| OpenAPI JSON | `GET /openapi.json` |\n| x402 discovery | `GET /.well-known/x402` |\n| Changelog | `GET /api/v1/changelog` |\n| WebSocket docs | `GET /websocket` |\n\n## REST Surfaces\n\n| Surface | Examples |\n| --- | --- |\n| Instruments | Cross-market contract reference data |\n| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |\n| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |\n| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |\n| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |\n| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |\n| Predictions | Polymarket instruments, categories, trades, ticker history |\n| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |\n| Analytics | Realized volatility and derived metrics |\n\n## Pagination\n\nPaginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.\n\n## WebSocket Streaming\n\nReal-time streams are documented at `/websocket`.\n\n| Data | Channel pattern |\n| --- | --- |\n| Trades | `trades.{market}.{exchange}.{instrument}` |\n| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |\n| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |\n\nVariables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.\n\n## Quick Start\n\n```bash\ncurl \"https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL\" \\\n  -H \"X-API-Key: your-api-key-here\"\n```","url":"https://apiv2.laevitas.ch/api/v1/hyperliquid/node/l2-orderbook","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"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","properties":{"end":{"type":"string"},"limit":{"type":"integer","maximum":1000,"minimum":1},"start":{"type":"string"},"cursor":{"type":"string"},"dedupe":{"type":"boolean"},"wallet":{"type":"string"},"sort_by":{"enum":["time","total_notional","buy_notional","sell_notional","net_notional","realized_pnl","trade_count"],"type":"string"},"currency":{"type":"string"},"exchange":{"type":"string"},"resolution":{"enum":["1m","5m","15m","1h","4h","1d"],"type":"string"},"market_type":{"enum":["perp","perp_hip3","spot","prediction"],"type":"string"},"min_notional":{"type":"number"},"instrument_name":{"type":"string"},"instrument_name_raw":{"type":"string"},"min_target_notional":{"type":"number"},"max_distance_from_mark":{"type":"number"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[],"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fFgw5VHCEwyZW1Xe4E9J0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the Level 2 order book (bid/ask depth) for a specified instrument on the Hyperliquid HyperCore decentralized exchange.","exampleAgentPrompt":"Pull the current L2 order book for BTC-PERP on Hyperliquid HyperCore — show me the top 50 bid and ask levels for the perp market.","exampleUseCases":[{"title":"Alert on liquidity spikes across instruments","prompt":"Watch the L2 orderbook for ETH-PERP on Hyperliquid and let me know if the bid-ask spread widens beyond 2 bips or total depth drops below 500k notional — I need to know immediately if liquidity dries up."},{"title":"Monitor maker-taker dynamics in real-time","prompt":"Pull the current L2 book for SOL-PERP on Hyperliquid HyperCore and compare the depth at different price levels — show me if there's more volume on bids or asks right now, and flag if the orderbook looks heavily skewed."},{"title":"Track execution slippage for large orders","prompt":"Get the L2 orderbook depth for BTC-SPOT on Hyperliquid and estimate how much slippage I'd hit if I wanted to market buy 10 BTC right now — walk me through the bid levels."}],"resultDescription":"Returns a JSON object with a 'data' array containing bid and ask price levels with their associated sizes for the requested Hyperliquid instrument, and a 'success' boolean status flag.","failureModes":["Missing or invalid instrument_name returns empty data array","Invalid market_type enum value returns 400 error","Unsupported currency or exchange parameter returns empty results","Exceeding limit maximum of 1000 returns validation error","Payment failure (x402) returns 402 Payment Required if no API key provided","Rate limiting or quota exhaustion returns 429"],"whenToPreferThis":"Use this endpoint when you need real-time bid/ask depth specifically from the Hyperliquid HyperCore decentralized exchange. Prefer this over generic CEX orderbook endpoints when analyzing on-chain liquidity, maker/taker spreads, or market microstructure for Hyperliquid perpetual or spot instruments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:04:32.801Z","isFirstParty":false}