> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypedexer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Historical Trade Archive

> How far back Hypedexer goes, what each period contains, and how to export it.

## What the API serves today

Measured on production on 18 and 19 September 2026.

| Dataset | Served from | How to query |
| - | - | - |
| Perp and spot fills, every user | 18 November 2024, continuous | [`/fills/`](/api-reference/fills/list-fills-all-=-spot-+-perp) and [`/fills/user/{user_address}`](/api-reference/fills/user-fills-all-=-spot-+-perp) with `start_time` / `end_time` |
| Candles, main perp markets | 22 March 2025 | `POST /info` with `type: "candleSnapshot"` |
| Candles, HIP-3 markets | launch of each dex (first one: 13 October 2025) | same request, coin written `dex:TICKER` |

The fills counter, [`/fills/count`](/api-reference/fills/count-fills), returned 4,051,130,410 on 19 September 2026.

### Field availability by period

Older fills carry fewer fields. The table below comes from 1,000-row samples taken in each period; a field marked "empty" is returned as `null` (or `0` for `tid`, a zero hash for `hash`).

| Period | Always present | Empty |
| - | - | - |
| 18 Nov 2024 to 21 Mar 2025 | `user`, `coin`, `px`, `sz`, `side`, `time`, `tid`, `notional`, `typeTrade` | `dir`, `oid`, `hash`, `startPosition`, `closedPnl`, `fee`, `feeToken` |
| 22 Mar 2025 to 25 May 2025 | the above, plus `dir`, `oid`, `hash`, `startPosition`, `closedPnl` | `fee`, `feeToken`, `tid` |
| 25 May 2025 onwards | every field | `priorityGas` before April 2026 |

If you compute fees or match both sides of a trade by `tid`, start on 25 May 2025 or later.

## The 2024 trade archive

Before the fills archive, Hypedexer indexed Hyperliquid trades:

| Period | Trades indexed |
| - | -: |
| Full year 2024 | **140M+** |
| Jan 1 – Jan 25, 2025 | **107M+** |
| **Total** | **247M+** |

This archive is **freely available** for the community.

## Free public export

Any wallet's trade history can be exported at no cost, as CSV or JSON:

<Card title="Trade Export Portal" icon="download" href="https://trade-export.hypedexer.com/">
  [https://trade-export.hypedexer.com/](https://trade-export.hypedexer.com/)
</Card>

This dataset is provided freely as a public good for the Hyperliquid ecosystem: researchers, analysts, and builders can use it without restriction.

## For Scale & Enterprise users

Historical data (prior to March 2025) is **exclusively available on Scale & Enterprise plans**.

If your project requires:

* **Programmatic access** to the full archive via API: use the `start_time` / `end_time` parameters on [`/fills/user/{user_address}`](/api-reference/fills/user-fills-all-=-spot-+-perp) to query historical fills
* **Custom time ranges** or filtered exports
* **Ongoing incremental updates** integrated into your pipeline
* **Dedicated support** for data ingestion

<Note>
  `/fills/` and `/fills/user/{user_address}` both return data before March 2025 when you pass `start_time` and `end_time`. Other indexed endpoints start later: see the coverage notes on each page.
</Note>

Contact us to discuss your requirements. We work directly with teams that need production-grade access to this dataset.

## Get in touch

<CardGroup cols={2}>
  <Card title="Telegram" icon="telegram" href="https://t.me/EnigmaValidatorCommunity/1">
    Join the community
  </Card>

  <Card title="Email" icon="envelope" href="mailto:contact@hypedexer.com">
    [contact@hypedexer.com](mailto:contact@hypedexer.com)
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.