Snapshots by Country, Indicator and Group

Get Economic Calendar snapshot by country, indicator and group.

By country

Get all calendar events by country

/calendar/country/{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");

/calendar/country/{countries}

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)

/calendar/group/{group}

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

FieldTypeDescriptionExample
CalendarIDstringUnique calendar ID used by Trading Economics“87220”
DatestringRelease time and date in UTC“2016-12-02T13:30:00”
CountrystringCountry original name“United States”
CategorystringCategory original name“20 Year Bond Yield”
EventstringEvent original name“20-Year Bond Auction”
ReferencestringAbbreviated period for which released data refers toNov/26"
ReferenceDatestringComplete reference date“2016-11-30T00:00:00”
SourcestringSource of the data“U.S. Bureau of Labor Statistics”
SourceURLstringURL link of the source“http://www.dol.gov”
ActualstringLatest released value“178K”
PreviousstringValue for the previous period after the revision (if revision is applicable)“142K”
ForecaststringAverage forecast among a representative group of economists“175K”
TEForecaststringTE own projections“180K”
URLstringHyperlink at Trading Economics“/united-states/non-farm-payrolls”
DateSpanstring0 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”
Importancenumber1 = low, 2 = medium, 3 = high3
LastUpdatestringTime when new data was inserted or changed“2016-12-02T13:31:00”
RevisedstringValue reported in the previous period after revision161K"
CurrencystringCurrency of the data“C$”
UnitstringUnit of the data“%”
TickerstringUnique ticker used by Trading Economics“NFP TCH”
SymbolstringUnique 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

FieldTypeDescriptionExample
OCountrystringCountry original name“United States”
OCategorystringCategory original name“20 Year Bond Yield”
OEventstringEvent original name“20-Year Bond Auction”
CountrystringCountry name“Estados Unidos”
CategorystringIndicator category name“Rendimiento del bono a 20 años”
EventstringSpecific event name in the calendar“Subasta de bonos a 20 años”