Economic Calendar API
FREE APIA granular API for retrieving economic calendar events, interest rates, CPI data, and corporate earnings seasons 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 |
cn | China | 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 (ISO format) | 2026-01-31 |
tzOffset | Timezone offset in hours from UTC to shift the date boundary | 2 (for UTC+2) |
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)
1. Calendar with German Descriptions
2. Japan (All Levels) + Swiss (Low Only)
3. All Events for Major Economies
Returns all impact levels for US, EU, UK, and Japan.
1. Events for a Specific Week (Calendar Week 5)
Returns HIGH impact events for calendar week 5 of the current year.
2. Events for February 2026
Returns HIGH and MEDIUM impact US events + HIGH impact EU events for February 2026.
3. Events for a Specific Date
Returns all HIGH impact events scheduled for March 20th, 2026. Use tzOffset (in hours) to shift the midnight window to your local time (e.g. 2 for CEST/UTC+2), preventing events near midnight from being clipped into adjacent days.
1. Fetching Upcoming Holidays & Active Earnings Seasons
Because Holidays and Earnings Seasons are inherently bound to exact dates, you do not need specific query parameters like types=earnings or types=holidays. The API resolves overlapping holidays and active earnings seasons automatically based on your requested time range (?month=2026-04 or ?week=16).
2. Extracting only Calendar Data (Includes Holidays & Earnings)
Use types=calendar to omit rates and CPI data. The response will include your requested economic events, plus any holidays and earningsSeasons intersecting your date range.
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
"_groupedEvents": 2, // Integer count (appears only if multiple events were collapsed)
"_subEvents": [ // Array of the original unmerged event objects
{ ... },
{ ... }
]
},
...
],
"holidays": [ ... ],
"earningsSeasons": [
{
"id": 1,
"countryCode": "US",
"quarter": "Q1_2026",
"startDate": "2026-04-10T00:00:00.000Z",
"endDate": "2026-05-15T00:00:00.000Z",
"peakStart": "2026-04-20T00:00:00.000Z",
"peakEnd": "2026-05-02T00:00:00.000Z",
"impact": "high"
}
],
"meta": {
"rangeType": "week", // "week", "month", "date", or "default"
"rangeStartDate": "2026-01-27T00:00:00.000Z",
"rangeEndDate": "2026-02-03T00:00:00.000Z",
"totalEvents": 5
}
}Intelligent Event Aggregation
To prevent noisy double-posts and spam, the Calendar API implements intelligent event grouping. When multiple related events share the exact same timestamp and country (e.g. "U.S. Consumer Price Index YoY" and "U.S. Consumer Price Index MoM"), they are automatically collapsed into a single, clean descriptor. Included in aggregated objects is an additional _groupedEvents meta field containing an integer count of how many events were merged, as well as a _subEvents array containing the underlying original event objects. The highest volatility rating among the grouped events is always retained.
Earnings Seasons Included
The API automatically queries overlapping corporate Earnings Seasons based on the date range of your request. These will appear inside the earningsSeasons array property in the response structure. They cover large periods and include detailed peakStart to peakEnd properties representing maximum market volatility.
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
Example: Querying Past Earnings Seasons
Any US Earnings Seasons recorded in the database that intersect your historical from and to dates are automatically included in the earningsSeasons response array alongside regular calendar events.
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
},
...
],
"earningsSeasons": [
{
"id": 1,
"countryCode": "US",
"quarter": "Q1_2026",
"startDate": "2026-04-10T00:00:00.000Z",
"endDate": "2026-05-15T00:00:00.000Z",
"peakStart": "2026-04-20T00:00:00.000Z",
"peakEnd": "2026-05-02T00:00:00.000Z",
"impact": "high"
}
],
"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: