# Get Economic Calendar

> Returns economic calendar events, optionally scoped to a symbol. When a symbol_id is supplied, relevance is determined by the symbol's base and quote assets (currency filter) and its asset class (category filter); when omitted, all events in the window are returned. An explicit currencies or categories param overrides the symbol-derived defaults. Results can be bounded by a from/to date range. No authentication required.


Source: /trader/api/data/get-economic-calendar

## `GET /public/economic-calendar`

**Get Economic Calendar**

Returns economic calendar events, optionally scoped to a symbol. When a symbol_id is supplied, relevance is determined by the symbol's base and quote assets (currency filter) and its asset class (category filter); when omitted, all events in the window are returned. An explicit currencies or categories param overrides the symbol-derived defaults. Results can be bounded by a from/to date range. No authentication required.


Tags: `Data`

#### Query parameters

- `symbol_id` (string) — Optional symbol ID. Its base/quote assets select relevant currencies and its asset class selects a default category set. Omit for an unscoped calendar.

- `currencies` (string) — Comma-separated list of currency codes to filter by (e.g. EUR,USD). Overrides the symbol-derived currency filter. Empty or omitted leaves currency scoping to the symbol (if any).

- `from` (string) — Lower bound (inclusive) for event dates, RFC3339 or YYYY-MM-DD. Defaults to 30 days ago when omitted.

- `to` (string) — Upper bound (inclusive) for event dates, RFC3339 or YYYY-MM-DD. Defaults to 7 days from now when omitted.

- `categories` (string) — Comma-separated list of economic categories to filter by. When omitted, the relevant categories are derived automatically from the symbol's asset class (forex, stock/ETF/index, and commodity each get a tailored set; other classes such as crypto are left unfiltered). Passing this param overrides that default. Unknown names are ignored. Allowed values: MONETARY_POLICY, INFLATION, EMPLOYMENT, GROWTH_OUTPUT, BUSINESS_ACTIVITY, CONSUMER, TRADE, HOUSING, MONEY_CREDIT, GOVERNMENT_FINANCE, ENERGY, COMMODITIES, MARKET_POSITIONING, OTHER.



### Responses

#### `200` — Economic calendar events relevant to the symbol

**Content-Type:** `application/json`

- `events` (array) (required)
  - items:
    - `date` (string) (required) — Event date/time, "YYYY-MM-DD HH:MM:SS" in UTC
    - `country` (string) (required)
    - `currency` (string) (required)
    - `event` (string) (required)
    - `impact` (string) (required) — One of: "Low", "Medium", "High"
    - `previous` (number)
    - `estimate` (number)
    - `actual` (number)
    - `change` (number)
    - `change_percentage` (number)
    - `unit` (string)
    - `is_past` (boolean) (required)
    - `category` (string) — Economic category of the event. Empty when unspecified. One of: MONETARY_POLICY, INFLATION, EMPLOYMENT, GROWTH_OUTPUT, BUSINESS_ACTIVITY, CONSUMER, TRADE, HOUSING, MONEY_CREDIT, GOVERNMENT_FINANCE, ENERGY, COMMODITIES, MARKET_POSITIONING, OTHER.

    - `relevance_tier` (string) — Relevance tier of the event, derived from its country. Empty when unspecified. One of: CORE (ECB/Eurozone-wide, Fed/US-wide), MAJOR (Germany, France, Italy, Spain), SECONDARY (other smaller but potentially relevant economies), LOCAL (Latvia-specific releases).