Indicators

Trading Economics forecasts are built using a proprietary global macro model that takes into account our analysts’ expectations, correlations between countries, and a set of logical relationships between different indicators.

By country

Get forecast indicator data by country

/forecast/country/{country}

import tradingeconomics as te
te.login('your_api_key')

te.getForecastData(country='mexico')

const te = require('tradingeconomics');
te.login('your_api_key');

data = te.getForecasts(country = 'mexico').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/country/mexico?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
Auto ExportsMexico Auto Exports286.296/30/2023 12:00:00 AM269.00256.00272.00255.00256.00242.00232.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlyThousand UnitsMEXICOAUTEXP
Balance of TradeMexico Balance of Trade-74.095/31/2023 12:00:00 AM-713.001379.001104.00-2330.001379.001691.00407.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlyUSD MillionMXTBBAL
Banks Balance SheetMexico Banks Balance Sheet10335903.024/30/2023 12:00:00 AM1054727.001017672.001120617.001320617.001120617.001829452.002241232.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlyMXN MillionMEXICOBANBALSHE

/forecast/country/{countries}

te.getForecastData(country= ['mexico', 'sweden' ])

data = te.getForecasts(country = ['mexico','sweden']).then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/country/mexico,sweden?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
Auto ExportsMexico Auto Exports286.296/30/2023 12:00:00 AM269.00256.00272.00255.00256.00242.00232.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlyThousand UnitsMEXICOAUTEXP
Balance of TradeMexico Balance of Trade-74.095/31/2023 12:00:00 AM-713.001379.001104.00-2330.001379.001691.00407.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlyUSD MillionMXTBBAL
Balance of TradeSweden Balance of Trade-300.005/31/2023 12:00:00 AM-1700.00-2600.00900.004700.00-2600.00-2000.00-2800.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlySEK MillionSWTBAL

By indicator

Get forecast indicator data by indicator

/forecast/indicator/{indicator}

te.getForecastData(indicator= 'gdp')

data = te.getForecasts(indicator = 'gdp').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/indicator/gdp?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
GDPAfghanistan GDP14.5812/31/2021 12:00:00 AM14.0313.6614.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionAFGSTANGDP
GDPAlbania GDP18.8812/31/2022 12:00:00 AM19.3720.0520.659/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionALBANIAGDP
GDPAlgeria GDP191.9112/31/2022 12:00:00 AM198.24202.41207.269/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionAlgeria

/forecast/indicator/{indicators}

te.getForecastData(indicator= ['gdp', 'population'])

data = te.getForecasts(indicator = ['gdp','population']).then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/indicator/gdp,population?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
GDPAfghanistan GDP14.5812/31/2021 12:00:00 AM14.0313.6614.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionAFGSTANGDP
PopulationAfghanistan Population34.3012/31/2022 12:00:00 AM33.4032.8032.309/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyMillionAFGSTANPOPLATION
GDPAlbania GDP18.8812/31/2022 12:00:00 AM19.3720.0520.659/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionALBANIAGDP

By country and indicator

Get forecast indicator data by country and indicator

/forecast/country/{country}/indicator/{indicator}

te.getForecastData(country='mexico', indicator='gdp')

data = te.getForecasts(country = 'mexico', indicator = 'gdp').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/country/mexico/indicator/gdp?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
GDPMexico GDP1414.1912/31/2022 12:00:00 AM1450.001473.001499.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionWGDPMEXI

/forecast/country/{countries}/indicator/{indicators}

te.getForecastData(country= ['mexico','sweden'],
 indicator= ['gdp','population'])

data = te.getForecasts(country = ['mexico','sweden'],
 indicator = ['gdp','population']).then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/country/mexico,sweden/indicator/gdp,population?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
GDPMexico GDP1414.1912/31/2022 12:00:00 AM1450.001473.001499.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionWGDPMEXI
GDPSweden GDP585.9412/31/2022 12:00:00 AM583.60588.85604.169/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionWGDPSWED
PopulationMexico Population129.0012/31/2022 12:00:00 AM126.60126.80127.109/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyMillionMEX SP.POP.TOTL

By ticker

Get forecast indicator data by ticker

/forecast/ticker/{ticker}

te.getForecastByTicker(ticker= 'usurtot')

data = te.getForecasts(ticker = 'usurtot').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/ticker/usurtot?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
Unemployment RateUnited States Unemployment Rate3.606/30/2023 12:00:00 AM3.804.004.304.504.004.609/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlypercentUSURTOT

/forecast/ticker/{tickers}

te.getForecastByTicker(ticker= ['usurtot', 'wgdpchin'])

data = te.getForecasts(ticker = ['usurtot','wgdpchin']).then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/forecast/ticker/usurtot,wgdpchin?c=guest:guest");
CategoryTitleLatestValueLatestValueDateForecastValue1QForecastValue2QForecastValue3QForecastValue4QForecastValue1ForecastValue2ForecastValue3q1_dateq2_dateq3_dateq4_dateFrequencyUnitHistoricalDataSymbol
Unemployment RateUnited States Unemployment Rate3.606/30/2023 12:00:00 AM3.804.004.304.504.004.609/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMMonthlypercentUSURTOT
GDPChina GDP17963.1712/31/2022 12:00:00 AM18879.0020012.0021253.009/30/2023 12:00:00 AM12/31/2023 12:00:00 AM3/31/2024 12:00:00 AM6/30/2024 12:00:00 AMYearlyUSD BillionWGDPCHIN

Response fields

FieldTypeDescriptionExample
Country*stringCountry name“Mexico”
CategorystringName of the indicator“Auto Exports”
TitlestringCombination of country and indicator name“Mexico Auto Exports”
LatestValuenumberLast released value272.69
LatestValueDatestringDate of the last released value“2023-03-31T00:00:00”
ForecastValue1Q**numberForecast value for the next quarter257.00
ForecastValue2Q**numberForecast value for the quarter following ForecastValue1Q250.00
ForecastValue3Q**numberForecast value for the quarter following ForecastValue2Q239.00
ForecastValue4Q**numberForecast value for the quarter following ForecastValue3Q274.00
ForecastValue1**numberForecast value for the year end239.00
ForecastValue2**numberForecast value for the year end following ForecastValue1242.00
ForecastValue3**numberForecast value for the year end following ForecastValue2232.00
q1_datestringDate for ForecastValue1Q“2023-06-30T00:00:00”
q2_datestringDate for ForecastValue2Q“2023-09-30T00:00:00”
q3_datestringDate for ForecastValue3Q“2023-12-31T00:00:00”
q4_datestringDate for ForecastValue4Q“2024-03-31T00:00:00”
FrequencystringFrequency of the indicator“Monthly”
UnitstringUnit of the forecasted values“Thousand Units”
HistoricalDataSymbolstringUnique symbol used by Trading Economics“MEXICOAUTEXP”

*Country only appears in the packages or when using ‘&f=json’ on endpoints.

**Forecast response fields can be diferent from HTML response fields:

Python/NodeHTML
yearendForecastValue1
yearend2ForecastValue2
yearend3ForecastValue3
q1ForecastValue1Q
q2ForecastValue2Q
q3ForecastValue3Q
q4ForecastValue4Q