Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hyperliquid

Hyperliquid crypto perps and spot historical data.

Crypto perpetual and spot market data from the Hyperliquid L1. USDC-margined.

Data available from: 2025-07-28 (complete data from this date onward) Collateral token: USDC Markets: 350+ perp markets, 280+ spot pairs

Datasets

Bucket: s3://hydromancer-reservoir (requester pays)

Dataset
Path
Description

All perp fills

by_dex/hyperliquid/fills/perp/all/date=YYYY-MM-DD/

Every perp trade execution

Liquidations

by_dex/hyperliquid/fills/perp/liquidations/date=YYYY-MM-DD/

Liquidation fills only

ADL

by_dex/hyperliquid/fills/perp/adl/date=YYYY-MM-DD/

Auto-deleveraging events

Builder fills

by_dex/hyperliquid/fills/perp/builder_fills/date=YYYY-MM-DD/

Builder-routed trades

TWAP fills

by_dex/hyperliquid/fills/perp/twap_fills/date=YYYY-MM-DD/

TWAP order executions

Spot fills

global/fills/spot/all/date=YYYY-MM-DD/

All spot trades (Hyperliquid only)

Candles

by_dex/hyperliquid/candles/1s/date=YYYY-MM-DD/

1-second OHLCV candlesticks

Perp positioning snapshots

by_dex/hyperliquid/snapshots/perp/date=YYYY-MM-DD/

Daily position snapshots

Spot holdings snapshots

global/snapshots/spot/date=YYYY-MM-DD/

Daily spot balance snapshots

Account values

global/snapshots/account_values/date=YYYY-MM-DD/

Daily account value snapshots

Sub-dataset files (liquidations, adl, etc.) are only created for dates that have data. If a file is missing for a date, there were no events of that type.

Quick Start

INSTALL httpfs;
LOAD httpfs;
SET s3_region = 'ap-northeast-1';

-- BTC fills for a day
SELECT timestamp, side, price, size, direction, address
FROM read_parquet('s3://hydromancer-reservoir/by_dex/hyperliquid/fills/perp/all/date=2026-03-22/fills.parquet')
WHERE coin = 'BTC'
ORDER BY timestamp;

-- BTC 1-minute candles (aggregated from 1s)
SELECT time_bucket(INTERVAL '1 minute', timestamp) as minute,
       first(open) as open, max(high) as high,
       min(low) as low, last(close) as close,
       sum(volume) as volume, sum(trade_count) as trades
FROM read_parquet('s3://hydromancer-reservoir/by_dex/hyperliquid/candles/1s/date=2026-03-22/candles.parquet')
WHERE coin = 'BTC'
GROUP BY minute ORDER BY minute;

-- Largest BTC positions
SELECT user, size, notional, entry_price, leverage, leverage_type
FROM read_parquet('s3://hydromancer-reservoir/by_dex/hyperliquid/snapshots/perp/date=2026-03-22/*.parquet')
WHERE market = 'BTC'
ORDER BY abs(size) DESC LIMIT 10;

For schema details see: Fills · Candles · Snapshots

Last updated