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 (
indicatorwithoutcountry). - 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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
ticker | string | Conditional | — | Trading Economics ticker, for example "USURTOT" | One series. Takes priority over country and indicator. Use the HistoricalDataSymbol field of a previous result. |
country | string or string[] | Conditional | — | Country names | One or more countries, for example "united states" or ["united states", "portugal"]. |
indicator | string or string[] | Conditional | — | Indicator names | One or more indicators, for example "gdp" or ["gdp", "inflation rate"]. |
group | string (enum) | No | — | gdp, labour, prices, money, trade, government, business, consumer, housing, taxes, health, climate, markets | One category group, in lowercase. |
Examples
“What is the current inflation rate in the United States?”
{ "country": "united states", "indicator": "inflation rate" }Example response
{
"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.”
{ "country": "canada", "group": "labour" }Example response
{
"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,countryorindicatoris required. - When
tickeris provided,countryandindicatorare ignored. grouprequirescountryand cannot be combined withtickerorindicator. The group appears in theCategoryGroupfield of the results, for example"Labour".- Pass
HistoricalDataSymbolas thetickerofget_historical_datato 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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
ticker | string | Conditional | — | Trading Economics ticker, for example "USURTOT" | One series. Takes priority over country and indicator. |
country | string or string[] | Conditional | — | Country names | One or more countries. |
indicator | string or string[] | Conditional | — | Indicator names | One or more indicators. Required with country. |
startDate | string | No | — | YYYY-MM-DD | Returns data from this date. |
endDate | string | No | — | YYYY-MM-DD | Returns 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.”
{
"country": ["portugal", "spain", "greece"],
"indicator": "inflation rate",
"startDate": "2015-01-01",
"endDate": "2023-12-31"
}Example response
{
"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.”
{ "ticker": "USURTOT", "startDate": "2010-01-01" }Example response
{
"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, orcountrytogether withindicator. - With
tickerand nostartDate, only a recent window of the series is returned, not its full history. AddstartDateto retrieve the history from that date.endDatehas no effect withticker. - 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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
ticker | string | Conditional | — | Trading Economics ticker, for example "CPI YOY" | The series whose peers you want. Takes priority over country and category. |
country | string | Conditional | — | One country name | For example "portugal". Lists are not accepted. |
category | string | Conditional | — | One indicator name | For example "inflation rate". Lists are not accepted. |
Example
“Which series are related to inflation in Portugal?”
{ "country": "portugal", "category": "inflation rate" }Example response
{
"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 bothcountryandcategory. Relationshipvalues: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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
country | string | No | — | One country name | Lists only the indicators available for this country. Lists are not accepted. |
calendar | integer | No | — | 1, 2 or 3 | Economic calendar filter. Use 1 to list only the indicators that appear in the economic calendar. |
Example
“Which US indicators appear in the economic calendar?”
{ "country": "united states", "calendar": 1 }Example response
{
"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.
countryandcalendarcan 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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
date | string | No | — | YYYY-MM-DD | Returns the updates made on or after this date. |
time | string | No | — | HH:mm (24-hour), for example "15:20" | Returns the updates made on or after this time of date. |
country | string | No | — | Country name | Returns the updates for this country. |
Example
“Which indicators were updated since 15:20 on October 20, 2026?”
{ "date": "2026-10-20", "time": "15:20" }Example response
{
"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
timerequiresdateand cannot be combined withcountry.- Without
country, only the updates of the last two months are available. - To retrieve the updated values, pass
HistoricalDataSymbolas thetickerofget_historical_dataorget_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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
country | string | No | — | Country name | For example "brazil". |
date | string | No | — | YYYY-MM-DD | Returns only the records updated on this date. |
Example
“Which Brazilian indicators were recently updated, and with what values?”
{ "country": "brazil" }Example response
{
"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
- For a lighter list without values, use
get_historical_updates.
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?”
{}Example response
{
"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
- For the updated records with their values, use
get_historical_latest.
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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
date | string | No | — | YYYY-MM-DD | Returns the changes from this date. |
Example
“Which indicator series have changed since September 1, 2026?”
{ "date": "2026-09-01" }Example response
{
"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.
| Parameter | Type | Required | Default | Allowed values / format | Description |
|---|---|---|---|---|---|
countries | string or string[] | No | — | Country names | One or more countries, for example "united states,china". Omit for all countries. |
Example
“Which US and Chinese indicators have been discontinued?”
{ "countries": "united states,china" }Example response
{
"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 thecountryparameter of the other indicator tools. - Without
countries, the discontinued series of all countries are returned.