Snapshot

The economic calendar covers around 1600 events for more than 150 countries a month.

All events

Get all calendar events

te.getCalendarData(output_type='df')

data = te.getCalendar().then(function (data) {
  console.log(data)
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar?c=guest:guest");

Updates

Get calendar latest updates (for events with a released Actual)

/calendar/updates?c=guest:guest

te.getCalendarUpdates(output_type='df')

data = te.getCalendarUpdates().then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/updates?c=guest:guest");

By importance

Get all calendar events by importance (1-Low, 2-Medium, 3-High)

/calendar?importance={importance}

te.getCalendarData(importance='2', output_type='df')

data = te.getCalendar(importance = '2').then(function(data){
    console.log(data)       
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar?c=guest:guest&importance=2");

By date

Get all calendar events by date

/calendar/country/All/{yyyy-mm-dd}/{yyyy-mm-dd}

te.getCalendarData(initDate='2016-12-02', endDate='2016-12-03', output_type='df')

data = te.getCalendar(start_date = '2016-12-02', end_date = '2016-12-03').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/All/2016-12-02/2016-12-03?c=guest:guest");

/calendar/country/All/{yyyy-mm-dd}/{yyyy-mm-dd}?importance={importance}

te.getCalendarData(initDate='2016-12-02', endDate='2016-12-03', 
 importance='3', output_type='df')

data = te.getCalendar(start_date = '2016-12-02', end_date = '2016-12-03', 
 importance = '3').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/country/All/2016-12-02/2016-12-03?c=guest:guest&importance=3");

By ID

Get all calendar events by calendar ID

/calendar/calendarid/{calendarIDs}

te.getCalendarId(id = '174108', output_type=  'df')

te.getCalendarId(id = [ '174108', '160025', '160030'], output_type=  'df')

data = te.getCalendar(id = '174108').then(function(data){
  console.log(data)     
});

data = te.getCalendar(id = ['174108','160025','160030']).then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/calendarid/174108?c=guest:guest");

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/calendarid/174108,160025,160030?c=guest:guest");

By ticker

Get all calendar events by calendar ticker

/calendar/ticker/{ticker}

te.getCalendarData(ticker = 'IJCUSA', output_type =  'df')

te.getCalendarData(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'],
 output_type =  'df')

data = te.getCalendar(ticker = 'IJCUSA').then(function(data){
    console.log(data)     
});

data = te.getCalendar(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE']).then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/ticker/IJCUSA?c=guest:guest");

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE?c=guest:guest");

/calendar/ticker/{ticker}/{yyyy-mm-dd}/{yyyy-mm-dd}

te.getCalendarData(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'],
 initDate='2018-01-01', endDate='2018-03-01', output_type='df')

data = te.getCalendar(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'],
 start_date = '2018-01-01',end_date = '2018-03-01').then(function(data){
    console.log(data)     
});

WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE/2018-01-01/2018-03-01?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 event, the exact time of 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?c=guest:guest&importance=2&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”