Forecast
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
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/forecast/country/mexico,sweden?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
import tradingeconomics as te
te.login('your_api_key')
te.getForecastData(country='mexico')
With multi countries:
te.getForecastData(country= ['mexico', 'sweden' ])
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/forecast/country/mexico,sweden?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getForecasts(country = 'mexico').then(function(data){
console.log(data)
});
With multi countries:
data = te.getForecasts(country = ['mexico','sweden']).then(function(data){
console.log(data)
});
Using Requests:
using (var httpClient = new HttpClient())
{
using (var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/country/mexico?c=guest:guest"))
{
request.Headers.TryAddWithoutValidation("Upgrade-Insecure-Requests", "1");
var response = await httpClient.SendAsync(request);
if (response.IsSuccessStatusCode)
{
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
}
With multi countries:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/country/mexico,sweden?c=guest:guest");
The response data format can be configured by appending the &f= parameter to the URL request.
Category | Title | LatestValue | LatestValueDate | ForecastValue1Q | ForecastValue2Q | ForecastValue3Q | ForecastValue4Q | ForecastValue1 | ForecastValue2 | ForecastValue3 | q1_date | q2_date | q3_date | q4_date | Frequency | Unit | HistoricalDataSymbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Auto Exports | Mexico Auto Exports | 286.29 | 6/30/2023 12:00:00 AM | 269.00 | 256.00 | 272.00 | 255.00 | 256.00 | 242.00 | 232.00 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Monthly | Thousand Units | MEXICOAUTEXP |
Balance of Trade | Mexico Balance of Trade | -74.09 | 5/31/2023 12:00:00 AM | -713.00 | 1379.00 | 1104.00 | -2330.00 | 1379.00 | 1691.00 | 407.00 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Monthly | USD Million | MXTBBAL |
Balance of Trade | Sweden Balance of Trade | -300.00 | 5/31/2023 12:00:00 AM | -1700.00 | -2600.00 | 900.00 | 4700.00 | -2600.00 | -2000.00 | -2800.00 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Monthly | SEK Million | SWTBAL |
/forecast/country/{countries}?f=json
[{"Country":"Mexico","Category":"Auto Exports","Title":"Mexico Auto Exports","LatestValue":301.34,"LatestValueDate":"2023-09-30T00:00:00","q1":256.00,"q2":272.00,"q3":255.00,"q4":245.00,"YearEnd":256.00,"YearEnd2":242.00,"YearEnd3":232.00,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Monthly","Unit":"Thousand Units","HistoricalDataSymbol":"MEXICOAUTEXP"},{"Country":"Mexico","Category":"Balance of Trade","Title":"Mexico Balance of Trade","LatestValue":-1377.09,"LatestValueDate":"2023-08-31T00:00:00","q1":1379.00,"q2":1104.00,"q3":-2330.00,"q4":-2330.00,"YearEnd":1379.00,"YearEnd2":1691.00,"YearEnd3":407.00,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Monthly","Unit":"USD Million","HistoricalDataSymbol":"MXTBBAL"},{"Country":"Sweden","Category":"Balance of Trade","Title":"Sweden Balance of Trade","LatestValue":-8400.00,"LatestValueDate":"2023-08-31T00:00:00","q1":-2600.00,"q2":5900.00,"q3":14700.00,"q4":5300.00,"YearEnd":-2600.00,"YearEnd2":-2000.00,"YearEnd3":-2800.00,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Monthly","Unit":"SEK Million","HistoricalDataSymbol":"SWTBAL"}]
/forecast/country/{countries}?f=csv
Category,Title,LatestValue,LatestValueDate,ForecastValue1Q,ForecastValue2Q,ForecastValue3Q,ForecastValue4Q,ForecastValue1,ForecastValue2,ForecastValue3,q1_date,q2_date,q3_date,q4_date,Frequency,Unit,HistoricalDataSymbol
Auto Exports,Mexico Auto Exports,301.34,9/30/2023 12:00:00 AM,256.00,272.00,255.00,245.00,256.00,242.00,232.00,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Monthly,Thousand Units,MEXICOAUTEXP
Balance of Trade,Mexico Balance of Trade,-1377.09,8/31/2023 12:00:00 AM,1379.00,1104.00,-2330.00,-2330.00,1379.00,1691.00,407.00,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Monthly,USD Million,MXTBBAL
Balance of Trade,Sweden Balance of Trade,-8400.00,8/31/2023 12:00:00 AM,-2600.00,5900.00,14700.00,5300.00,-2600.00,-2000.00,-2800.00,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Monthly,SEK Million,SWTBAL
/forecast/country/{countries}?f=xml
<ArrayOfForecastItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<ForecastItem>
<Category>Auto Exports</Category>
<Country>Mexico</Country>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>MEXICOAUTEXP</HistoricalDataSymbol>
<LatestValue>301.34</LatestValue>
<LatestValueDate>2023-09-30T00:00:00</LatestValueDate>
<Title>Mexico Auto Exports</Title>
<Unit>Thousand Units</Unit>
<YearEnd>256.00</YearEnd>
<YearEnd2>242.00</YearEnd2>
<YearEnd3>232.00</YearEnd3>
<q1>256.00</q1>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2>272.00</q2>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3>255.00</q3>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4>245.00</q4>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>Balance of Trade</Category>
<Country>Mexico</Country>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>MXTBBAL</HistoricalDataSymbol>
<LatestValue>-1377.09</LatestValue>
<LatestValueDate>2023-08-31T00:00:00</LatestValueDate>
<Title>Mexico Balance of Trade</Title>
<Unit>USD Million</Unit>
<YearEnd>1379.00</YearEnd>
<YearEnd2>1691.00</YearEnd2>
<YearEnd3>407.00</YearEnd3>
<q1>1379.00</q1>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2>1104.00</q2>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3>-2330.00</q3>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4>-2330.00</q4>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>Balance of Trade</Category>
<Country>Sweden</Country>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>SWTBAL</HistoricalDataSymbol>
<LatestValue>-8400.00</LatestValue>
<LatestValueDate>2023-08-31T00:00:00</LatestValueDate>
<Title>Sweden Balance of Trade</Title>
<Unit>SEK Million</Unit>
<YearEnd>-2600.00</YearEnd>
<YearEnd2>-2000.00</YearEnd2>
<YearEnd3>-2800.00</YearEnd3>
<q1>-2600.00</q1>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2>5900.00</q2>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3>14700.00</q3>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4>5300.00</q4>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
</ArrayOfForecastItem>
By indicator
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/forecast/indicator/gdp,population?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
te.getForecastData(indicator= 'gdp')
With multi indicators:
te.getForecastData(indicator= ['gdp', 'population'])
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/forecast/indicator/gdp,population?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
data = te.getForecasts(indicator = 'gdp').then(function(data){
console.log(data)
});
With multi indicators:
data = te.getForecasts(indicator = ['gdp','population']).then(function(data){
console.log(data)
});
Using Requests:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/indicator/gdp?c=guest:guest");
With multi indicators:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/indicator/gdp,population?c=guest:guest");
/forecast/indicator/{indicators}
Category | Title | LatestValue | LatestValueDate | ForecastValue1Q | ForecastValue2Q | ForecastValue3Q | ForecastValue4Q | ForecastValue1 | ForecastValue2 | ForecastValue3 | q1_date | q2_date | q3_date | q4_date | Frequency | Unit | HistoricalDataSymbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
GDP | Afghanistan GDP | 14.58 | 12/31/2021 12:00:00 AM | 14.03 | 13.66 | 14.00 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | USD Billion | AFGSTANGDP | ||||
Population | Afghanistan Population | 34.30 | 12/31/2022 12:00:00 AM | 33.40 | 32.80 | 32.30 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | Million | AFGSTANPOPLATION | ||||
GDP | Albania GDP | 18.88 | 12/31/2022 12:00:00 AM | 19.37 | 20.05 | 20.65 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | USD Billion | ALBANIAGDP |
/forecast/indicator/{indicators}?f=json
[{"Country":"Afghanistan","Category":"GDP","Title":"Afghanistan GDP","LatestValue":14.58,"LatestValueDate":"2021-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":14.03,"YearEnd2":13.66,"YearEnd3":14.00,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"USD Billion","HistoricalDataSymbol":"AFGSTANGDP"},{"Country":"Afghanistan","Category":"Population","Title":"Afghanistan Population","LatestValue":34.30,"LatestValueDate":"2022-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":33.40,"YearEnd2":32.80,"YearEnd3":32.30,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"Million","HistoricalDataSymbol":"AFGSTANPOPLATION"},{"Country":"Albania","Category":"GDP","Title":"Albania GDP","LatestValue":18.88,"LatestValueDate":"2022-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":19.37,"YearEnd2":19.99,"YearEnd3":20.59,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"USD Billion","HistoricalDataSymbol":"ALBANIAGDP"}]
/forecast/indicator/{indicators}?f=csv
Category,Title,LatestValue,LatestValueDate,ForecastValue1Q,ForecastValue2Q,ForecastValue3Q,ForecastValue4Q,ForecastValue1,ForecastValue2,ForecastValue3,q1_date,q2_date,q3_date,q4_date,Frequency,Unit,HistoricalDataSymbol
GDP,Afghanistan GDP,14.58,12/31/2021 12:00:00 AM,,,,,14.03,13.66,14.00,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,USD Billion,AFGSTANGDP
Population,Afghanistan Population,34.30,12/31/2022 12:00:00 AM,,,,,33.40,32.80,32.30,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,Million,AFGSTANPOPLATION
GDP,Albania GDP,18.88,12/31/2022 12:00:00 AM,,,,,19.37,19.99,20.59,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,USD Billion,ALBANIAGDP
/forecast/indicator/{indicators}?f=xml
<ArrayOfForecastItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<ForecastItem>
<Category>GDP</Category>
<Country>Afghanistan</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>AFGSTANGDP</HistoricalDataSymbol>
<LatestValue>14.58</LatestValue>
<LatestValueDate>2021-12-31T00:00:00</LatestValueDate>
<Title>Afghanistan GDP</Title>
<Unit>USD Billion</Unit>
<YearEnd>14.03</YearEnd>
<YearEnd2>13.66</YearEnd2>
<YearEnd3>14.00</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>Population</Category>
<Country>Afghanistan</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>AFGSTANPOPLATION</HistoricalDataSymbol>
<LatestValue>34.30</LatestValue>
<LatestValueDate>2022-12-31T00:00:00</LatestValueDate>
<Title>Afghanistan Population</Title>
<Unit>Million</Unit>
<YearEnd>33.40</YearEnd>
<YearEnd2>32.80</YearEnd2>
<YearEnd3>32.30</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>GDP</Category>
<Country>Albania</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>ALBANIAGDP</HistoricalDataSymbol>
<LatestValue>18.88</LatestValue>
<LatestValueDate>2022-12-31T00:00:00</LatestValueDate>
<Title>Albania GDP</Title>
<Unit>USD Billion</Unit>
<YearEnd>19.37</YearEnd>
<YearEnd2>19.99</YearEnd2>
<YearEnd3>20.59</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
</ArrayOfForecastItem>
By country and indicator
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/forecast/country/mexico,sweden/indicator/gdp,population?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
te.getForecastData(country= ['mexico','sweden'],
indicator= ['gdp','population'])
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/forecast/country/mexico,sweden/indicator/gdp,population?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
data = te.getForecasts(country = ['mexico','sweden'],
indicator = ['gdp','population']).then(function(data){
console.log(data)
});
Using Requests:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/country/mexico,sweden/indicator/gdp,population?c=guest:guest");
/forecast/country/{countries}/indicator/{indicators}
Category | Title | LatestValue | LatestValueDate | ForecastValue1Q | ForecastValue2Q | ForecastValue3Q | ForecastValue4Q | ForecastValue1 | ForecastValue2 | ForecastValue3 | q1_date | q2_date | q3_date | q4_date | Frequency | Unit | HistoricalDataSymbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
GDP | Mexico GDP | 1414.19 | 12/31/2022 12:00:00 AM | 1450.00 | 1473.00 | 1499.00 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | USD Billion | WGDPMEXI | ||||
GDP | Sweden GDP | 585.94 | 12/31/2022 12:00:00 AM | 583.60 | 588.85 | 604.16 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | USD Billion | WGDPSWED | ||||
Population | Mexico Population | 129.00 | 12/31/2022 12:00:00 AM | 126.60 | 126.80 | 127.10 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | Million | MEX SP.POP.TOTL |
/forecast/country/{countries}/indicator/{indicators}?f=json
[{"Country":"Mexico","Category":"GDP","Title":"Mexico GDP","LatestValue":1414.19,"LatestValueDate":"2022-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":1447.00,"YearEnd2":1470.00,"YearEnd3":1496.00,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"USD Billion","HistoricalDataSymbol":"WGDPMEXI"},{"Country":"Sweden","Category":"GDP","Title":"Sweden GDP","LatestValue":585.94,"LatestValueDate":"2022-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":581.84,"YearEnd2":581.26,"YearEnd3":592.30,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"USD Billion","HistoricalDataSymbol":"WGDPSWED"},{"Country":"Mexico","Category":"Population","Title":"Mexico Population","LatestValue":129.00,"LatestValueDate":"2022-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":126.60,"YearEnd2":126.80,"YearEnd3":127.10,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"Million","HistoricalDataSymbol":"MEX SP.POP.TOTL"}]
/forecast/country/{countries}/indicator/{indicators}?f=csv
Category,Title,LatestValue,LatestValueDate,ForecastValue1Q,ForecastValue2Q,ForecastValue3Q,ForecastValue4Q,ForecastValue1,ForecastValue2,ForecastValue3,q1_date,q2_date,q3_date,q4_date,Frequency,Unit,HistoricalDataSymbol
GDP,Mexico GDP,1414.19,12/31/2022 12:00:00 AM,,,,,1447.00,1470.00,1496.00,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,USD Billion,WGDPMEXI
GDP,Sweden GDP,585.94,12/31/2022 12:00:00 AM,,,,,581.84,581.26,592.30,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,USD Billion,WGDPSWED
Population,Mexico Population,129.00,12/31/2022 12:00:00 AM,,,,,126.60,126.80,127.10,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,Million,MEX SP.POP.TOTL
/forecast/country/{countries}/indicator/{indicators}?f=xml
<ArrayOfForecastItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<ForecastItem>
<Category>GDP</Category>
<Country>Mexico</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPMEXI</HistoricalDataSymbol>
<LatestValue>1414.19</LatestValue>
<LatestValueDate>2022-12-31T00:00:00</LatestValueDate>
<Title>Mexico GDP</Title>
<Unit>USD Billion</Unit>
<YearEnd>1447.00</YearEnd>
<YearEnd2>1470.00</YearEnd2>
<YearEnd3>1496.00</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>GDP</Category>
<Country>Sweden</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPSWED</HistoricalDataSymbol>
<LatestValue>585.94</LatestValue>
<LatestValueDate>2022-12-31T00:00:00</LatestValueDate>
<Title>Sweden GDP</Title>
<Unit>USD Billion</Unit>
<YearEnd>581.84</YearEnd>
<YearEnd2>581.26</YearEnd2>
<YearEnd3>592.30</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>Population</Category>
<Country>Mexico</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>MEX SP.POP.TOTL</HistoricalDataSymbol>
<LatestValue>129.00</LatestValue>
<LatestValueDate>2022-12-31T00:00:00</LatestValueDate>
<Title>Mexico Population</Title>
<Unit>Million</Unit>
<YearEnd>126.60</YearEnd>
<YearEnd2>126.80</YearEnd2>
<YearEnd3>127.10</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
</ArrayOfForecastItem>
By ticker
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/forecast/ticker/usurtot,wgdpchin?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
te.getForecastByTicker(ticker= 'usurtot')
With multi tickers:
te.getForecastByTicker(ticker= ['usurtot', 'wgdpchin'])
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/forecast/ticker/usurtot,wgdpchin?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
data = te.getForecasts(ticker = 'usurtot').then(function(data){
console.log(data)
});
With multi tickers:
data = te.getForecasts(ticker = ['usurtot','wgdpchin']).then(function(data){
console.log(data)
});
Using Requests:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/ticker/usurtot?c=guest:guest");
With multi tickers:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/forecast/ticker/usurtot,wgdpchin?c=guest:guest");
Category | Title | LatestValue | LatestValueDate | ForecastValue1Q | ForecastValue2Q | ForecastValue3Q | ForecastValue4Q | ForecastValue1 | ForecastValue2 | ForecastValue3 | q1_date | q2_date | q3_date | q4_date | Frequency | Unit | HistoricalDataSymbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Unemployment Rate | United States Unemployment Rate | 3.60 | 6/30/2023 12:00:00 AM | 3.80 | 4.00 | 4.30 | 4.50 | 4.00 | 4.60 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Monthly | percent | USURTOT | |
GDP | China GDP | 17963.17 | 12/31/2022 12:00:00 AM | 18879.00 | 20012.00 | 21253.00 | 9/30/2023 12:00:00 AM | 12/31/2023 12:00:00 AM | 3/31/2024 12:00:00 AM | 6/30/2024 12:00:00 AM | Yearly | USD Billion | WGDPCHIN |
/forecast/ticker/{tickers}?f=json
[{"Country":"United States","Category":"Unemployment Rate","Title":"United States Unemployment Rate","LatestValue":3.80,"LatestValueDate":"2023-09-30T00:00:00","q1":4.00,"q2":4.30,"q3":4.50,"q4":4.50,"YearEnd":4.00,"YearEnd2":4.60,"YearEnd3":null,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Monthly","Unit":"percent","HistoricalDataSymbol":"USURTOT"},{"Country":"China","Category":"GDP","Title":"China GDP","LatestValue":17963.17,"LatestValueDate":"2022-12-31T00:00:00","q1":null,"q2":null,"q3":null,"q4":null,"YearEnd":18772.00,"YearEnd2":19616.00,"YearEnd3":20636.00,"q1_date":"2023-12-31T00:00:00","q2_date":"2024-03-31T00:00:00","q3_date":"2024-06-30T00:00:00","q4_date":"2024-09-30T00:00:00","Frequency":"Yearly","Unit":"USD Billion","HistoricalDataSymbol":"WGDPCHIN"}]
/forecast/ticker/{tickers}?f=csv
Category,Title,LatestValue,LatestValueDate,ForecastValue1Q,ForecastValue2Q,ForecastValue3Q,ForecastValue4Q,ForecastValue1,ForecastValue2,ForecastValue3,q1_date,q2_date,q3_date,q4_date,Frequency,Unit,HistoricalDataSymbol
Unemployment Rate,United States Unemployment Rate,3.80,9/30/2023 12:00:00 AM,4.00,4.30,4.50,4.50,4.00,4.60,,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Monthly,percent,USURTOT
GDP,China GDP,17963.17,12/31/2022 12:00:00 AM,,,,,18772.00,19616.00,20636.00,12/31/2023 12:00:00 AM,3/31/2024 12:00:00 AM,6/30/2024 12:00:00 AM,9/30/2024 12:00:00 AM,Yearly,USD Billion,WGDPCHIN
/forecast/ticker/{tickers}?f=xml
<ArrayOfForecastItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<ForecastItem>
<Category>Unemployment Rate</Category>
<Country>United States</Country>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>USURTOT</HistoricalDataSymbol>
<LatestValue>3.80</LatestValue>
<LatestValueDate>2023-09-30T00:00:00</LatestValueDate>
<Title>United States Unemployment Rate</Title>
<Unit>percent</Unit>
<YearEnd>4.00</YearEnd>
<YearEnd2>4.60</YearEnd2>
<YearEnd3 i:nil="true"/>
<q1>4.00</q1>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2>4.30</q2>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3>4.50</q3>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4>4.50</q4>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
<ForecastItem>
<Category>GDP</Category>
<Country>China</Country>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPCHIN</HistoricalDataSymbol>
<LatestValue>17963.17</LatestValue>
<LatestValueDate>2022-12-31T00:00:00</LatestValueDate>
<Title>China GDP</Title>
<Unit>USD Billion</Unit>
<YearEnd>18772.00</YearEnd>
<YearEnd2>19616.00</YearEnd2>
<YearEnd3>20636.00</YearEnd3>
<q1 i:nil="true"/>
<q1_date>2023-12-31T00:00:00</q1_date>
<q2 i:nil="true"/>
<q2_date>2024-03-31T00:00:00</q2_date>
<q3 i:nil="true"/>
<q3_date>2024-06-30T00:00:00</q3_date>
<q4 i:nil="true"/>
<q4_date>2024-09-30T00:00:00</q4_date>
</ForecastItem>
</ArrayOfForecastItem>
Response fields
Field | Type | Description | Example |
---|---|---|---|
Country* | string | Country name | “Mexico” |
Category | string | Name of the indicator | “Auto Exports” |
Title | string | Combination of country and indicator name | “Mexico Auto Exports” |
LatestValue | number | Last released value | 272.69 |
LatestValueDate | string | Date of the last released value | “2023-03-31T00:00:00” |
ForecastValue1Q** | number | Forecast value for the next quarter | 257.00 |
ForecastValue2Q** | number | Forecast value for the quarter following ForecastValue1Q | 250.00 |
ForecastValue3Q** | number | Forecast value for the quarter following ForecastValue2Q | 239.00 |
ForecastValue4Q** | number | Forecast value for the quarter following ForecastValue3Q | 274.00 |
ForecastValue1** | number | Forecast value for the year end | 239.00 |
ForecastValue2** | number | Forecast value for the year end following ForecastValue1 | 242.00 |
ForecastValue3** | number | Forecast value for the year end following ForecastValue2 | 232.00 |
q1_date | string | Date for ForecastValue1Q | “2023-06-30T00:00:00” |
q2_date | string | Date for ForecastValue2Q | “2023-09-30T00:00:00” |
q3_date | string | Date for ForecastValue3Q | “2023-12-31T00:00:00” |
q4_date | string | Date for ForecastValue4Q | “2024-03-31T00:00:00” |
Frequency | string | Frequency of the indicator | “Monthly” |
Unit | string | Unit of the forecasted values | “Thousand Units” |
HistoricalDataSymbol | string | Unique 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/Node | HTML |
---|---|
yearend | ForecastValue1 |
yearend2 | ForecastValue2 |
yearend3 | ForecastValue3 |
q1 | ForecastValue1Q |
q2 | ForecastValue2Q |
q3 | ForecastValue3Q |
q4 | ForecastValue4Q |