Skip to content
Docs
Get API key
Tools

Economic Indicator Tools

Latest values, historical time series, related series, and the updates and revisions of economic indicators.

get_indicator_data

Latest values of economic indicators.

Returns the latest snapshot of economic indicators in one of three modes, selected by the parameters provided:

  • Ticker mode: one series, by its Trading Economics ticker.
  • All-countries mode: one or more indicators across every country (indicator without country).
  • Country mode: one or more countries, optionally narrowed to specific indicators (indicator) or to one category group (group). Without a filter, every indicator of those countries is returned, which produces a large response.
ParameterTypeRequiredDefaultAllowed values / formatDescription
tickerstringConditional—Trading Economics ticker, for example "USURTOT"One series. Takes priority over country and indicator. Use the HistoricalDataSymbol field of a previous result.
countrystring or string[]Conditional—Country namesOne or more countries, for example "united states" or ["united states", "portugal"].
indicatorstring or string[]Conditional—Indicator namesOne or more indicators, for example "gdp" or ["gdp", "inflation rate"].
groupstring (enum)No—gdp, labour, prices, money, trade, government, business, consumer, housing, taxes, health, climate, marketsOne category group, in lowercase.

Examples

“What is the current inflation rate in the United States?”

JSON
{ "country": "united states", "indicator": "inflation rate" }
Example response
JSON
{
  "columns": ["Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate", "HighestValue", "HighestValueDate", "LowestValue", "LowestValueDate"],
  "rows": [
    ["United States", "Inflation Rate", "United States Inflation Rate", "2026-09-30T00:00:00", 3.7, "U.S. Bureau of Labor Statistics", "http://www.bls.gov/", "percent", "/united-states/inflation-cpi", "Prices", "NSA", "Monthly", "CPI YOY", "2011-06-27T00:00:00", "1914-12-31T00:00:00", 3.4, "2026-08-31T00:00:00", 23.7, "1920-06-30T00:00:00", -15.8, "1921-06-30T00:00:00"]
  ]
}

Retrieved on October 26, 2026; complete response. Values change over time.

“Give me a labor market snapshot for Canada.”

JSON
{ "country": "canada", "group": "labour" }
Example response
JSON
{
  "columns": ["Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate", "HighestValue", "HighestValueDate", "LowestValue", "LowestValueDate"],
  "rows": [
    ["Canada", "Employment Change", "Canada Employment Change", "2026-09-30T00:00:00", -68.3, "Statistics Canada", "https://www.statcan.gc.ca", "Thousand", "/canada/employment-change", "Labour", "Volume, SA", "Monthly", "CANADAEMPCHA", "2014-03-07T14:04:00", "1976-02-29T00:00:00", -41.7, "2026-08-31T00:00:00", 1035.8, "2020-06-30T00:00:00", -1991.4, "2020-04-30T00:00:00"],
    ["Canada", "Unemployment Rate", "Canada Unemployment Rate", "2026-09-30T00:00:00", 6.5, "Statistics Canada", "http://www.statcan.gc.ca", "percent", "/canada/unemployment-rate", "Labour", "SA", "Monthly", "CANLXEMR", "2012-11-21T12:03:00", "1966-01-31T00:00:00", 6.4, "2026-08-31T00:00:00", 14.2, "2020-05-31T00:00:00", 2.9, "1966-06-30T00:00:00"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 24 rows. Values change over time.

Returns

Country, Category, Title, LatestValue, LatestValueDate, PreviousValue, PreviousValueDate, Unit, Frequency, HistoricalDataSymbol, Source, SourceURL, URL, CategoryGroup, Adjustment, CreateDate, FirstValueDate, HighestValue, HighestValueDate, LowestValue, LowestValueDate.

Notes

  • At least one of ticker, country or indicator is required.
  • When ticker is provided, country and indicator are ignored.
  • group requires country and cannot be combined with ticker or indicator. The group appears in the CategoryGroup field of the results, for example "Labour".
  • Pass HistoricalDataSymbol as the ticker of get_historical_data to retrieve the history of a series.

get_historical_data

Historical time series of economic indicators.

Returns the history of one series by ticker, or of one or more indicators for one or more countries.

ParameterTypeRequiredDefaultAllowed values / formatDescription
tickerstringConditional—Trading Economics ticker, for example "USURTOT"One series. Takes priority over country and indicator.
countrystring or string[]Conditional—Country namesOne or more countries.
indicatorstring or string[]Conditional—Indicator namesOne or more indicators. Required with country.
startDatestringNo—YYYY-MM-DDReturns data from this date.
endDatestringNo—YYYY-MM-DDReturns data up to this date. Requires startDate. Applies only with country and indicator.

Examples

“Show inflation in Portugal, Spain and Greece from 2015 to 2023.”

JSON
{
  "country": ["portugal", "spain", "greece"],
  "indicator": "inflation rate",
  "startDate": "2015-01-01",
  "endDate": "2023-12-31"
}
Example response
JSON
{
  "columns": ["Country", "Category", "DateTime", "Value", "Frequency", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Greece", "Inflation Rate", "2015-01-31T00:00:00", -2.8, "Monthly", "GKCPNEWY", "2015-02-17T10:12:00"],
    ["Portugal", "Inflation Rate", "2015-01-31T00:00:00", -0.39, "Monthly", "PLCPYOY", "2026-07-10T10:13:00"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 324 rows. Values change over time.

“Show the US unemployment rate series since 2010.”

JSON
{ "ticker": "USURTOT", "startDate": "2010-01-01" }
Example response
JSON
{
  "columns": ["Country", "Category", "DateTime", "Value", "Frequency", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["United States", "Unemployment Rate", "2010-01-31T00:00:00", 9.8, "Monthly", "USURTOT", "2017-04-07T13:29:00"],
    ["United States", "Unemployment Rate", "2010-02-28T00:00:00", 9.8, "Monthly", "USURTOT", "2012-02-23T11:41:00"]
  ]
}

Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.

Returns

Country, Category, DateTime, Value, Frequency, HistoricalDataSymbol, LastUpdate.

Notes

  • Provide either ticker, or country together with indicator.
  • With ticker and no startDate, only a recent window of the series is returned, not its full history. Add startDate to retrieve the history from that date. endDate has no effect with ticker.
  • Long country lists are split automatically into requests of up to 10 countries, and each request counts toward your API usage.
  • Each request returns up to 10,000 rows.

get_indicator_peers

Series related to an indicator.

Returns the series related to a given indicator: related, component, parent, derivative and underlying series. Query by ticker, or by one country and one indicator category.

ParameterTypeRequiredDefaultAllowed values / formatDescription
tickerstringConditional—Trading Economics ticker, for example "CPI YOY"The series whose peers you want. Takes priority over country and category.
countrystringConditional—One country nameFor example "portugal". Lists are not accepted.
categorystringConditional—One indicator nameFor example "inflation rate". Lists are not accepted.

Example

“Which series are related to inflation in Portugal?”

JSON
{ "country": "portugal", "category": "inflation rate" }
Example response
JSON
{
  "columns": ["Ticker", "Peer", "Relationship", "Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate"],
  "rows": [
    ["PLCPYOY", "PORTUGALCORINFRAT", 0, "Portugal", "Core Inflation Rate", "Portugal Core Inflation Rate", "2026-09-30T00:00:00", 2.72, "Statistics Portugal", "http://www.ine.pt", "percent", "/portugal/core-inflation-rate", "Prices", "NSA", "Monthly", "PORTUGALCORINFRAT", "2014-08-12T11:26:00", "1949-01-31T00:00:00", 2.64, "2026-08-31T00:00:00"],
    ["PLCPYOY", "PRTENEINF", 1, "Portugal", "Energy Inflation", "Portugal Energy Inflation", "2026-09-30T00:00:00", 15.39, "Statistics Portugal", "http://www.ine.pt", "percent", "/portugal/energy-inflation", "Prices", "NSA", "Monthly", "PRTENEINF", "2026-07-10T10:25:00", "1949-01-31T00:00:00", 12.2, "2026-08-31T00:00:00"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 14 rows. Values change over time.

Returns

Ticker, Peer, Relationship, Country, Category, Title, LatestValue, LatestValueDate, PreviousValue, PreviousValueDate, Unit, Frequency, HistoricalDataSymbol, Source, SourceURL, URL, CategoryGroup, Adjustment, CreateDate, FirstValueDate.

Notes

  • Provide either ticker, or both country and category.
  • Relationship values: 0 = related, 1 = component, 2 = parent, 3 = derivative, 4 = underlying.

get_indicators_list

Catalog of available indicators.

Returns the economic indicators available from Trading Economics, with their category group. Use it to discover valid indicator names.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringNo—One country nameLists only the indicators available for this country. Lists are not accepted.
calendarintegerNo—1, 2 or 3Economic calendar filter. Use 1 to list only the indicators that appear in the economic calendar.

Example

“Which US indicators appear in the economic calendar?”

JSON
{ "country": "united states", "calendar": 1 }
Example response
JSON
{
  "columns": ["Category", "CategoryGroup"],
  "rows": [
    ["10 Year TIPS Yield", "Bonds"],
    ["15 Year Mortgage Rate", "Housing"]
  ]
}

Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.

Returns

Category and CategoryGroup for each indicator.

Notes

  • Without parameters, the complete catalog is returned. country and calendar can be combined.

get_indicator_updates

Which indicator series were updated, and when.

Returns the latest updates, additions and revisions applied to economic indicator series, without their values. Filter by country, by date (optionally from a time of day), or by country and date.

ParameterTypeRequiredDefaultAllowed values / formatDescription
datestringNo—YYYY-MM-DDReturns the updates made on or after this date.
timestringNo—HH:mm (24-hour), for example "15:20"Returns the updates made on or after this time of date.
countrystringNo—Country nameReturns the updates for this country.

Example

“Which indicators were updated since 15:20 on October 20, 2026?”

JSON
{ "date": "2026-10-20", "time": "15:20" }
Example response
JSON
{
  "columns": ["Country", "Category", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Bosnia and Herzegovina", "Average Weekly Hours", "BIHAVGWEEKLYHOURS", "2026-10-26T14:24:15.873"],
    ["United States", "Banks Balance Sheet", "UNITEDSTABANBALSHE", "2026-10-26T14:20:45.903"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 1,544 rows. Values change over time.

Returns

Country, Category, HistoricalDataSymbol, LastUpdate (UTC).

Notes

  • time requires date and cannot be combined with country.
  • Without country, only the updates of the last two months are available.
  • To retrieve the updated values, pass HistoricalDataSymbol as the ticker of get_historical_data or get_indicator_data.

get_historical_latest

Recently updated or revised records, with their values.

Returns the historical records of economic indicators that were recently updated or revised. Optionally filter by country, by date, or both.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countrystringNo—Country nameFor example "brazil".
datestringNo—YYYY-MM-DDReturns only the records updated on this date.

Example

“Which Brazilian indicators were recently updated, and with what values?”

JSON
{ "country": "brazil" }
Example response
JSON
{
  "columns": ["Country", "Category", "DateTime", "Value", "Frequency", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Brazil", "Remittances", "2026-09-30T00:00:00", 335.9, "Monthly", "BrazilRem", "2026-10-26T13:01:00"],
    ["Brazil", "Current Account to GDP", "2025-12-31T00:00:00", -2.96, "Yearly", "BRACA2GDP", "2026-10-26T12:59:00"]
  ]
}

Retrieved on October 26, 2026; truncated to the first 2 rows. Values change over time.

Returns

Country, Category, DateTime, Value, Frequency, HistoricalDataSymbol, LastUpdate.

Notes

get_historical_updates

Lightweight list of recently updated series.

Returns the indicator series that were recently updated, without their values.

This tool takes no parameters.

Example

“Which indicator series were updated recently?”

JSON
{}
Example response
JSON
{
  "columns": ["Country", "Category", "HistoricalDataSymbol", "LastUpdate"],
  "rows": [
    ["Bosnia and Herzegovina", "Average Weekly Hours", "BIHAVGWEEKLYHOURS", "2026-10-26T14:24:00"],
    ["United States", "Banks Balance Sheet", "UNITEDSTABANBALSHE", "2026-10-26T14:20:00"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 1,000 rows. Values change over time.

Returns

Country, Category, HistoricalDataSymbol, LastUpdate.

Notes

get_indicator_changes

Indicators whose data series changed, with the reason.

Returns economic indicators whose data series recently changed, together with the reason for each change.

ParameterTypeRequiredDefaultAllowed values / formatDescription
datestringNo—YYYY-MM-DDReturns the changes from this date.

Example

“Which indicator series have changed since September 1, 2026?”

JSON
{ "date": "2026-09-01" }
Example response
JSON
{
  "columns": ["Country", "Category", "Ticker", "Reason", "Date"],
  "rows": [
    ["Bolivia", "Foreign Exchange Reserves", "BOLIVIAFOREXCRES", "Replacement", "2026-10-16T08:43:36.67"],
    ["Poland", "Labor Force Participation Rate", "POLANDLFPR", "Other", "2026-10-14T04:02:56.783"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 rows. Values change over time.

Returns

Country, Category, Ticker, Reason and Date for each change. Reason is a short label, for example "Base year", "Frequency", "Unit", "Replacement", "Discontinued" or "Other". Ticker can be empty.

Notes

  • Without date, the most recent changes are returned.

get_discontinued_indicators

Series no longer updated by their source.

Returns data series that have been discontinued, that is, series that the official source no longer updates.

ParameterTypeRequiredDefaultAllowed values / formatDescription
countriesstring or string[]No—Country namesOne or more countries, for example "united states,china". Omit for all countries.

Example

“Which US and Chinese indicators have been discontinued?”

JSON
{ "countries": "united states,china" }
Example response
JSON
{
  "columns": ["Country", "Category", "Title", "LatestValueDate", "LatestValue", "Source", "SourceURL", "Unit", "URL", "CategoryGroup", "Adjustment", "Frequency", "HistoricalDataSymbol", "CreateDate", "FirstValueDate", "PreviousValue", "PreviousValueDate", "HighestValue", "HighestValueDate", "LowestValue", "LowestValueDate"],
  "rows": [
    ["China", "1 Year MLF Rate", "China One-Year Medium-Term Lending Facility Rate", "2025-02-25T00:00:00", 2, "People's Bank of China", "http://www.pbc.gov.cn/", "percent", "/china/1-year-mlf-rate", "Money", "", "Monthly", "CHN1YMR", "2023-02-15T15:22:00", "2016-01-19T00:00:00", 2, "2025-01-24T00:00:00", 3.3, "2018-04-17T00:00:00", 2, "2024-09-25T00:00:00"],
    ["China", "Competitiveness Index", "China Competitiveness Index", "2019-12-31T00:00:00", 73.9, "World Economic Forum", "https://www.weforum.org", "Points", "/china/competitiveness-index", "Business", "", "Yearly", "ChinaComInd", "2015-06-12T17:19:00", "2007-12-31T00:00:00", 72.61, "2018-12-31T00:00:00", 73.9, "2019-12-31T00:00:00", 4.55, "2007-12-31T00:00:00"]
  ]
}

Retrieved on October 26, 2026; truncated to 2 of 1,201 rows. Values change over time.

Returns

The same fields as get_indicator_data, for each discontinued series. LatestValueDate is the date of the last observation.

Notes

  • The parameter is named countries (plural), unlike the country parameter of the other indicator tools.
  • Without countries, the discontinued series of all countries are returned.