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

# Get Event Calendar

`GET /api/v1/event/calendar`

## Request

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

Filterable / queryable forward catalyst calendar (up to 30d out).

The query surface for the calendar: narrow by catalyst ``type``, affected
``symbol``, ``bias``, ``min_magnitude``, and ``window_days``.

## Query parameters

- `type` 'unlock' | 'macro_print' | 'depeg' | 'mint', nullable
- `window_days` integer
- `symbol` string, nullable: Filter to catalysts affecting this ticker
- `bias` 'long' | 'short' | 'neutral' | 'risk_flag', nullable
- `min_magnitude` number

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