---
title: "Get Policy Regime"
method: GET
path: "/api/v1/policy/regime"
tags: ["Geopolitical / Policy Shock Regime"]
---

# Get Policy Regime

`GET /api/v1/policy/regime`

## Request

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

Policy Risk score + signed tilt + upcoming rate catalysts.

The main Geopolitical / Policy Shock payload: the market-wide Policy Risk
composite, the signed ``policy_tilt`` (pro-crypto vs restrictive), and the
scheduled rate decisions within ``window_days``. Use `/policy/regime/score`
for the full sub-score breakdown and `/policy/headlines` for the live
US-regulatory headline feed.

**Partly backfillable** — the gdelt / cross-asset / rate subscores replay from
GDELT's dated series, the archived macro block, and the rate schedule; the
``policy_headlines`` sidecar is live-only (null on backfill).

## Query parameters

- `window_days` integer: Forward horizon for rate catalysts

## Response `200`

Successful Response

- PolicyRegimeResponse: Upcoming rate catalysts + market-wide policy risk — the main payload.
  - `items` PolicyEventModel[], required
    - `event_type` string, required
    - `title` string, required
    - `date` string, required
    - `days_until` integer, required
    - `macro_class` string, nullable
    - `bias` string, required
    - `magnitude` number, nullable
    - `source` string
  - `count` integer, required
  - `window_days` integer, required
  - `policy_risk_score` number, required
  - `band` 'dormant' | 'quiet' | 'elevated' | 'heavy' | 'critical', required
  - `policy_tilt` number, required: -1 restrictive/risk-off … +1 pro-crypto/risk-on
  - `tilt_label` 'pro_crypto' | 'restrictive' | 'neutral', 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)
