{"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**Subscriptions with USDC:** Premium and Enterprise can be purchased on Base or Solana for a month, a quarter, six months or a year. Access is prepaid, with no automatic renewal. [Buy a subscription](https://v3.laevitas.ch/profile/subscription/wallet) or read the [USDC subscription guide](/x402#subscriptions).\n\nThe subscription belongs to your signed-in Laevitas account; wallet sign-in does not require an email. Enterprise users generate an API key in V3 after activation. Plan and billing-period limits still apply. Subscription purchases are separate from API credit bundles.\n\nFor Claude MCP, add `https://apiv2.laevitas.ch/api/v1/mcp`, select **Sign in now → Register automatically**\nwith no custom headers, and authorize with your API key on the Laevitas page.\nDo not enter a client ID or secret manually. All OAuth clients require PKCE S256.\nConnection guide: [MCP setup](/mcp). CIMD / published client identity is not supported.\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| Options Backtests | Strategy templates, asynchronous submission, status, combined results, cancellation |\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\nBacktests are asynchronous jobs, not paginated market-data queries. Start with\n`GET /api/v1/options/backtests/strategies`, submit with `POST /api/v1/options/backtests`,\nthen poll `/{id}` and retrieve `/{id}/result`. These responses have no data/meta wrapper.\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?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"],"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-10-30T07:08:04.510Z","isFirstParty":false,"canonicalSlug":"laevitas-hyperliquid-l2-orderbook-754dcdd3"}