# Hyperliquid Periodic ABCI State - Binary Data

`periodic_abci_states` contains periodic binary state dumps. These files are archival inputs for state-aware consumers and can seed generated order-book snapshots. They are not a JSON event feed.

## Access

| Availability      | Access                                                                                                                                         | Details                                                                                                                                      |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Live / replay     | [Dedicated Node Cluster gRPC](https://www.dwellir.com/docs/hyperliquid/pricing#dedicated-cluster)                                                                     | Direct gRPC access to `periodic_abci_states` is available only with a [Dedicated Node Cluster](https://www.dwellir.com/docs/hyperliquid/pricing#dedicated-cluster). |
| Archival          | [S3 Bucket](https://www.dwellir.com/docs/hyperliquid/historical-data)                                                                                                 | S3 coverage for `periodic_abci_states`: `2026-04-14` to today, stored as `<height>.rmp.lz4`.                                                 |
| Related live data | [StreamOrderbookSnapshots](https://www.dwellir.com/docs/hyperliquid/stream_orderbook_snapshots) and [GetOrderBookSnapshot](https://www.dwellir.com/docs/hyperliquid/get_order_book_snapshot) | Snapshot availability and maximum response size vary by endpoint.                                                                            |

## File layout

Depending on the source object and compression state, the relative filename ends in one of these forms:

```text
periodic_abci_states/<date>/<block-number>.rmp
periodic_abci_states/<date>/<block-number>.rmp.lz4
```

## Binary format

The payload is binary RMP (MessagePack) state. A `.rmp.lz4` object must be decompressed before an RMP decoder reads it; the resulting bytes are still RMP, not JSON. Select a decoder that matches the node-state schema for the object you consume. Never pass the bytes to a JSON parser or infer a JSON structure from the filename.

## Important fields

There is no stable top-level JSON field table for this dataset. The filename identifies the associated sequential block position, while the decoded binary fields depend on the matching RMP state schema. Preserve large integers, byte arrays, and map keys without lossy JSON conversion.

For order-book reconstruction, use a generated snapshot derived for that purpose and then apply ordered book diffs after its position. Do not treat an arbitrary binary state dump as the public snapshot response shape.

A generated book snapshot cannot establish complete account balances or margin state. See [account-risk reconstruction requirements](https://www.dwellir.com/docs/hyperliquid/research#can-i-reconstruct-account-risk-from-book-snapshots) before selecting replay inputs.

## Related pages

- [Generated order-book snapshots](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/book-snapshots) — Use the purpose-built public snapshot format for reconstruction.
- [Raw book diffs](https://www.dwellir.com/docs/hyperliquid/data-catalog/node-feeds/book-diffs) — Apply ordered changes after a known state seed.
- [L4 books](https://www.dwellir.com/docs/hyperliquid/data-catalog/derived/l4-book) — Consume the derived, order-level live view.