Economic Calendar
Trading Economics provides its users with a near real-time economic calendar updated 24 hours a day. Actual values are based on official sources, not third party data providers. Previous values are available before an economic indicator is reported and marked as revised accordingly. Survey consensus figures are provided displaying the average forecast among a representative group of economists.
Events
import tradingeconomics as te
te.login('your_api_key')
te.getCalendarData()
const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getCalendar().then(function (data) {
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar?c=guest:guest");
You can receive data in several formats by appending the “f” parameter to your request.
| CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|
| 314991 | 1/3/2023 12:00:00 AM | Argentina | Tax Revenue | Tax Revenue | Dec | 12/31/2022 12:00:00 AM | "Ministerio de Hacienda, Argentina" | https:<span>//www.minhacienda.gob.ar | ARS2307.48B | ARS1953.86B | | ARS1956B | /argentina/tax-revenue | 0 | 1 | 1/3/2023 3:35:32 AM | | ARS | B | ARGENTINATAXREV | ARGENTINATAXREV |
| 314605 | 1/3/2023 12:00:00 AM | Singapore | GDP Growth Rate | GDP Growth Rate QoQ Adv | Q4 | 12/31/2022 12:00:00 AM | Statistics Singapore | https:<span>//www.singstat.gov.sg/ | 0.2% | 1.1% | | 0.3% | /singapore/gdp-growth | 0 | 2 | 1/3/2023 12:01:31 AM | | | % | SGDPQOQ | SGDPQOQ |
| 314606 | 1/3/2023 12:00:00 AM | Singapore | GDP Annual Growth Rate | GDP Growth Rate YoY Adv | Q4 | 12/31/2022 12:00:00 AM | Statistics Singapore | https:<span>//www.singstat.gov.sg/ | 2.2% | 4.2% | 2.1% | 2.1% | /singapore/gdp-growth-annual | 0 | 2 | 1/3/2023 12:00:00 AM | 4.1% | | % | SGDPYOY | SGDPYOY |
[{"CalendarId":"318980","Date":"2023-03-30T00:00:00","Country":"New Zealand","Category":"Business Confidence","Event":"ANZ Business Confidence","Reference":"Mar","ReferenceDate":"2023-03-31T00:00:00","Source":"ANZ Bank New Zealand","SourceURL":"https://www.anz.co.nz","Actual":"-43.4","Previous":"-43.3","Forecast":"","TEForecast":"-40","URL":"/new-zealand/business-confidence","DateSpan":"0","Importance":2,"LastUpdate":"2023-03-30T00:00:00.187","Revised":"","Currency":"","Unit":"","Ticker":"NZIEBCAC","Symbol":"NZIEBCAC"},{"CalendarId":"318764","Date":"2023-03-30T00:01:00","Country":"United Kingdom","Category":"Car Production","Event":"Car Production YoY","Reference":"Feb","ReferenceDate":"2023-02-28T00:00:00","Source":"The Society of Motor Manufacturers and Traders Limited (SMMT)","SourceURL":"https://www.smmt.co.uk/","Actual":"13.1%","Previous":"-0.3%","Forecast":"","TEForecast":"0.8%","URL":"/united-kingdom/car-production","DateSpan":"0","Importance":1,"LastUpdate":"2023-03-30T00:02:25.927","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDKINCARPRO","Symbol":"UNITEDKINCARPRO"},{"CalendarId":"318983","Date":"2023-03-30T01:00:00","Country":"Philippines","Category":"Producer Prices Change","Event":"PPI YoY","Reference":"Feb","ReferenceDate":"2023-02-28T00:00:00","Source":"Philippine Statistics Authority","SourceURL":"https://psa.gov.ph","Actual":"3.6%","Previous":"4.4%","Forecast":"","TEForecast":"4.0%","URL":"/philippines/producer-prices-change","DateSpan":"0","Importance":1,"LastUpdate":"2023-03-30T01:01:02.3","Revised":"4.2%","Currency":"","Unit":"%","Ticker":"PHILIPPINEPROPRICHA","Symbol":"PHILIPPINEPROPRICHA"}]
CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
318980,3/30/2023 12:00:00 AM,New Zealand,Business Confidence,ANZ Business Confidence,Mar,3/31/2023 12:00:00 AM,ANZ Bank New Zealand,https://www.anz.co.nz,-43.4,-43.3,,-40,/new-zealand/business-confidence,0,2,3/30/2023 12:00:00 AM,,,,NZIEBCAC,NZIEBCAC
318764,3/30/2023 12:01:00 AM,United Kingdom,Car Production,Car Production YoY,Feb,2/28/2023 12:00:00 AM,The Society of Motor Manufacturers and Traders Limited (SMMT),https://www.smmt.co.uk/,13.1%,-0.3%,,0.8%,/united-kingdom/car-production,0,1,3/30/2023 12:02:25 AM,,,%,UNITEDKINCARPRO,UNITEDKINCARPRO
318983,3/30/2023 1:00:00 AM,Philippines,Producer Prices Change,PPI YoY,Feb,2/28/2023 12:00:00 AM,Philippine Statistics Authority,https://psa.gov.ph,3.6%,4.4%,,4.0%,/philippines/producer-prices-change,0,1,3/30/2023 1:01:02 AM,4.2%,,%,PHILIPPINEPROPRICHA,PHILIPPINEPROPRICHA
<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>318980</CalendarId>
<Date>2023-03-30T00:00:00</Date>
<Country>New Zealand</Country>
<Category>Business Confidence</Category>
<Event>ANZ Business Confidence</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>ANZ Bank New Zealand</Source>
<SourceURL>https://www.anz.co.nz</SourceURL>
<Actual>-43.4</Actual>
<Previous>-43.3</Previous>
<Forecast/>
<TEForecast>-40</TEForecast>
<URL>/new-zealand/business-confidence</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-03-30T00:00:00.187</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>NZIEBCAC</Ticker>
<Symbol>NZIEBCAC</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>318764</CalendarId>
<Date>2023-03-30T00:01:00</Date>
<Country>United Kingdom</Country>
<Category>Car Production</Category>
<Event>Car Production YoY</Event>
<Reference>Feb</Reference>
<ReferenceDate>2023-02-28T00:00:00</ReferenceDate>
<Source>The Society of Motor Manufacturers and Traders Limited (SMMT)</Source>
<SourceURL>https://www.smmt.co.uk/</SourceURL>
<Actual>13.1%</Actual>
<Previous>-0.3%</Previous>
<Forecast/>
<TEForecast>0.8%</TEForecast>
<URL>/united-kingdom/car-production</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-03-30T00:02:25.927</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDKINCARPRO</Ticker>
<Symbol>UNITEDKINCARPRO</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>318983</CalendarId>
<Date>2023-03-30T01:00:00</Date>
<Country>Philippines</Country>
<Category>Producer Prices Change</Category>
<Event>PPI YoY</Event>
<Reference>Feb</Reference>
<ReferenceDate>2023-02-28T00:00:00</ReferenceDate>
<Source>Philippine Statistics Authority</Source>
<SourceURL>https://psa.gov.ph</SourceURL>
<Actual>3.6%</Actual>
<Previous>4.4%</Previous>
<Forecast/>
<TEForecast>4.0%</TEForecast>
<URL>/philippines/producer-prices-change</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-03-30T01:01:02.3</LastUpdate>
<Revised>4.2%</Revised>
<Currency/>
<Unit>%</Unit>
<Ticker>PHILIPPINEPROPRICHA</Ticker>
<Symbol>PHILIPPINEPROPRICHA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>
By date
/calendar/country/All/{yyyy-mm-dd}/{yyyy-mm-dd}
te.getCalendarData(initDate='2016-12-02', endDate='2016-12-03')
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");
CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
85653 | 12/2/2016 12:30:00 AM | Australia | Retail Sales MoM | Retail Sales MoM | Oct | 10/31/2016 12:00:00 AM | Australian Bureau of Statistics | https://www.abs.gov.au | 0.5% | 0.6% | 0.3% | 0.2% | /australia/retail-sales | 0 | 2 | 12/2/2016 12:30:00 AM | % | AUSRETAILSALESMOM | AUSRetailSalesMoM | ||
103536 | 12/2/2016 2:00:00 AM | Philippines | Retail Price Index | Retail Price Index YoY | Oct | 10/31/2016 12:00:00 AM | Philippine Statistics Authority | https://psa.gov.ph | 3.4% | 3% | 3.49% | /philippines/retail-price-index | 0 | 1 | 12/2/2016 8:35:00 AM | % | PHLRPI | PHLRPI | |||
103827 | 12/2/2016 4:00:00 AM | East Timor | Inflation Rate | Inflation Rate YoY | Oct | 10/31/2016 12:00:00 AM | “National Statistics Directorate, Timor” | https://www.statistics.gov.tl | -1.3% | -1.3% | -1.1% | /east-timor/inflation-cpi | 0 | 1 | 12/2/2016 6:21:00 PM | % | TIMIMORINFNRATE | TIMIMORINFNRATE |
By importance
Get all calendar events by importance (1-Low, 2-Medium, 3-High)
/calendar?importance={importance}
te.getCalendarData(importance='2')
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");
CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
314605 | 1/3/2023 12:00:00 AM | Singapore | GDP Growth Rate | GDP Growth Rate QoQ Adv | Q4 | 12/31/2022 12:00:00 AM | Statistics Singapore | https://www.singstat.gov.sg/ | 0.2% | 1.1% | 0.3% | /singapore/gdp-growth | 0 | 2 | 1/3/2023 12:01:31 AM | % | SGDPQOQ | SGDPQOQ | |||
314606 | 1/3/2023 12:00:00 AM | Singapore | GDP Annual Growth Rate | GDP Growth Rate YoY Adv | Q4 | 12/31/2022 12:00:00 AM | Statistics Singapore | https://www.singstat.gov.sg/ | 2.2% | 4.2% | 2.1% | 2.1% | /singapore/gdp-growth-annual | 0 | 2 | 1/3/2023 12:00:00 AM | 4.1% | % | SGDPYOY | SGDPYOY | |
314625 | 1/3/2023 7:00:00 AM | Turkey | Inflation Rate Mom | Inflation Rate MoM | Dec | 12/31/2022 12:00:00 AM | Turkish Statistical Institute | https://www.tuik.gov.tr/ | 1.18% | 2.88% | 2.58% | 2.4% | /turkey/inflation-rate-mom | 0 | 2 | 1/3/2023 7:00:38 AM | % | TURKEYINFRATMOM | TURKEYINFRATMOM |
By Date and Importance
/calendar/country/All/{yyyy-mm-dd}/{yyyy-mm-dd}?importance={importance}
te.getCalendarData(initDate='2016-12-02', endDate='2016-12-03',
importance='3')
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");
CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
87220 | 12/2/2016 1:30:00 PM | United States | Non Farm Payrolls | Non Farm Payrolls | Nov | 11/30/2016 12:00:00 AM | U.S. Bureau of Labor Statistics | https://www.bls.gov/ | 178K | 142K | 175K | 180K | /united-states/non-farm-payrolls | 0 | 3 | 12/2/2016 1:31:00 PM | 161K | K | NFP TCH | NFP TCH | |
85661 | 12/5/2016 5:00:00 AM | Japan | Consumer Confidence | Consumer Confidence | Nov | 11/30/2016 12:00:00 AM | “Cabinet Office, Japan” | https://www.cao.go.jp | 40.9 | 42.3 | 43.8 | 42.53 | /japan/consumer-confidence | 0 | 3 | 12/5/2016 5:03:00 AM | JCOMACF | JCOMACF | |||
85700 | 12/6/2016 1:30:00 PM | Canada | Balance of Trade | Balance of Trade | Oct | 10/31/2016 12:00:00 AM | Statistics Canada | https://www.statcan.gc.ca | C$-1.13B | C$-4.38B | C$-2.0B | C$-3B | /canada/balance-of-trade | 0 | 3 | 12/6/2016 1:30:00 PM | C$-4.08B | C$ | B | CATBTOTB | CATBTOTB |
By Ticker
Get all calendar events by calendar ticker
te.getCalendarData(ticker = 'IJCUSA')
te.getCalendarData(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'])
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");
CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
313609 | 6/29/2023 12:30:00 PM | United States | Initial Jobless Claims | Initial Jobless Claims | Jun/24 | 6/24/2023 12:00:00 AM | U.S. Department of Labor | https://www.dol.gov | 239K | 265K | 265K | 266.0K | /united-states/jobless-claims | 0 | 2 | 6/29/2023 12:30:20 PM | 264K | K | IJCUSA | IJCUSA | |
313578 | 6/22/2023 12:30:00 PM | United States | Initial Jobless Claims | Initial Jobless Claims | Jun/17 | 6/17/2023 12:00:00 AM | U.S. Department of Labor | https://www.dol.gov | 264K | 264K | 260K | 271.0K | /united-states/jobless-claims | 0 | 2 | 6/22/2023 12:30:35 PM | 262K | K | IJCUSA | IJCUSA | |
313540 | 6/15/2023 12:30:00 PM | United States | Initial Jobless Claims | Initial Jobless Claims | Jun/10 | 6/10/2023 12:00:00 AM | U.S. Department of Labor | https://www.dol.gov | 262K | 262K | 249K | 275.0K | /united-states/jobless-claims | 0 | 2 | 6/15/2023 12:30:41 PM | 261K | K | IJCUSA | IJCUSA |
/calendar/ticker/{ticker}/{yyyy-mm-dd}/{yyyy-mm-dd}
te.getCalendarData(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'],
initDate='2018-01-01', endDate='2018-03-01')
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");
CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
312821 | 2/2/2023 1:30:00 PM | United States | Initial Jobless Claims | Initial Jobless Claims | Jan/28 | 1/28/2023 12:00:00 AM | U.S. Department of Labor | https://www.dol.gov | 186K | 192K | 205K | 202K | /united-states/jobless-claims | 0 | 2 | 2/2/2023 1:30:20 PM | K | IJCUSA | IJCUSA | ||
312784 | 1/26/2023 1:30:00 PM | United States | Initial Jobless Claims | Initial Jobless Claims | Jan/21 | 1/21/2023 12:00:00 AM | U.S. Department of Labor | https://www.dol.gov | 183K | 186K | 200K | 187.0K | /united-states/jobless-claims | 0 | 2 | 1/26/2023 1:30:02 PM | 190K | K | IJCUSA | IJCUSA | |
315968 | 1/26/2023 12:00:00 PM | Bahrain | Inflation Rate | Inflation Rate YoY | Dec | 12/31/2022 12:00:00 AM | Central Informatics Organisation - Kingdom of Bahrain | https://www.data.gov.bh | 3.6% | 3.9% | 3.8% | /bahrain/inflation-cpi | 0 | 1 | 1/26/2023 12:01:22 PM | % | BAHRAININFNRATE | BAHRAININFNRATE |
By ID
Get all calendar events by calendar ID
/calendar/calendarid/{calendarIDs}
te.getCalendarId(id = '174108')
te.getCalendarId(id = [ '174108', '160025', '160030'])
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");
CalendarId | Date | Country | Category | Event | Reference | ReferenceDate | Source | SourceURL | Actual | Previous | Forecast | TEForecast | URL | DateSpan | Importance | LastUpdate | Revised | Currency | Unit | Ticker | Symbol |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
160025 | 6/21/2018 7:00:00 AM | Spain | Factory Orders | Industrial Orders YoY | Apr | 4/30/2018 12:00:00 AM | National Statistics Institute (INE) | https://www.ine.es/ | 4.8% | 3.9% | 4.5% | /spain/factory-orders | 0 | 1 | 6/21/2018 7:02:00 AM | % | SPAINFACORD | SPAINFACORD | |||
160030 | 6/23/2018 6:15:00 AM | Bahrain | Inflation Rate | Inflation Rate YoY | May | 5/31/2018 12:00:00 AM | Informatics Organisation - Kingdom of Bahrain | https://www.data.gov.bh | 2.8% | 2.6% | 2.80% | /bahrain/inflation-cpi | 0 | 1 | 6/23/2018 6:13:00 AM | % | BAHRAININFNRATE | BAHRAININFNRATE | |||
174108 | 6/19/2018 12:00:00 AM | Azerbaijan | Holidays | End of Ramadan (Substitute Day) | /azerbaijan/holidays | 1 | 1 | 1/15/2018 1:39:00 PM | HOLIDAYSAZERBAIJAN |
Updates
Get calendar latest updates (for events with a released Actual)
/calendar/updates?c=guest:guest
te.getCalendarUpdates()
data = te.getCalendarUpdates().then(function(data){
console.log(data)
});
WebRequest request = WebRequest.Create("https://api.tradingeconomics.com/calendar/updates?c=guest:guest");
| CalendarId | Country | Event | LastUpdate |
|------------|------------|---------------------------|----------------------|
| 323766 | Turkey | Foreign Exchange Reserves | 7/3/2023 11:35:46 AM |
| 323811 | Cape Verde | GDP Growth Rate YoY | 7/3/2023 11:17:39 AM |
| 323785 | Spain | New Car Sales YoY | 7/3/2023 11:03:07 AM |
Date Format
Calendar methods described above support string dates in different formats
Date Format | Example |
---|---|
yyyy-MM-dd | 2018-01-01 |
yyyy-mm-dd HH:mm | 2016-12-03 23:59:59 |