---
title: "Get Quant Coins"
method: GET
path: "/api/v1/quant/coins"
tags: ["Quant"]
---

# Get Quant Coins

`GET /api/v1/quant/coins`

## Request

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

All-coins regime summary — the heatmap feed (Pro).

One trimmed entry per active Hyperliquid perp: regime + confidence,
p_direction_up (sum of the two bullish buckets), most likely transition,
and current OI. Coins with under 60 days of history carry
`insufficient_history: true` with reduced confidence; brand-new listings
show `status: warming_up` until 30 days of bars exist. Full probability
matrices live at /quant/coins/{symbol}.

## Query parameters

- `horizon` '4h' | '24h'
- `regime` string, nullable: Filter by regime label, e.g. squeeze
- `sort` 'oi' | 'confidence' | 'symbol' | 'p_up'
- `order` 'asc' | 'desc'
- `limit` integer

## Response `200`

Successful Response

- QuantCoinsResponse
  - `items` QuantCoinSummary[], required
    - `symbol` string, required
    - `regime` QuantRegimeState
      - `label` string, required: Regime label, e.g. strong_trend_bull
      - `name` string, required: Display name, e.g. Strong Trend (Bull)
      - `id` integer, required
      - `confidence` number, required: Calibrated confidence, degraded by staleness/history
      - `confidence_raw` number, required: Raw max label posterior, pre-calibration
      - `label_raw` string, required: Argmax label before hysteresis (headline label may lag)
      - `candles_in_regime` integer, required
      - `in_regime_since` string, nullable: ISO open time of the first closed 1h bar of the current label run (= last bar − (candles_in_regime − 1) h). Null while warming.
      - `pending` object, nullable: Hysteresis challenger streak {label, count, needed}; null when no challenger is accumulating bars
      - `hysteresis` object, nullable: Switch rule constants {margin, bars, override, incumbent_floor, min_dwell_bars=0} — there is no minimum dwell
    - `status` string, required
    - `p_direction_up` number, nullable: P(mild_up) + P(strong_up) at the requested horizon
    - `p_direction_down` number, nullable: P(mild_down) + P(strong_down) at the requested horizon. Note up + down + flat = 1 — never treat 1 - p_up as fall odds.
    - `top_transition` object, nullable: Most likely regime change: {to, p}
    - `oi_usd` number, nullable
    - `insufficient_history` boolean
    - `new_listing` boolean
  - `count` integer, required
  - `universe_size` integer, required
  - `horizon` string, required
  - `model_version` string, required
  - `timestamp` string, 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)