---
title: "Download Archives"
method: GET
path: "/api/v1/backtesting/archives/download"
tags: ["Backtesting"]
---

# Download Archives

`GET /api/v1/backtesting/archives/download`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/backtesting/archives/download`
- Auth: API key in header `X-API-Key`

Generate pre-signed download URLs for archived files.

Use ``data_type=daily`` for consolidated Parquet files (one per exchange)
instead of individual per-symbol files.

``data_type=klines_deep`` (with ``interval`` 1h/4h/1d) and ``funding_deep``
serve the deep monthly cold history — one Parquet per symbol per month,
reaching far past the rolling daily files: ``exchange=binance`` spot klines
back to each market's listing (BTCUSDT to Aug 2017), ``exchange=hyperliquid``
1d to its 2023 launch. For deep tiers ``start``/``end`` match the file's
YYYY-MM token, so pass month-granular bounds (e.g. ``start=2019-01``).

## Query parameters

- `start` string, required: Start date (YYYY-MM-DD; YYYY-MM for '*_deep' tiers)
- `data_type` string: Data type: daily, klines, funding, liquidations, hl_liquidations, hl_trade_flow, snapshots, klines_deep, or funding_deep. Use 'daily' for consolidated bundles; 'hl_liquidations' for the per-event HL liquidation tape; 'hl_trade_flow' for the 1-min HL taker buckets; '*_deep' for deep monthly cold history.
- `exchange` string: Exchange filter (klines/funding/daily/klines_deep/funding_deep)
- `symbol` string: Symbol, or snapshot type name for snapshots
- `end` string: End date (YYYY-MM-DD, defaults to today; YYYY-MM for '*_deep' tiers)
- `interval` string: Candle interval for klines_deep only: 1h, 4h, or 1d (ignored for other types).

## Response `200`

Successful Response

- BacktestArchiveDownloadResponse
  - `exchange` string, nullable
  - `symbol` string, nullable
  - `files` ArchiveDownloadLink[], required
    - `date` string, required
    - `url` string, required
    - `size_bytes` integer, required
    - `expires_in` integer
  - `count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)