---
title: "Hyperliquid Historical Data API | 0xArchive Docs"
description: "Historical market state, trades, candles, order flow, funding, open interest, liquidations, and monitoring for Hyperliquid under /v1/hyperliquid."
canonical_url: "https://www.0xarchive.io/docs/hyperliquid-historical-data-api/"
markdown_url: "https://www.0xarchive.io/docs/hyperliquid-historical-data-api.md"
route: "/docs/hyperliquid-historical-data-api"
robots: "index, follow"
generated_from: "prerendered_html"
---

# Hyperliquid Historical Data API

Historical market state, trades, candles, order flow, funding, open interest, liquidations, and monitoring for Hyperliquid under /v1/hyperliquid.

Namespace /v1/hyperliquid Coverage State, history, order flow, monitoring Auth X-API-Key

Copy Markdown

[Open Hyperliquid routes](https://www.0xarchive.io/docs/rest-api/hyperliquid/)

[Use the playground](https://www.0xarchive.io/docs/playground/)

### 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.