---
title: "Get Quant Regime History"
method: GET
path: "/api/v1/quant/regimes/history"
tags: ["Quant"]
---

# Get Quant Regime History

`GET /api/v1/quant/regimes/history`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/quant/regimes/history`
- Auth: API key in header `X-API-Key`

Bulk download: the full market 6-regime history Parquet (Pro Plus).

One hourly row per bar, **2020 → yesterday**, market scope, with the full
distribution over all 6 regimes at three horizons — **now, 4h, 24h**
(`p_now_*`, `p_4h_*`, `p_24h_*`, keyed by regime id; see `regime_map`). The
deep history is the same model that serves live, run over the Binance public
archive it trained on — no hindsight relabeling — stitched to the live tail
(the `source` column marks the seam). Returns a pre-signed URL so you pull
multi-year history in one request instead of paginating `/quant/history`.

Rebuilt daily. `p_4h`/`p_24h` are exact `αᵀAⁿ` transition-matrix
projections of the current posterior, not realized outcomes.

## Response `200`

Successful Response

- QuantRegimeHistoryResponse: Pre-signed download for the full market 6-regime history Parquet. One hourly row per bar from 2020 to yesterday (market scope), each carrying the full distribution over the 6 regimes at three horizons — now, 4h and 24h (`p_now_*`, `p_4h_*`, `p_24h_*`, keyed by regime id per `regime_map`). The deep history is labelled by the same model that serves live (no hindsight); the `source` column marks the Binance-archive vs live-Hyperliquid seam.
  - `download_url` string, required: Pre-signed URL to the Parquet file
  - `expires_in` integer, required: Seconds until the download URL expires
  - `format` string
  - `rows` integer, required: Number of hourly rows in the file
  - `start` integer, required: First row timestamp (ms epoch)
  - `end` integer, required: Last row timestamp (ms epoch)
  - `model_version` string, required
  - `horizons` string[], required: Distribution horizons, e.g. [now, 4h, 24h]
  - `regime_map` object, required: regime_id -> label
  - `columns` string[], required: Parquet column order
  - `generated_at` string, required: When the file was last rebuilt (ISO 8601)

---

[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)