Economic Calendar Tools
Scheduled and past economic releases, central bank meetings and other market-moving events.
Dates in calendar tools
startDateandendDateacceptYYYY-MM-DD,YYYY-MM-DD HH:mmorYYYY-MM-DD HH:mm:ss, in UTC. ATis also accepted between the date and the time.- Provide
startDateandendDatetogether, or neither. - An
endDatewithout a time includes that whole day; anendDatewith a time is the exact end of the range.
Event fields
Calendar tools return the Trading Economics calendar fields, including:
| Field | Description |
|---|---|
CalendarId | The identifier of the event, as text. |
Date | Release date and time, in UTC. |
Country, Category, Event | The country, the indicator category and the event name. |
Reference, ReferenceDate | The period the release refers to, for example "Oct" and "2026-10-31T00:00:00". |
Actual | The released value; empty until the release. |
Previous | The value for the previous period, after any revision. |
Revised | The value for the previous period as originally reported, before the revision; empty when there was no revision. |
Forecast | The consensus forecast. |
TEForecast | The Trading Economics forecast. |
DateSpan | The precision of Date, as text: "0" = the date and time are known, "1" = the date and time are estimated. |
Importance | 1 = low, 2 = medium, 3 = high. |
Unit, Currency | The unit and currency of the values. |
Source, SourceURL | The official source of the release, and its website. |
URL | The path of the indicator page on the Trading Economics website. |
Ticker, Symbol | Identifiers of the underlying series. |
LastUpdate | When the event record was last updated, in UTC. |
Actual, Previous, Revised, Forecast and TEForecast are text that includes the unit or scale, for example "4.2%" or "7.079M", and are empty when no value is available.
Each request returns up to 1,000 events.
get_calendar_by_country
Calendar events, globally or for one country.
Returns economic calendar events for all countries or for one country, optionally within a date range and filtered by importance.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
country | string | No | — | Full country name, any letter case | For example "united states". ISO codes are not supported. Omit for all countries. |
startDate | string | No | — | Date, or date and time (UTC) | Start of the range. |
endDate | string | No | — | Date, or date and time (UTC) | End of the range. |
importance | integer | No | — | 1 (low), 2 (medium), 3 (high) | Returns only events of this importance. |
Example
“Which high-importance US events are scheduled between November 2 and November 6, 2026?”
{ "country": "united states", "importance": 3, "startDate": "2026-11-02", "endDate": "2026-11-06" }Example response
{
"columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
"rows": [
["397194", "2026-11-02T14:00:00", "United States", "Business Confidence", "ISM Manufacturing PMI", "Oct", "2026-10-31T00:00:00", "Institute for Supply Management", "https://www.ismworld.org", "", "54.5", "", "", "/united-states/business-confidence", "0", 3, "2026-10-01T14:00:01.47", "", "", "", "NAPMPMI", "NAPMPMI"],
["399215", "2026-11-03T15:00:00", "United States", "Job Offers", "JOLTs Job Openings", "Sep", "2026-09-30T00:00:00", "U.S. Bureau of Labor Statistics", "http://www.bls.gov", "", "7.079M", "", "7.0M", "/united-states/job-offers", "0", 3, "2026-09-29T14:00:05.06", "", "", "", "UNITEDSTAJOBOFF", "UNITEDSTAJOBOFF"]
]
}Retrieved on October 26, 2026; truncated to 2 of 7 rows. Values change over time.
Returns
The event fields.
Notes
- Without
countryand dates, the current calendar snapshot for all countries is returned.
get_calendar_by_indicator
Calendar events for one or more indicators.
Returns economic calendar events for one or more indicators across all countries, optionally within a date range and filtered by importance.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
indicators | string or string[] | Yes | — | Indicator names | For example "inflation rate" or ["inflation rate", "gdp"]. |
startDate | string | No | — | Date, or date and time (UTC) | Start of the range. |
endDate | string | No | — | Date, or date and time (UTC) | End of the range. |
importance | integer | No | — | 1 (low), 2 (medium), 3 (high) | Returns only events of this importance. |
Example
“When are inflation and GDP growth figures released in November 2026?”
{ "indicators": ["inflation rate", "gdp growth rate"], "startDate": "2026-11-01", "endDate": "2026-11-30" }Example response
{
"columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
"rows": [
["412969", "2026-11-02T04:00:00", "Indonesia", "Inflation Rate", "Inflation Rate YoY", "Oct", "2026-10-31T00:00:00", "Statistics Indonesia", "https://www.bps.go.id/", "", "3.28%", "", "3.3%", "/indonesia/inflation-cpi", "0", 2, "2026-10-14T17:22:54.023", "", "", "%", "IDCPIY", "IDCPIY"],
["412459", "2026-11-02T07:00:00", "Kazakhstan", "Inflation Rate", "Inflation Rate YoY", "Oct", "2026-10-31T00:00:00", "Agency of the Republic of Kazakhstan on Statistics", "https://new.stat.gov.kz/", "", "9.3%", "", "", "/kazakhstan/inflation-cpi", "1", 1, "2026-10-01T10:51:03.39", "", "", "", "KAZAKHSTANIR", "KazakhstanIR"]
]
}Retrieved on October 26, 2026; truncated to 2 of 159 rows. Values change over time.
Returns
The event fields.
Notes
- To filter by both country and indicator, use
get_calendar_point_in_time.
get_calendar_by_group
Calendar events for a thematic group.
Returns economic calendar events for one thematic group across countries, optionally within a date range.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
group | string | Yes | — | interest rate, inflation, bonds, consumer, gdp, government, housing, labour, markets, money, prices, trade, business | The thematic group. |
startDate | string | No | — | Date, or date and time (UTC) | Start of the range. |
endDate | string | No | — | Date, or date and time (UTC) | End of the range. |
Example
“Which labor market releases are scheduled between November 2 and November 6, 2026?”
{ "group": "labour", "startDate": "2026-11-02", "endDate": "2026-11-06" }Example response
{
"columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
"rows": [
["400361", "2026-11-02T00:30:00", "Australia", "Job Advertisements", "ANZ-Indeed Job Ads MoM", "Oct", "2026-10-31T00:00:00", "ANZ - Indeed Australian Job Ads", "https://media.anz.com/", "", "2.2%", "", "-1.4%", "/australia/job-advertisements", "0", 1, "2026-10-21T11:28:18.177", "", "", "%", "AUSTRALIAJOBADV", "AUSTRALIAJOBADV"],
["410595", "2026-11-02T07:30:00", "Austria", "Unemployment Rate", "Unemployment Rate", "Oct", "2026-10-31T00:00:00", "Public Employment Service Austria (AMS)", "https://www.ams.at", "", "7.1%", "", "7.7%", "/austria/unemployment-rate", "0", 1, "2026-10-22T14:32:57.117", "", "", "%", "UMRTAT", "UMRTAT"]
]
}Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.
Returns
The event fields.
Notes
- Use one of the listed group names. The calendar groups differ from the indicator category groups of
get_indicator_data; for example,interest rate,inflationandbondsare calendar groups only.
get_calendar_by_ticker
Calendar events for one or more tickers.
Returns economic calendar events for one or more Trading Economics tickers, optionally within a date range.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
tickers | string or string[] | Yes | — | Trading Economics tickers | For example "IJCUSA" or ["IJCUSA", "SPAINFACORD"]. |
startDate | string | No | — | Date, or date and time (UTC) | Start of the range. |
endDate | string | No | — | Date, or date and time (UTC) | End of the range. |
Example
“When are the next US initial jobless claims released?”
{ "tickers": "IJCUSA" }Example response
{
"columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
"rows": [
["397151", "2026-10-29T12:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Oct/24", "2026-10-24T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "", "194K", "200K", "196.0K", "/united-states/jobless-claims", "0", 2, "2026-10-26T08:30:41.187", "", "", "K", "IJCUSA", "IJCUSA"],
["397108", "2026-10-22T12:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Oct/17", "2026-10-17T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "194K", "200K", "200K", "200.0K", "/united-states/jobless-claims", "0", 2, "2026-10-22T12:30:01.927", "199K", "", "K", "IJCUSA", "IJCUSA"]
]
}Retrieved on October 26, 2026; truncated to 2 rows: the next scheduled release and the latest published one. Values change over time.
Returns
The event fields.
Notes
- To find a ticker, use the
HistoricalDataSymbolfield ofget_indicator_data, orsearch. - Without dates, the result includes both the scheduled releases and the releases of roughly the past year, most recent first.
get_calendar_point_in_time
Calendar events as originally published.
Returns calendar events for one country and one indicator as they appeared at the time of release, preserving the original values before any later revision. Use it for backtesting and research without look-ahead bias.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
country | string | Yes | — | Full country name, any letter case | For example "united states". ISO codes are not supported. |
indicator | string | Yes | — | Indicator name | For example "initial jobless claims". |
startDate | string | Yes | — | Date, or date and time (UTC) | Start of the range. |
endDate | string | Yes | — | Date, or date and time (UTC) | End of the range. |
Example
“Show US initial jobless claims as published between December 1, 2016 and February 25, 2017.”
{
"country": "united states",
"indicator": "initial jobless claims",
"startDate": "2016-12-01",
"endDate": "2017-02-25"
}Example response
{
"columns": ["CalendarId", "Date", "Country", "Category", "Event", "Reference", "ReferenceDate", "Source", "SourceURL", "Actual", "Previous", "Forecast", "TEForecast", "URL", "DateSpan", "Importance", "LastUpdate", "Revised", "Currency", "Unit", "Ticker", "Symbol"],
"rows": [
["87213", "2016-12-01T13:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Nov/26", "2016-11-26T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "268K", "251K", "253K", "253.1K", "/united-states/jobless-claims", "0", 2, "2016-12-01T13:30:00", "", "", "K", "IJCUSA", "IJCUSA"],
["87229", "2016-12-08T13:30:00", "United States", "Initial Jobless Claims", "Initial Jobless Claims", "Dec/03", "2016-12-03T00:00:00", "U.S. Department of Labor", "https://www.dol.gov/", "258K", "268K", "258K", "263K", "/united-states/jobless-claims", "0", 2, "2016-12-08T13:31:00", "", "", "K", "IJCUSA", "IJCUSA"]
]
}Retrieved on October 26, 2026; truncated to 2 of 13 rows.
Returns
The event fields.
Notes
- All four parameters are required.
- An ISO code such as
"us"is not rejected, but returns no events.