Skip to content
Docs
Get API key
Tools

Economic Calendar Tools

Scheduled and past economic releases, central bank meetings and other market-moving events.

Dates in calendar tools

  • startDate and endDate accept YYYY-MM-DD, YYYY-MM-DD HH:mm or YYYY-MM-DD HH:mm:ss, in UTC. A T is also accepted between the date and the time.
  • Provide startDate and endDate together, or neither.
  • An endDate without a time includes that whole day; an endDate with a time is the exact end of the range.

Event fields

Calendar tools return the Trading Economics calendar fields, including:

FieldDescription
CalendarIdThe identifier of the event, as text.
DateRelease date and time, in UTC.
Country, Category, EventThe country, the indicator category and the event name.
Reference, ReferenceDateThe period the release refers to, for example "Oct" and "2026-10-31T00:00:00".
ActualThe released value; empty until the release.
PreviousThe value for the previous period, after any revision.
RevisedThe value for the previous period as originally reported, before the revision; empty when there was no revision.
ForecastThe consensus forecast.
TEForecastThe Trading Economics forecast.
DateSpanThe precision of Date, as text: "0" = the date and time are known, "1" = the date and time are estimated.
Importance1 = low, 2 = medium, 3 = high.
Unit, CurrencyThe unit and currency of the values.
Source, SourceURLThe official source of the release, and its website.
URLThe path of the indicator page on the Trading Economics website.
Ticker, SymbolIdentifiers of the underlying series.
LastUpdateWhen 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringNo—Full country name, any letter caseFor example "united states". ISO codes are not supported. Omit for all countries.
startDatestringNo—Date, or date and time (UTC)Start of the range.
endDatestringNo—Date, or date and time (UTC)End of the range.
importanceintegerNo—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?”

JSON
{ "country": "united states", "importance": 3, "startDate": "2026-11-02", "endDate": "2026-11-06" }
Example response
JSON
{
  "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 country and 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
indicatorsstring or string[]Yes—Indicator namesFor example "inflation rate" or ["inflation rate", "gdp"].
startDatestringNo—Date, or date and time (UTC)Start of the range.
endDatestringNo—Date, or date and time (UTC)End of the range.
importanceintegerNo—1 (low), 2 (medium), 3 (high)Returns only events of this importance.

Example

“When are inflation and GDP growth figures released in November 2026?”

JSON
{ "indicators": ["inflation rate", "gdp growth rate"], "startDate": "2026-11-01", "endDate": "2026-11-30" }
Example response
JSON
{
  "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

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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
groupstringYes—interest rate, inflation, bonds, consumer, gdp, government, housing, labour, markets, money, prices, trade, businessThe thematic group.
startDatestringNo—Date, or date and time (UTC)Start of the range.
endDatestringNo—Date, or date and time (UTC)End of the range.

Example

“Which labor market releases are scheduled between November 2 and November 6, 2026?”

JSON
{ "group": "labour", "startDate": "2026-11-02", "endDate": "2026-11-06" }
Example response
JSON
{
  "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, inflation and bonds are 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
tickersstring or string[]Yes—Trading Economics tickersFor example "IJCUSA" or ["IJCUSA", "SPAINFACORD"].
startDatestringNo—Date, or date and time (UTC)Start of the range.
endDatestringNo—Date, or date and time (UTC)End of the range.

Example

“When are the next US initial jobless claims released?”

JSON
{ "tickers": "IJCUSA" }
Example response
JSON
{
  "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 HistoricalDataSymbol field of get_indicator_data, or search.
  • 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.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringYes—Full country name, any letter caseFor example "united states". ISO codes are not supported.
indicatorstringYes—Indicator nameFor example "initial jobless claims".
startDatestringYes—Date, or date and time (UTC)Start of the range.
endDatestringYes—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.”

JSON
{
  "country": "united states",
  "indicator": "initial jobless claims",
  "startDate": "2016-12-01",
  "endDate": "2017-02-25"
}
Example response
JSON
{
  "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.