Hyperliquid

Hyperliquid historical market data details - currency pairs, data coverage and data collection specifics

Hyperliquid historical data is available since 2024-10-29.

https://api.tardis.dev/v1/exchanges/hyperliquidapi.tardis.dev

See Hyperliquid historical data coverage: available symbols, channels, date ranges and incidents

Downloadable CSV files

Historical CSV datasets for the first day of each month are available to download without API key. See downloadable CSV files documentation.

data type	symbol	date
incremental_book_L2	BTC	2024-12-01	Download sample
trades	BTC	2024-12-01	Download sample
derivative_ticker	BTC	2024-12-01	Download sample

API Access and data format

Historical data format is the same as provided by real-time Hyperliquid WebSocket API with addition of local timestamps. If you'd like to work with normalized data format instead (same format for each exchange) see downloadable CSV files or official client libs that can perform data normalization client-side.

Python

# pip install tardis-dev
import asyncio
from tardis_dev import Channel, replay

async def main():
    async for local_timestamp, message in replay(
        exchange="hyperliquid",
        from_date="2024-11-01",
        to_date="2024-11-02",
        filters=[Channel(name="l2Book", symbols=["BTC"])],
        api_key="YOUR_API_KEY",
    ):
        # messages as provided by Hyperliquid real-time stream
        print(message)

asyncio.run(main())

See Python client docs.

Node.js

cURL & HTTP API

cURL & tardis-machine

Captured real-time channels

Subscriptions | Hyperliquid Docshyperliquid.gitbook.io

See Hyperliquid WebSocket API docs providing documentation for each captured channel's format

Click any channel below to see HTTP API response with historical data recorded for it.

• trades Trade executions stream

• l2Book Order book snapshots stream. Snapshot feed, pushed on each block that is at least 0.5s since last push.

• bbo — available since 2025-06-26 Best bid and offer updates stream. Sent only if the BBO changes on a block.

• activeAssetCtx Perpetual asset context updates stream with funding, open interest and mark price

• activeSpotAssetCtx Spot asset context updates stream. Uses the same activeAssetCtx subscription type — returns WsActiveSpotAssetCtx for spot coins.

Market data collection details

Market data collection infrastructure for Hyperliquid is located in GCP asia-northeast1 (Tokyo, Japan).

Real-time market data is captured via multiple WebSocket connections to wss://api.hyperliquid.xyz/ws.