Docs

Hyperliquid OHLCV Full-History Exports

Download the complete Hyperliquid OHLCV archive as CSV or Parquet files directly from the Dwellir dashboard, one market and interval at a time.

Download the complete Hyperliquid OHLCV archive for one market and one candle interval as a single ready-made file. Exports are generated on demand from the Dwellir dashboard and delivered as either gzipped CSV or Parquet.

Use this when you need the full archive as one file and do not want to build your own fetcher. For single candle lookups, arbitrary time windows, or live candle updates, use the REST, JSON-RPC, or WebSocket endpoints instead.

Available from the dashboard

Full-history exports are generated from dashboard.dwellir.com on the Hyperliquid page under the OHLCV Data tab. The candle schema matches the live OHLCV endpoint exactly.

What You Get

Each export is a single file containing every candle for one market at one interval, covering the full available archive in one pass.

AttributeValue
FormatsCSV (gzipped, .csv.gz) or Parquet (.parquet)
Intervals1s, 1m, 5m
MarketsAll indexed Hyperliquid markets — perps, spot, and HIP-3 perpDexs
Coverage startSame archive floor as the live endpoint: 2025-07-27T08:00:00Z
Coverage endLatest available candle at the time of generation
Sort orderAscending by candle open time (t)
Sparse handlingEmpty intervals are omitted, matching the live product contract
RetentionDownloads remain available for 30 days after generation

The column schema is identical to the live OHLCV endpoint: s, i, t, T, o, h, l, c, v, q, n, x. Prices and volumes are serialized as decimal strings in both formats so that precision is preserved end to end.

How to Generate an Export

  1. Sign in at dashboard.dwellir.com and open the Hyperliquid page from the sidebar.
  2. Switch to the OHLCV Data tab. You will see a searchable catalog of every indexed market, its coverage window, and its duration.
  3. Find the market you want. Use the search box to filter by name (for perps, use the asset name such as BTC; spot markets are searchable by their decoded ticker) or the filter chips for Perp, Spot, or a specific HIP-3 DEX prefix.
  4. Click Generate on the row. Pick the interval (1s, 1m, 5m) and format (CSV or Parquet) in the modal.
  5. Click Generate export. Progress appears in place; you can close the modal and return later — polling continues in the background, and the completed artifact is listed on the OHLCV Data tab when it is ready.
  6. When generation completes, click Download to save the file. Re-downloads from the same run are free.

Large exports — for example full 1s history for a liquid perp — may take several minutes. Credits are reserved when you click Generate, and successful downloads are available for 30 days.

File Naming

Exports use a predictable file name so you can script downstream processing:

Text
{market}-{interval}-full.csv.gz
{market}-{interval}-full.parquet

Market names are sanitized to the [A-Za-z0-9_-] character set and lower-cased. Any other characters — for example the @ prefix on spot indexes or the : separator on HIP-3 prefixes — are replaced with - and stripped from the ends.

MarketIntervalFormatFilename
BTC1mCSVbtc-1m-full.csv.gz
@1425mParquet142-5m-full.parquet
hyna:ETH1sParquethyna-eth-1s-full.parquet

Working With the Files

CSV

The CSV is gzip-compressed with a single header row followed by one row per candle.

Bash
gunzip -c btc-1m-full.csv.gz | head

Load it directly with pandas:

Python
import pandas as pd

df = pd.read_csv("btc-1m-full.csv.gz", compression="gzip")

Parquet

The Parquet file is a single columnar output readable by DuckDB, pandas, Spark, and most analytics engines.

Python
import pandas as pd

df = pd.read_parquet("btc-1m-full.parquet")

Or in DuckDB:

sql
SELECT *
FROM read_parquet('btc-1m-full.parquet')
ORDER BY t
LIMIT 10;

Credits and Pricing

Exports are paid for with OHLCV export credits, purchased from the OHLCV Data tab. One credit covers one export — one market at one interval in one format.

  • Graduated per-credit pricing. Credits get cheaper per unit as you buy more.
  • Unlimited option. Teams that need the full catalog can switch to an unlimited tier that removes the per-export credit charge.
  • Re-downloads are free. Credits are consumed when you start an export; downloading the resulting file during the 30-day retention window does not cost additional credits.
  • 30-day retention. Artifacts and their download links expire 30 days after a successful generation. Re-generate after expiry to refresh an archive.

Current prices and the credit slider are available on the OHLCV Data tab in the dashboard.

When to Use This vs. the API

NeedRecommendation
Full history for one market and interval as one file, no fetcher to buildFull-history exports (this page)
Specific candles or arbitrary time windows on demandREST API or JSON-RPC
Live candle updatesWebSocket API
Custom fetch loop, own storage layout, or stream straight into a pipelineArchive backfill guide, CSV export guide, or Parquet export guide
Raw L1 data (fills, order book diffs, replica commands) rather than aggregated candlesArchival Data

Access