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

# Hyperliquid datasets: free trades, liquidations, funding and candles

> Free Hyperliquid datasets from Ironflow's nodes on Hugging Face and Kaggle: trades, liquidations, funding, hourly candles, open interest and HIP-4 outcomes.

For bulk history you do not need the API. The same data is published as free Parquet datasets under CC BY 4.0, on [Hugging Face](https://huggingface.co/ironflow) and most of them on [Kaggle](https://www.kaggle.com/ironflow). Credit "Ironflow (ironflow\.sh)" when you publish work built on them.

| Dataset | What it holds | From |
| - | - | - |
| [Hyperliquid Trades](https://huggingface.co/datasets/ironflow/hyperliquid-trades) | Every perp and spot trade, one row per trade with the buyer, the seller and the taker side. A new file every day. | 3 October 2026 |
| [Hyperliquid Liquidations](https://huggingface.co/datasets/ironflow/hyperliquid-liquidations) | Every liquidation on native and HIP-3 perps, as events and as fills, from the `liquidation` field Hyperliquid puts on each fill | 25 May 2025 |
| [Hyperliquid Funding Rates](https://huggingface.co/datasets/ironflow/hyperliquid-funding) | Every settled hourly funding rate, native and HIP-3 perps | May 2023 |
| [Hyperliquid Hourly Candles](https://huggingface.co/datasets/ironflow/hyperliquid-candles-1h) | Hourly OHLCV for every perp and spot pair, built from fills, delisted markets included | 25 May 2025 |
| [Hyperliquid Open Interest, Mark and Oracle Prices](https://huggingface.co/datasets/ironflow/hyperliquid-open-interest) | Hourly open interest, mark and oracle price for every perp | May 2023 |
| [Hyperliquid HIP-4 Outcome Markets](https://huggingface.co/datasets/ironflow/hyperliquid-outcomes) | Every HIP-4 outcome fill and every contract with its event, outcome and settlement. A new file every day. | 1 August 2026 |

Each dataset page describes its columns, coverage and checks.

## Load one in Python

```python theme={null}
import pandas as pd

# One row per liquidation event (needs huggingface_hub installed)
events = pd.read_parquet("hf://datasets/ironflow/hyperliquid-liquidations/data/events/")
print(events.groupby("market")["notional_usd"].sum().sort_values(ascending=False).head(10))
```

Column names differ per dataset: check the dataset page before you join two of them.

## Datasets or the API

* **Datasets:** the whole history in one download, for research and backtests. Updated daily (trades, outcomes) or with each release (the others).
* **API:** the last seconds to a year, filtered by market, wallet and time, plus live streams, the liquidation map and SQL. Start with the [Quickstart](https://docs.ironflow.sh/quickstart.md).


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