---
title: "Get Event Regime"
method: GET
path: "/api/v1/event/regime"
tags: ["Event / Catalyst Regime"]
---

# Get Event Regime

`GET /api/v1/event/regime`

## Request

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

Forward catalyst calendar — dated token unlocks, macro prints, and depegs.

The main Event/Catalyst payload: every catalyst in the next ``window_days``
(default 7) with its directional bias and magnitude, plus the market-wide
Event Risk score. Unlocks bias short (supply overhang); macro prints are
``risk_flag`` (the surprise is unknown ahead of time); major depegs bias
short. Use `/event/calendar` for richer filtering, `/event/regime/score` for
the composite alone.

**Partly backfillable** — unlocks / macro / depeg replay from schedule + price
history; the ``sector_rotation`` sidecar on `/event/regime/score` is
live-only and lands null on backfilled days.

## Query parameters

- `window_days` integer: Forward horizon for the calendar

## Response `200`

Successful Response

- EventRegimeResponse: Forward event calendar — the main /event/regime payload.
  - `items` EventCatalystModel[], required
    - `event_type` 'unlock' | 'macro_print' | 'depeg' | 'mint', required
    - `title` string, required
    - `date` string, required
    - `days_until` integer, required
    - `symbols` string[]
    - `bias` 'long' | 'short' | 'neutral' | 'risk_flag' | 'mixed', required
    - `magnitude` number, nullable
    - `unlocked_value_usd` number, nullable
    - `pct_of_fdv` number, nullable
    - `deviation_bps` number, nullable
    - `macro_class` string, nullable
    - `delta_usd` number, nullable
    - `pct_of_supply` number, nullable
    - `source` string
  - `count` integer, required
  - `window_days` integer, required
  - `event_risk_score` number, required
  - `band` 'dormant' | 'quiet' | 'elevated' | 'heavy' | 'critical', 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)