Historical data

The examples below use the AWS CLI (see https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and LZ4 (https://github.com/lz4/lz4 or install from your package manager).

Note that the requester of the data must pay for transfer costs.

Book data

Historical data is uploaded to the bucket hyperliquid-archive approximately once a month. L2 book snapshots are available in market_data and asset contexts are available in asset_ctxs. No other historical data sets are provided via S3 (e.g. trades or data for spot markets). You can use the API to record additional historical data sets yourself.

Format: s3://hyperliquid-archive/market_data/[date]/[hour]/[datatype]/[coin].lz4 or s3://hyperliquid-archive/asset_ctxs/[date].csv.lz4

aws s3 cp s3://hyperliquid-archive/market_data/20230916/9/l2Book/SOL.lz4 /tmp/SOL.lz4 --request-payer requester
unlz4 --rm /tmp/SOL.lz4
head /tmp/SOL

Trade data

s3://hl-mainnet-node-data/node_fills has fills which are streamed via --write-fills from a non-validating node. Older data is in a different format at s3://hl-mainnet-node-data/node_trades . node_fills matches the API format, while node_trades does not.

Historical node data

s3://hl-mainnet-node-data/explorer_blocksand s3://hl-mainnet-node-data/replica_cmds contain historical explorer blocks and L1 transactions.

Last updated