Hyperliquid
Every wallet's perp history, positions, liquidations, builders, candles and daily Parquet files.
Every Hyperliquid wallet's perp history, positions and liquidations, the leaderboards, builder-code economics,
Hyperliquid's own candles and daily Parquet files of every fill and position, over
the /v1/hyperliquid routes.
What it answers
Each recipe answers one question with a call you can copy and a real response. All recipes lists every one by number.
The data behind it
| Dataset | Kind | What it holds |
|---|---|---|
| Position snapshots | data | Open Hyperliquid positions captured every 5 minutes — the latest snapshot, or history by window. |
| Fills | data | Per-wallet fills with side, price, notional, fee, maker flag and closed PnL. |
| Candles | data | Hyperliquid OHLCV built from executed fills — time bars and N-trade tick bars. |
| Liquidations | data | Liquidation events, and each coin's open interest sitting close to liquidation. |
| Traders & leaderboard | analytics | Trader rankings by PnL, ROI, win rate, volume and risk metrics over a window, with cohort filters. |
| Builders | analytics | Builder-code leaderboard — fee revenue, routed volume, unique traders and fills per builder. |
Whole days of fills and 5-minute position snapshots come as Parquet files: Download the Hyperliquid file archive.
Endpoints
| Endpoint | Request | What it returns |
|---|---|---|
| Top traders | GET /v1/hyperliquid/traders | Top HL perp traders by the requested metric over the window. |
| Find a position | GET /v1/hyperliquid/positions/match | Find open positions matching a symbol/side/leverage/entry profile — the 'who else is in this trade' query. |
| Positions | GET /v1/hyperliquid/positions | Position rows, current or historical. |
| Open interest by coin | GET /v1/hyperliquid/positions/symbols | Market-wide open interest per coin at the latest snapshot, with the venue's own OI alongside our aggregate so the two can be reconciled. |
| Leaderboard | GET /v1/hyperliquid/leaderboard | Trader leaderboard carrying the full risk-metric set. |
| Flow-adjusted leaderboard | GET /v1/hyperliquid/leaderboard/flow-adjusted | Leaderboard ranked on trading PnL, with external flow reported beside it. |
| Wallet summary | GET /v1/hyperliquid/wallets/{address} | One wallet: equity, cohorts, risk metrics, lifetime external flow. |
| Wallet closed trades | GET /v1/hyperliquid/wallets/{address}/trades | Closed round-trip trades for one wallet. |
| Wallet trade statistics | GET /v1/hyperliquid/wallets/{address}/trades/summary | Trade statistics for one wallet, overall and per coin. |
| Wallet fills | GET /v1/hyperliquid/wallets/{address}/fills | Raw fills for one wallet. |
| Wallet funding payments | GET /v1/hyperliquid/wallets/{address}/funding | Funding paid and received by one wallet. |
| Wallet ledger | GET /v1/hyperliquid/wallets/{address}/ledger | Deposits, withdrawals, transfers and vault events for one wallet. |
| Liquidations | GET /v1/hyperliquid/liquidations | Realized liquidation fills. |
| Liquidation heatmap | GET /v1/hyperliquid/symbols/{symbol}/liquidation-heatmap | Where liquidations would cluster if price moved — every open position's own liquidation price, binned and weighted by notional. |
| Liquidation risk | GET /v1/hyperliquid/liquidations/risk | Share of each coin's open interest sitting close to liquidation. |
| Exchange stats | GET /v1/hyperliquid/stats | Ecosystem time series: perp equity, open interest, position counts. |
| Volume by coin | GET /v1/hyperliquid/stats/volume | Hourly perp volume, whole venue or one coin. |
| HYPE holders | GET /v1/hyperliquid/hype/holders | HYPE holder leaderboard — spot balance plus staked, per wallet. |
| Builder leaderboard | GET /v1/hyperliquid/builders | Builder leaderboard — fee revenue, routed volume, unique traders, fills. |
| Builder ecosystem stats | GET /v1/hyperliquid/builders/stats | Builder-code economics for the whole venue — the summary-card surface. |
| Builder profile | GET /v1/hyperliquid/builders/{builder} | One builder: window totals plus per-asset and per-dex breakdowns. |
| Builder users | GET /v1/hyperliquid/builders/{builder}/users | The wallets routing through one builder, ranked. |
| Builder fills | GET /v1/hyperliquid/builders/{builder}/fills | Raw builder-routed fills, newest first. |
| Builder daily series | GET /v1/hyperliquid/builders/{builder}/series | Fee, volume, users and fills per bucket for one builder, newest first. |
| Wallet builders | GET /v1/hyperliquid/wallets/{address}/builders | Reverse lookup — which builders this wallet's flow is routed through. |
| Candles | GET /v1/hyperliquid/ohlcv | Hyperliquid candles, derived from executed fills. |
| Latest candle of every coin | GET /v1/hyperliquid/ohlcv/latest | The newest 1-minute candle of every symbol that traded in the last hour, in one request. |
| Coins hourly | GET /v1/hyperliquid/symbols/hourly | Hourly close + open interest + funding rate + premium, many assets at once. |
| Candle export | GET /v1/hyperliquid/ohlcv/export | Stream a window as NDJSON. |
| Archive file index | GET /v1/hyperliquid/archive/datasets | Index of the Hyperliquid Parquet file archive: which UTC days exist and what is in each file. |
| Archive download link | GET /v1/hyperliquid/archive/url | A temporary link to ONE archive file. |
What every route in this namespace shares, the cursor paging, the errors and the cohort vocabulary, is on Hyperliquid endpoints.
Before you rely on it
Before you rely on it lists what the field names do not tell you.