---
title: "Get Regime"
method: GET
path: "/api/v1/liquidity/regime"
tags: ["Liquidity / Market Depth"]
---

# Get Regime

`GET /api/v1/liquidity/regime`

## Request

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

Per-coin liquidity regime + market-wide aggregate + composite score.

Each coin is classified into one of: ``deep_book``, ``oi_price_divergence``,
``depth_withdrawal``, ``post_cascade_impaired``, or ``neutral``. The
composite score (0-100) maps the regime mix into a single fragility read
(higher = healthier market structure).

**Forward-only — not historically backfillable.** Unlike ``technical_regime``
(replayable from daily klines), the rules here depend on *intraday* L2 depth
deltas (10-min withdrawal, 12h depth baselines, depth/spread percentiles)
that only exist in the live per-minute sample buffer. There is no historical
source to reconstruct them from, so this signal accumulates forward from
collector start. The per-coin snapshot is archived daily so a backtestable
history builds going forward; periods before collector deploy are unavailable.

## Response `200`

Successful Response

- LiquidityRegimeResponse
  - `as_of` integer, required
  - `universe_size` integer, required
  - `coins` CoinRegimeEntry[], required
    - `coin` string, required
    - `regime` string, required: deep_book | oi_price_divergence | depth_withdrawal | post_cascade_impaired | neutral
    - `confidence` number
    - `low_confidence` boolean
    - `baseline_minutes` integer
    - `signals` object
  - `aggregate` RegimeAggregate, required
    - `deep_book` integer
    - `oi_price_divergence` integer
    - `depth_withdrawal` integer
    - `post_cascade_impaired` integer
    - `neutral` integer
    - `pct_deep_book` number
    - `pct_divergent` number
    - `pct_withdrawing` number
    - `pct_impaired` number
    - `pct_neutral` number
  - `composite_score` number, required: 0-100; higher = healthier market structure
  - `sentiment` string, required: healthy | leaning_healthy | neutral | leaning_fragile | fragile

---

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