# Hyperliquid Data Catalog

This catalog maps what a Hyperliquid node writes to disk to the live and generated views exposed through Dwellir. Dataset and view names link to focused explainers with access paths, payload samples, file layouts, and field notes.

## Node-written data

These are raw protocol records emitted to files by a Hyperliquid node. Live and retained gRPC availability varies by feed; the S3 Bucket is the access path for archival files.

| Node source                                                                                | Purpose                                                                       | Live access                                                                                                                                       | Archival data                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`replica_cmds`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/blocks)                         | Hyperliquid blocks, signed actions, responses, and consensus metadata         | [StreamBlocks](https://www.dwellir.com/docs/hyperliquid/stream_blocks), [GetBlock](https://www.dwellir.com/docs/hyperliquid/get_block)                                                          | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2025-01-25` to `2026-09-28`                                                                                                       |
| [`node_fills_by_block`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/fills)                   | Per-account execution records grouped by sequential block number              | [StreamFills](https://www.dwellir.com/docs/hyperliquid/stream_fills), [GetFills](https://www.dwellir.com/docs/hyperliquid/get_fills), [hl\_getBatchBlocks](https://www.dwellir.com/docs/hyperliquid/hl_getBatchBlocks) | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2025-07-27` to `2026-09-28`; [tick data](https://www.dwellir.com/docs/hyperliquid/tick-data); [indexed fills](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/fills) |
| [`node_order_statuses_by_block`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/order-statuses) | Order lifecycle events, including opens, fills, cancellations, and rejections | [StreamOrderStatuses](https://www.dwellir.com/docs/hyperliquid/stream_order_statuses), [GetOrderStatuses](https://www.dwellir.com/docs/hyperliquid/get_order_statuses)                          | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2026-01-22` to `2026-09-28`; [indexed order history](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/fills/historical-orders)                 |
| [`node_raw_book_diffs_by_block`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/book-diffs)     | Native order-level additions, updates, and removals                           | [StreamRawBookDiffs](https://www.dwellir.com/docs/hyperliquid/stream_raw_book_diffs), [GetRawBookDiffs](https://www.dwellir.com/docs/hyperliquid/get_raw_book_diffs)                            | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2026-01-22` to `2026-09-28`                                                                                                       |
| [`misc_events_by_block`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/misc-events)            | Miscellaneous protocol events                                                 | [StreamMiscEvents](https://www.dwellir.com/docs/hyperliquid/stream_misc_events), [GetMiscEvents](https://www.dwellir.com/docs/hyperliquid/get_misc_events)                                      | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2026-06-29` to `2026-09-28`                                                                                                       |
| [`node_twap_statuses_by_block`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/twap-statuses)   | TWAP lifecycle events                                                         | [StreamTwapStatuses](https://www.dwellir.com/docs/hyperliquid/stream_twap_statuses), [GetTwapStatuses](https://www.dwellir.com/docs/hyperliquid/get_twap_statuses)                              | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2026-07-01` to `2026-09-28`                                                                                                       |
| [`periodic_abci_states`](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/abci-states)            | Periodic RMP state dumps that can seed generated order-book snapshots         | [Dedicated Node Cluster gRPC](https://www.dwellir.com/docs/hyperliquid/pricing#dedicated-cluster)                                                                        | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data) from `2026-04-14` to `2026-09-28`                                                                                                       |

### File families

- `replica_cmds` uses compressed JSONL chunks. A single file can contain multiple blocks; the [block explainer](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/blocks) documents chunk names and line indexing.
- Most `*_by_block` feeds use a shared JSON envelope with one array of feed-specific events per sequential block number.
- `periodic_abci_states` uses binary MessagePack files (`.rmp` or `.rmp.lz4`). S3 provides archival access, while direct gRPC access requires a [Dedicated Node Cluster](https://www.dwellir.com/docs/hyperliquid/pricing#dedicated-cluster).

### Shared `*_by_block` envelope

Most node-written `*_by_block` datasets store feed-specific events in the same envelope:

```json
{
  "local_time": "2026-07-02T11:10:49.483839100",
  "block_time": "2026-07-02T11:10:47.023075863",
  "block_number": 1057659853,
  "events": []
}
```

`local_time` is when the node wrote the record, `block_time` is the consensus timestamp, `block_number` is the sequential block position, and `events` contains dataset-specific values. An empty array means that source envelope has no matching events; it is not a transport heartbeat.

The sequential `block_number` in these envelopes and `abci_block.round` in `replica_cmds` are different values. Consensus rounds can skip and do not advance 1:1 with block height.

## S3 bucket coverage

Inventory measured on `2026-10-01` UTC.

The S3 bucket also contains older fill generations and generated order-book snapshots. See [historical data](https://www.dwellir.com/docs/hyperliquid/historical-data) for formats and access details.

| Prefix                         | From         | To           | Object shape                  | Compressed size |  Files | Average/month | Files/month |
| ------------------------------ | ------------ | ------------ | ----------------------------- | --------------: | -----: | ------------: | ----------: |
| `replica_cmds`                 | `2025-01-25` | `2026-09-28` | LZ4-compressed native records |        80.65 TB | 68,993 |       4.99 TB |       3,766 |
| `node_trades`                  | `2025-03-22` | `2025-05-25` | `.lz4`                        |        15.13 GB |  1,541 |       6.73 GB |         720 |
| `node_fills`                   | `2025-05-25` | `2025-07-27` | `.lz4`                        |        31.81 GB |  1,507 |      13.49 GB |         720 |
| `node_fills_by_block`          | `2025-07-27` | `2026-09-28` | `hourly .lz4`                 |       294.58 GB | 10,288 |      25.98 GB |         736 |
| `node_order_statuses_by_block` | `2026-01-22` | `2026-09-28` | `hourly .lz4`                 |        18.56 TB |  6,000 |       2.19 TB |         736 |
| `node_raw_book_diffs_by_block` | `2026-01-22` | `2026-09-28` | `hourly .lz4`                 |         3.50 TB |  6,000 |     458.80 GB |         736 |
| `misc_events_by_block`         | `2026-06-29` | `2026-09-28` | `hourly .lz4`                 |        25.76 GB |  2,161 |       8.54 GB |         744 |
| `node_twap_statuses_by_block`  | `2026-07-01` | `2026-09-28` | `hourly .lz4`                 |         2.90 GB |  2,160 |       1.00 GB |         744 |
| `orderbook_snapshots`          | `2026-04-14` | `2026-09-28` | `<height>.json.lz4`           |       283.03 GB | 19,115 |      56.01 GB |       3,765 |
| `periodic_abci_states`         | `2026-04-14` | `2026-09-28` | `<height>.rmp.lz4`            |        15.79 TB | 20,718 |       2.90 TB |       3,766 |

Sizes use decimal GB and TB. Monthly averages use up to three recent calendar months with files on every date.
Use the [date-range estimator](https://www.dwellir.com/docs/hyperliquid/historical-data#compressed-size-and-file-count) before buying access.

## Order books and derived data

V3 market streams expose typed live views without historical replay. Use the Hyperliquid Index or archival data when you need historical coverage.

| Derived view                                                                            | V3 market method                                                                                                                            | Related live or indexed access                                                                       |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [L2 book snapshots](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/l2-book)                     | [StreamL2Book](https://www.dwellir.com/docs/hyperliquid/stream_l2_book)                                                                                            | [Order Book WebSocket L2](https://www.dwellir.com/docs/hyperliquid/l2-book)                                                 |
| [Best bid and offer](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/bbo)                        | [StreamBbo](https://www.dwellir.com/docs/hyperliquid/stream_bbo)                                                                                                   | [Order Book WebSocket BBO](https://www.dwellir.com/docs/hyperliquid/bbo)                                                    |
| [Ordered L2 book changes](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/l2-book)               | [StreamL2BookDiff](https://www.dwellir.com/docs/hyperliquid/stream_l2_book_diff)                                                                                   | Seed from a known snapshot before applying diffs                                                     |
| [Full L4 order book](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/l4-book)                    | [StreamL4Book](https://www.dwellir.com/docs/hyperliquid/stream_l4_book)                                                                                            | [Order Book WebSocket L4](https://www.dwellir.com/docs/hyperliquid/l4-book)                                                 |
| [Typed L4 order updates](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/l4-book)                | [StreamL4OrderUpdates](https://www.dwellir.com/docs/hyperliquid/stream_l4_order_updates)                                                                           | [Order Book WebSocket overview](https://www.dwellir.com/docs/hyperliquid/order-book-server)                                 |
| Take-profit and stop-loss updates                                                       | [StreamTpslUpdates](https://www.dwellir.com/docs/hyperliquid/stream_tpsl_updates)                                                                                  | [Order Book WebSocket overview](https://www.dwellir.com/docs/hyperliquid/order-book-server)                                 |
| [Matched trades](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/trades)                         | [StreamTrades](https://www.dwellir.com/docs/hyperliquid/stream_trades)                                                                                             | [Order Book WebSocket trades](https://www.dwellir.com/docs/hyperliquid/trades) and [tick data](https://www.dwellir.com/docs/hyperliquid/tick-data) |
| [All account fills](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/fill-views)                  | [StreamAllFills](https://www.dwellir.com/docs/hyperliquid/stream_all_fills)                                                                                        | [Hyperliquid Index fills](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/fills/all-fills)                       |
| [Fills for one user](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/fill-views)                 | [StreamUserFills](https://www.dwellir.com/docs/hyperliquid/stream_user_fills)                                                                                      | [Hyperliquid Index fills](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/fills)                                 |
| [Builder-attributed fills](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/fill-views)           | [StreamBuilderFills](https://www.dwellir.com/docs/hyperliquid/stream_builder_fills)                                                                                | [Hyperliquid Index fills](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/fills)                                 |
| [Liquidation fills](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/fill-views)                  | [StreamLiquidationFills](https://www.dwellir.com/docs/hyperliquid/stream_liquidation_fills)                                                                        | [Hyperliquid Index fills](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/fills)                                 |
| [Live candles](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/candles)                          | [StreamCandle](https://www.dwellir.com/docs/hyperliquid/stream_candle)                                                                                             | Indexed [OHLCV history](https://www.dwellir.com/docs/hyperliquid/hyperliquid-index/ohlcv-data)                              |
| [Generated order-book snapshots](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/book-snapshots) | [StreamOrderbookSnapshots](https://www.dwellir.com/docs/hyperliquid/stream_orderbook_snapshots), [GetOrderbookSnapshot](https://www.dwellir.com/docs/hyperliquid/get_order_book_snapshot) | [Order Book WebSocket L4](https://www.dwellir.com/docs/hyperliquid/l4-book)                                                 |
| [All market mids](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/market-context)                | [StreamAllMids](https://www.dwellir.com/docs/hyperliquid/stream_all_mids)                                                                                          | [Info endpoint](https://www.dwellir.com/docs/hyperliquid/info-endpoint)                                                     |
| [Active asset context](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/market-context)           | [StreamActiveAssetCtx](https://www.dwellir.com/docs/hyperliquid/stream_active_asset_ctx)                                                                           | [Active asset data](https://www.dwellir.com/docs/hyperliquid/active-asset-data)                                             |

Order-book reconstruction requires a snapshot or another known state seed followed by ordered diffs. Raw diffs alone are insufficient. For trades, a match can contain multiple makers. Within one block, group fills by `(coin, tid)`. Across blocks, include `block_number` or `block_time` because `tid` is not globally unique.

## Practical guides

- [Connect to the Order Book WebSocket API](https://www.dwellir.com/guides/order-book-server) for a complete live L2/L4 integration walkthrough.
- [Track Hyperliquid whales](https://www.dwellir.com/guides/hyperliquid-whale-tracking) using fills, trades, and account data.
- [Monitor Hyperliquid funding rates](https://www.dwellir.com/guides/hyperliquid-funding-rates) with live and historical market data.
- [Export Hyperliquid OHLCV data to CSV](https://www.dwellir.com/guides/hyperliquid-ohlcv-csv-export) for analysis and backtesting.