Economic Calendar API
A granular API for retrieving economic calendar events, interest rates, and CPI data for major economies.
Note: All date and time values returned by this API are in UTC (Coordinated Universal Time).
Endpoint
https://diszy.com/bot/tms/calendar⚠️ Default Behavior
By default (no query parameters), only HIGH impact events are returned for backward compatibility. To retrieve all impact levels, you must explicitly specify country parameters with desired impact levels (e.g., ?us=low,mid,high).
Query Parameters
Filter events by country and impact level. If no parameters are provided, only HIGH impact events are returned. Specify any country parameter below to enable granular filtering.
| Parameter | Description | Values |
|---|---|---|
types | Select specific data sections to retrieve | rates, cpi, calendarDefault: Returns all |
lang | Language for event descriptions | en (default), de, es, fr, etc. |
us | United States | Impact levels: low, mid, high |
eu | Europe | Impact levels: low, mid, high |
jp | Japan | Impact levels: low, mid, high |
uk | United Kingdom | Impact levels: low, mid, high |
ch | Switzerland | Impact levels: low, mid, high |
au | Australia | Impact levels: low, mid, high |
ca | Canada | Impact levels: low, mid, high |
Date Range Filters
Filter events by a specific calendar week, month, or single date.
| Parameter | Description | Values |
|---|---|---|
week | Filter by ISO calendar week | 5 (week 5 of current year)2026-W05 or 2026-5 |
month | Filter by calendar month | 2 (February of current year)2026-02 |
date | Filter by specific date | 2026-01-31 (ISO format) |
If no date filter is specified, events for the next 45 days are returned.
Examples
1. Default (High Impact Only + All Data)
Returns Rates, CPIs, and High Impact Events.
2. Get Rates Only
3. Calendar Only (High & Medium Impact US/EU)
4. Calendar with German Descriptions
5. Japan (All Levels) + Swiss (Low Only)
4. All Events for Major Economies
Returns all impact levels for US, EU, UK, and Japan.
5. Events for a Specific Week (Calendar Week 5)
Returns HIGH impact events for calendar week 5 of the current year.
6. Events for February 2026
Returns HIGH and MEDIUM impact US events + HIGH impact EU events for February 2026.
7. Events for a Specific Date
Returns all HIGH impact events scheduled for March 20th, 2026.
Response Structure
{
"rates": [ ... ], // Central Bank Rates
"cpis": [ ... ], // Inflation Data
"treasuries": [ ... ], // US Treasury Yields
"calendarEvents": [
{
"name": "Fed Interest Rate Decision",
"dateUtc": "2026-03-20T18:00:00.000Z",
"countryCode": "US",
"volatility": "HIGH",
"title": "Fed Interest Rate Decision", // Friendly title
"description": "The Federal Reserve's decision..." // Rich description
},
...
],
"holidays": [ ... ],
"meta": {
"rangeType": "week", // "week", "month", "date", or "default"
"rangeStartDate": "2026-01-27T00:00:00.000Z",
"rangeEndDate": "2026-02-03T00:00:00.000Z",
"totalEvents": 5
}
}Historical Events Endpoint
Query historical calendar events stored in the database. This endpoint allows you to retrieve past events for analysis and backtesting.
Endpoint
https://diszy.com/bot/tms/calendar/historyQuery Parameters
| Parameter | Description | Example |
|---|---|---|
from | Start date (ISO format) | 2025-01-01 |
to | End date (ISO format) | 2025-12-31 |
country | Country codes (comma-separated) | US,EU,JP |
volatility | Impact levels (comma-separated) | HIGH,MEDIUM |
lang | Language code for translations | en, de, es, etc. |
limit | Max results (default: 100, max: 500) | 50 |
Example: Get Q1 2026 US High Impact Events
Example: Get Events in German
Response with Translations
{
"events": [
{
"id": 123,
"name": "Fed Interest Rate Decision",
"dateUtc": "2026-03-20T18:00:00.000Z",
"countryCode": "US",
"volatility": "HIGH",
"category": "central_bank",
"icon": "🏦",
"title": "Fed Zinsentscheidung", // Translated title
"description": "Die Federal Reserve gibt...", // Translated
"hasTranslation": true
},
...
],
"count": 15,
"query": { "from": "...", "lang": "de" }
}Multi-Language Support
Events can have localized titles and descriptions. Use the lang parameter to get translations.
Get Available Languages
/bot/tms/calendar/languagesReturns a list of all available language codes.
Event Explanations & Translations
The API automatically provides detailed explanations and localized titles for major economic events. Below is a live list of event types that include rich descriptions in multiple languages.
Select Language: