> For the complete documentation index, see [llms.txt](https://docs.hydromancer.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hydromancer.xyz/reservoir.md).

# Reservoir

<h3 align="center">Granular Hyperliquid historical data. Free, forever.</h3>

<p align="center">Built by Hydromancer</p>

{% columns %}
{% column %}
**Reservoir currently features:**

* [Fills](/reservoir/schema-reference/fills.md) — all trades, liquidations, ADLs, builder fills, TWAP fills
* [Candles](/reservoir/schema-reference/candles.md) — 1-second OHLCV candlesticks
* [Snapshots](/reservoir/schema-reference/snapshots.md) — daily positions, spot balances, account values
* [Orderbook](/reservoir/schema-reference/orderbook.md) — 20-level L2 snapshots at 1-minute cadence

*...with more data coming soon!*
{% endcolumn %}

{% column %}
**Delivery**

* Data is delivered through AWS S3, requester pays.
* The data cutoff is August 2025. Candlesticks are backfilled before the cutoff date.
* The data is updated **daily**.
  {% endcolumn %}
  {% endcolumns %}

***

<h4 align="center">Access the data of every HIP-3 deployer</h4>

<p align="center"><em>Complete history from launch!</em></p>

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Trade[XYZ]</strong></td><td><em>Indices, equities, and commodities</em></td><td><a href="/files/BnIUmIpLaIGIIaP6t6Mt">/files/BnIUmIpLaIGIIaP6t6Mt</a></td></tr><tr><td><strong>Ventuals</strong></td><td><em>Pre-market perps</em></td><td><a href="/files/BJej7Jp9haIfKISYpC0b">/files/BJej7Jp9haIfKISYpC0b</a></td></tr><tr><td><strong>Felix</strong></td><td><em>Indices, equities, and commodities</em></td><td><a href="/files/RU4Gz0XCySgTs77Isefo">/files/RU4Gz0XCySgTs77Isefo</a></td></tr><tr><td><strong>Markets.xyz</strong></td><td><em>Indices, equities, and commodities</em></td><td><a href="/files/3eufPuayE4CynnsgJLIz">/files/3eufPuayE4CynnsgJLIz</a></td></tr><tr><td><strong>Dreamcash</strong></td><td><em>Indices, equities, and commodities</em></td><td><a href="/files/UUEkwZrWN6S78rlMehcy">/files/UUEkwZrWN6S78rlMehcy</a></td></tr><tr><td><strong>HyENA</strong></td><td><em>USDe-margined crypto perps</em></td><td><a href="/files/wklbVrwKnCfWe8ch1lWq">/files/wklbVrwKnCfWe8ch1lWq</a></td></tr><tr><td><strong>Paragon</strong></td><td><em>Crypto market indices</em></td><td><a href="/files/wOnXoLrwH16jHhPNKXSC">/files/wOnXoLrwH16jHhPNKXSC</a></td></tr></tbody></table>

***

<h4 align="center">Access the Hyperliquid crypto perps data</h4>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Hyperliquid</strong></td><td>Crypto perps</td><td><a href="/pages/rrZoDWhktGxc0F4xV7HQ">/pages/rrZoDWhktGxc0F4xV7HQ</a></td><td><a href="/files/eliAb9PFE5pVwaEh3YYz">/files/eliAb9PFE5pVwaEh3YYz</a></td></tr></tbody></table>

***

#### Questions or data requests?

Join our [Discord](https://discord.gg/xfAWcSygQT) - we're adding new datasets based on community feedback.

#### Need real-time data?

For real-time orderbook streaming, improved API schemas for builders, and Websocket feeds, check out [Hydromancer's data streaming product](https://docs.hydromancer.xyz).