--- title: "Crypto Historical Data API | 0xArchive Docs" description: "Replayable historical market data across Hyperliquid, HIP-3, and Lighter.xyz, with one API key and route families from first request to production use." canonical_url: "https://www.0xarchive.io/docs/crypto-historical-data-api/" markdown_url: "https://www.0xarchive.io/docs/crypto-historical-data-api.md" route: "/docs/crypto-historical-data-api" robots: "index, follow" generated_from: "prerendered_html" --- # Crypto Historical Data API Replayable historical market data across Hyperliquid, HIP-3, and Lighter.xyz, with one API key and route families from first request to production use. Coverage Hyperliquid, HIP-3, Lighter.xyz Access REST, WebSocket, SDKs Start Routes, playground, quick start Copy Markdown [Open REST API](https://www.0xarchive.io/docs/rest-api/) [Create account](https://www.0xarchive.io/signup/) ### Overview Hyperliquid, Lighter.xyz, and HIP-3 REST endpoints for order books, trades, candles, order flow, liquidations, freshness, and coverage. Use the venue atlas to jump to the right route family. Every route expands into parameters, credits, and an example request. [Hyperliquid 25 route s Core perp routes for market state, history, order flow, liquidations, and monitoring.](https://www.0xarchive.io/docs/crypto-historical-data-api/#rest-hyperliquid) [Lighter.xyz 16 route s Lighter routes for market state, history, L3 depth, and reconstruction-heavy jobs.](https://www.0xarchive.io/docs/crypto-historical-data-api/#rest-lighter) [HIP-3 25 route s Builder-perp routes inside the Hyperliquid namespace, including depth, liquidations, and order flow.](https://www.0xarchive.io/docs/crypto-historical-data-api/#rest-hip3) [Data Quality 8 route s Freshness, incidents, latency, coverage, and health checks.](https://www.0xarchive.io/docs/crypto-historical-data-api/#rest-data-quality) Coverage ### 74 documented routes Hyperliquid, Lighter.xyz, and HIP-3 endpoints for order books, trades, candles, liquidations, freshness, incidents, and coverage. Hyperliquid ### 25 Hyperliquid routes Core perp routes for order books, trades, candles, funding, open interest, liquidations, order flow, and freshness. Lighter.xyz ### 16 Lighter routes Historical and reconstruction-heavy routes for order books, trades, candles, L3 depth, summary, and prices. HIP-3 + Monitoring ### 33 HIP-3 and data-quality routes Builder-perp REST coverage plus freshness, incidents, latency, health, and coverage monitoring. ### Pair the reference with these docs pages [Quick Start Make the first authenticated Hyperliquid order book request before expanding into the full reference.](https://www.0xarchive.io/docs/quick-start/) [API Playground Run a live request in the browser before wiring code or debugging headers.](https://www.0xarchive.io/docs/playground/) [Response Schemas Open field names and payload shapes once you know the route family you need.](https://www.0xarchive.io/docs/schemas/) [Error Handling Use retry rules, plan-gate explanations, and status-code guidance when a route fails.](https://www.0xarchive.io/docs/errors/) ### Hyperliquid Core perp routes for market state, history, order flow, liquidations, and monitoring. #### Hyperliquid - Order Book GET `/v1/hyperliquid/orderbook/:symbol` 1 credit Get current order book or snapshot at specific timestamp GET `/v1/hyperliquid/orderbook/:symbol/history` 5 credit s Get historical order book snapshots with pagination. #### Hyperliquid - Trades GET `/v1/hyperliquid/trades/:symbol` 2 credit s Get trade history with cursor pagination. #### Hyperliquid - Market Data GET `/v1/hyperliquid/instruments` 1 credit List all available Hyperliquid trading instruments GET `/v1/hyperliquid/instruments/:symbol` 1 credit Get a single Hyperliquid instrument by symbol, including the latest venue metadata and trading state. GET `/v1/hyperliquid/openinterest/:symbol` 2 credit s Get historical open interest data with market context. GET `/v1/hyperliquid/openinterest/:symbol/current` 1 credit Get current open interest for a symbol GET `/v1/hyperliquid/funding/:symbol` 2 credit s Get historical funding rates. GET `/v1/hyperliquid/funding/:symbol/current` 1 credit Get current funding rate for a symbol GET `/v1/hyperliquid/liquidations/:symbol` 3 credit s Get liquidation events for a symbol. GET `/v1/hyperliquid/liquidations/user/:user` 3 credit s Get liquidation events for a user address. GET `/v1/hyperliquid/liquidations/:symbol/volume` 3 credit s Get pre-aggregated liquidation volumes in time-bucketed intervals. GET `/v1/hyperliquid/freshness/:symbol` 1 credit Check when data was last updated for each data type for a specific symbol. GET `/v1/hyperliquid/summary/:symbol` 2 credit s Get a combined market summary for a symbol in a single API call. GET `/v1/hyperliquid/prices/:symbol` 2 credit s Get mark and oracle price history for a symbol. #### Hyperliquid - Candles GET `/v1/hyperliquid/candles/:symbol` 3 credit s Get OHLCV candle data aggregated from trades. #### Hyperliquid - L4 Order Book (Node-Level) GET `/v1/hyperliquid/orders/:symbol/history` 5 credit s Get order history with user attribution from Hyperliquid node data. GET `/v1/hyperliquid/orders/:symbol/flow` 5 credit s Get aggregated order flow data showing buy/sell pressure over time intervals. GET `/v1/hyperliquid/orders/:symbol/tpsl` 5 credit s Get take-profit and stop-loss order history with user attribution. GET `/v1/hyperliquid/orderbook/:symbol/l4` 10 credit s Reconstruct the L4 orderbook at a specific point in time, showing individual orders with user attribution at each price level. GET `/v1/hyperliquid/orderbook/:symbol/l4/diffs` 5 credit s Get L4 orderbook diffs showing individual order changes with user attribution. GET `/v1/hyperliquid/orderbook/:symbol/l4/history` 10 credit s Get L4 orderbook checkpoints (full snapshots) with user attribution at each price level. #### Hyperliquid - L2 Full-Depth Order Book (Derived from L4) GET `/v1/hyperliquid/orderbook/:symbol/l2` 3 credit s Get the full-depth L2 orderbook at a specific point in time, derived from L4 data. GET `/v1/hyperliquid/orderbook/:symbol/l2/history` 10 credit s Get paginated L2 full-depth checkpoints over a time range. GET `/v1/hyperliquid/orderbook/:symbol/l2/diffs` 5 credit s Get tick-level L2 orderbook deltas showing price-level changes over time. ### Lighter.xyz Lighter routes for market state, history, L3 depth, and reconstruction-heavy jobs. #### Lighter.xyz - Order Book GET `/v1/lighter/orderbook/:symbol` 2 credit s Get current order book snapshot GET `/v1/lighter/orderbook/:symbol/history` 10 credit s Get historical order book snapshots with pagination and configurable resolution. #### Lighter.xyz - Trades GET `/v1/lighter/trades/:symbol` 2 credit s Get trade history with cursor pagination. GET `/v1/lighter/trades/:symbol/recent` 1 credit Get most recent trades #### Lighter.xyz - Market Data GET `/v1/lighter/instruments` 1 credit List all available Lighter.xyz trading instruments GET `/v1/lighter/instruments/:symbol` 1 credit Get a single Lighter.xyz instrument by symbol GET `/v1/lighter/openinterest/:symbol` 2 credit s Get historical open interest data. GET `/v1/lighter/openinterest/:symbol/current` 1 credit Get current open interest for a symbol GET `/v1/lighter/funding/:symbol` 2 credit s Get historical funding rates. GET `/v1/lighter/funding/:symbol/current` 1 credit Get current funding rate for a symbol #### Lighter.xyz - Candles GET `/v1/lighter/candles/:symbol` 3 credit s Get OHLCV candle data aggregated from trades. #### Lighter.xyz - Convenience GET `/v1/lighter/freshness/:symbol` 1 credit Check when data was last updated for each data type (orderbook, trades, funding, OI) for a specific Lighter.xyz coin. GET `/v1/lighter/summary/:symbol` 2 credit s Get a combined market summary for a Lighter.xyz symbol in a single API call. GET `/v1/lighter/prices/:symbol` 2 credit s Get mark and oracle price history for a Lighter.xyz symbol. #### Lighter.xyz - L3 Order Book (Order-Level) GET `/v1/lighter/l3orderbook/:symbol` 5 credit s Get current L3 order-level orderbook showing individual orders at each price level with order IDs and sizes. GET `/v1/lighter/l3orderbook/:symbol/history` 10 credit s Get historical L3 orderbook snapshots showing individual orders at each price level. ### HIP-3 Builder-perp routes inside the Hyperliquid namespace, including depth, liquidations, and order flow. #### Hyperliquid HIP-3 - Instruments (125+ markets: xyz, flx, hyna, km, vntl, cash) GET `/v1/hyperliquid/hip3/instruments` 1 credit List all available HIP-3 builder-deployed perpetuals with latest market data (mark price, open interest, mid price). GET `/v1/hyperliquid/hip3/instruments/:symbol` 1 credit Get a specific HIP-3 instrument by symbol. #### Hyperliquid HIP-3 - Order Book (Free: km:US500, Build+: all) GET `/v1/hyperliquid/hip3/orderbook/:symbol` 1 credit Get current order book or snapshot at specific timestamp for HIP-3 builder-deployed perpetuals. GET `/v1/hyperliquid/hip3/orderbook/:symbol/history` 5 credit s Get historical order book snapshots with cursor pagination. #### Hyperliquid HIP-3 - Trades (Free: km:US500, Build+: all) GET `/v1/hyperliquid/hip3/trades/:symbol` 2 credit s Get trade history with cursor pagination. GET `/v1/hyperliquid/hip3/trades/:symbol/recent` 1 credit Get most recent trades for a HIP-3 symbol. #### Hyperliquid HIP-3 - Candles (Free: km:US500, Build+: all) GET `/v1/hyperliquid/hip3/candles/:symbol` 3 credit s Get OHLCV candle data aggregated from HIP-3 trades. #### Hyperliquid HIP-3 - Market Data (Free: km:US500, Build+: all) GET `/v1/hyperliquid/hip3/openinterest/:symbol` 2 credit s Get historical open interest data. GET `/v1/hyperliquid/hip3/openinterest/:symbol/current` 1 credit Get current open interest for a HIP-3 symbol. GET `/v1/hyperliquid/hip3/funding/:symbol` 2 credit s Get historical funding rates. GET `/v1/hyperliquid/hip3/funding/:symbol/current` 1 credit Get current funding rate for a HIP-3 symbol. #### Hyperliquid HIP-3 - Liquidations (Build+) GET `/v1/hyperliquid/hip3/liquidations/:symbol` 3 credit s Get liquidation-related fills for a HIP-3 symbol. GET `/v1/hyperliquid/hip3/liquidations/:symbol/volume` 3 credit s Get pre-aggregated liquidation-related volume in time-bucketed intervals for HIP-3 symbols. #### Hyperliquid HIP-3 - Convenience GET `/v1/hyperliquid/hip3/freshness/:symbol` 1 credit Check when data was last updated for each data type (orderbook, trades, funding, OI) for a specific HIP-3 symbol. GET `/v1/hyperliquid/hip3/summary/:symbol` 2 credit s Get a combined market summary for a HIP-3 symbol in a single API call. GET `/v1/hyperliquid/hip3/prices/:symbol` 2 credit s Get mark, oracle, and mid price history for a HIP-3 symbol. #### Hyperliquid HIP-3 - L4 Order Book (Node-Level) GET `/v1/hyperliquid/hip3/orders/:symbol/history` 5 credit s Get HIP-3 order history with user attribution from Hyperliquid node data. GET `/v1/hyperliquid/hip3/orders/:symbol/flow` 5 credit s Get aggregated order flow data for HIP-3 markets showing buy/sell pressure over time intervals. GET `/v1/hyperliquid/hip3/orders/:symbol/tpsl` 5 credit s Get HIP-3 take-profit and stop-loss order history with user attribution. GET `/v1/hyperliquid/hip3/orderbook/:symbol/l4` 10 credit s Reconstruct the HIP-3 L4 orderbook at a specific point in time, showing individual orders with user attribution at each price level. GET `/v1/hyperliquid/hip3/orderbook/:symbol/l4/diffs` 5 credit s Get HIP-3 L4 orderbook diffs showing individual order changes with user attribution. GET `/v1/hyperliquid/hip3/orderbook/:symbol/l4/history` 10 credit s Get HIP-3 L4 orderbook checkpoints (full snapshots) with user attribution at each price level. #### Hyperliquid HIP-3 - L2 Full-Depth Order Book (Derived from L4) GET `/v1/hyperliquid/hip3/orderbook/:symbol/l2` 3 credit s Get the HIP-3 full-depth L2 orderbook at a specific point in time, derived from L4 data. GET `/v1/hyperliquid/hip3/orderbook/:symbol/l2/history` 10 credit s Get paginated HIP-3 L2 full-depth checkpoints over a time range. GET `/v1/hyperliquid/hip3/orderbook/:symbol/l2/diffs` 5 credit s Get tick-level HIP-3 L2 orderbook deltas showing price-level changes over time. ### Data Quality Freshness, incidents, latency, coverage, and health checks. #### Data Quality GET `/v1/data-quality/status` 0 credit Get overall system health status and per-exchange status GET `/v1/data-quality/coverage` 1 credit Get data coverage summary across all exchanges and data types. GET `/v1/data-quality/coverage/:exchange` 1 credit Get detailed coverage for a specific exchange. GET `/v1/data-quality/coverage/:exchange/:symbol` 2 credit s Get symbol-specific coverage with gap detection and empirical data cadence. GET `/v1/data-quality/incidents` 1 credit List data quality incidents with filtering and pagination GET `/v1/data-quality/incidents/:id` 1 credit Get details for a specific incident GET `/v1/data-quality/latency` 1 credit Get current latency metrics for WebSocket, REST API, and data freshness GET `/v1/data-quality/sla` 5 credit s Get SLA compliance metrics for a specific month