Snapshots by Country, Indicator and Group
Get Economic Calendar snapshot by country, indicator and group.
By country
Get all calendar events by country
te.getCalendarData(country='united states', output_type='df')
data = te.getCalendar(country = 'united states').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states?c=guest:guest");
/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}
te.getCalendarData(country='united states', initDate='2016-02-01',
endDate='2016-02-10', output_type='df')
data = te.getCalendar(country = 'united states', start_date = '2016-02-01',
end_date = '2016-02-10').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c=guest:guest");
/calendar/country/{countries}?importance={importance}
te.getCalendarData(country='united states', importance='3', output_type='df')
data = te.getCalendar(country = 'united states', importance='3').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states?c=guest:guest&importance=3");
te.getCalendarData(country=['united states','china'],output_type='df')
data = te.getCalendar(country = ['united states', 'china']).then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states,china?c=guest:guest");
/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?importance={importance}
te.getCalendarData(country=['united states','china'], initDate='2016-02-10',
endDate='2016-02-11', importance='2', output_type='df')
data = te.getCalendar(country = ['united states','china'], start_date = '2016-02-10',
end_date = '2016-02-11', importance = '2').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states,china/2016-02-10/2016-02-11?c=guest:guest&importance=2");
By indicator
Get all calendar events by indicator
/calendar/indicator/{indicators}
te.getCalendarData(category='inflation rate', output_type='df')
data = te.getCalendar(indicator = 'inflation rate').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/indicator/inflation%20rate?c=guest:guest");
/calendar/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}
te.getCalendarData(category='inflation rate', initDate='2016-03-01',
endDate='2016-03-03', output_type='df')
data = te.getCalendar(indicator = 'inflation rate', start_date = '2016-03-01',
end_date = '2016-03-03').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/indicator/inflation%20rate/2016-03-01/2016-03-03?c=guest:guest");
/calendar/indicator/{indicators}?importance={importance}
te.getCalendarData(category='inflation rate', importance='2', output_type='df')
data = te.getCalendar(indicator = 'inflation rate', importance = '2').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/indicator/inflation%20rate?c=guest:guest&importance=2");
/calendar/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?importance={importance}
te.getCalendarData(category='inflation rate', initDate='2016-03-01',
endDate='2016-03-03', importance='2', output_type='df')
data = te.getCalendar(indicator = 'inflation rate', start_date = '2016-03-01',
end_date = '2016-03-03', importance='2').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/indicator/inflation%20rate/2016-03-01/2016-03-03?c=guest:guest&importance=2");
By country and indicator
Get all calendar events by country and indicator
/calendar/country/{countries}/indicator/{indicators}
te.getCalendarData(country='united states',
category='initial jobless claims', output_type='df')
data = te.getCalendar(country = 'united states',
indicator = 'initial jobless claims').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c=guest:guest");
/calendar/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}
te.getCalendarData(category='initial jobless claims', country='united states',
initDate='2016-12-01', endDate='2017-02-25', output_type='df')
data = te.getCalendar(indicator = 'initial jobless claims', country = 'united states',
start_date = '2016-12-01', end_date = '2017-02-25').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest:guest");
By group
Get all calendar events by group (interest rate, inflation, bonds, consumer, gdp, government, housing, labour, markets, money, prices, trade, business)
te.getCalendarEventsByGroup(group='bonds', output_type='df')
data = te.getCalendarEventsByGroup(group = 'bonds').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/group/bonds?c=guest:guest");
/calendar/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}
te.getCalendarEventsByGroup(group='bonds', initDate='2016-03-01',
endDate='2018-03-03', output_type='df')
data = te.getCalendarEventsByGroup(group = 'bonds', start_date = '2016-03-01',
end_date = '2018-03-03').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/group/bonds/2016-03-01/2018-03-03?c=guest:guest");
By country and group
Get all calendar events by country and group (interest rate, inflation, bonds, consumer, gdp, government, housing, labour, markets, money, prices, trade, business)
/calendar/country/{country}/group/{group}
te.getCalendarEventsByGroup(country='united states', group='bonds',
output_type='df')
data = te.getCalendarEventsByGroup(country = 'united states',
group = 'bonds').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c=guest:guest");
/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}
te.getCalendarEventsByGroup(group='bonds', country='united states',
initDate='2016-03-01', endDate='2018-03-03', output_type='df')
data = te.getCalendarEventsByGroup(group = 'bonds', country = 'united states',
start_date = '2016-03-01', end_date = '2018-03-03').then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c=guest:guest");
Response fields
Field | Type | Description | Example |
---|---|---|---|
CalendarID | string | Unique calendar ID used by Trading Economics | “87220” |
Date | string | Release time and date in UTC | “2016-12-02T13:30:00” |
Country | string | Country original name | “United States” |
Category | string | Category original name | “20 Year Bond Yield” |
Event | string | Event original name | “20-Year Bond Auction” |
Reference | string | Abbreviated period for which released data refers to | Nov/26" |
ReferenceDate | string | Complete reference date | “2016-11-30T00:00:00” |
Source | string | Source of the data | “U.S. Bureau of Labor Statistics” |
SourceURL | string | URL link of the source | “http://www.dol.gov” |
Actual | string | Latest released value | “178K” |
Previous | string | Value for the previous period after the revision (if revision is applicable) | “142K” |
Forecast | string | Average forecast among a representative group of economists | “175K” |
TEForecast | string | TE own projections | “180K” |
URL | string | Hyperlink at Trading Economics | “/united-states/non-farm-payrolls” |
DateSpan | string | 0 indicates that the time of the event is known; 1 indicates that we only know the date of the event; the exact time of the event is unknown | “0” |
Importance | number | 1 = low, 2 = medium, 3 = high | 3 |
LastUpdate | string | Time when new data was inserted or changed | “2016-12-02T13:31:00” |
Revised | string | Value reported in the previous period after revision | 161K" |
Currency | string | Currency of the data | “C$” |
Unit | string | Unit of the data | “%” |
Ticker | string | Unique ticker used by Trading Economics | “NFP TCH” |
Symbol | string | Unique symbol used by Trading Economics | “IJCUSA” |
Fields available only with translations
e.g. https://api.tradingeconomics.com/calendar/country/united%20states?c=guest:guest&lang=es
Field | Type | Description | Example |
---|---|---|---|
OCountry | string | Country original name | “United States” |
OCategory | string | Category original name | “20 Year Bond Yield” |
OEvent | string | Event original name | “20-Year Bond Auction” |
Country | string | Country name | “Estados Unidos” |
Category | string | Indicator category name | “Rendimiento del bono a 20 años” |
Event | string | Specific event name in the calendar | “Subasta de bonos a 20 años” |