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.

/calendar

| 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 |

/calendar?f=json

[{"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"}]

/calendar?f=csv

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

/calendar?f=xml

<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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
8565312/2/2016 12:30:00 AMAustraliaRetail Sales MoMRetail Sales MoMOct10/31/2016 12:00:00 AMAustralian Bureau of Statisticshttps://www.abs.gov.au0.5%0.6%0.3%0.2%/australia/retail-sales0212/2/2016 12:30:00 AM%AUSRETAILSALESMOMAUSRetailSalesMoM
10353612/2/2016 2:00:00 AMPhilippinesRetail Price IndexRetail Price Index YoYOct10/31/2016 12:00:00 AMPhilippine Statistics Authorityhttps://psa.gov.ph3.4%3%3.49%/philippines/retail-price-index0112/2/2016 8:35:00 AM%PHLRPIPHLRPI
10382712/2/2016 4:00:00 AMEast TimorInflation RateInflation Rate YoYOct10/31/2016 12:00:00 AM“National Statistics Directorate, Timor”https://www.statistics.gov.tl-1.3%-1.3%-1.1%/east-timor/inflation-cpi0112/2/2016 6:21:00 PM%TIMIMORINFNRATETIMIMORINFNRATE

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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3146051/3/2023 12:00:00 AMSingaporeGDP Growth RateGDP Growth Rate QoQ AdvQ412/31/2022 12:00:00 AMStatistics Singaporehttps://www.singstat.gov.sg/0.2%1.1%0.3%/singapore/gdp-growth021/3/2023 12:01:31 AM%SGDPQOQSGDPQOQ
3146061/3/2023 12:00:00 AMSingaporeGDP Annual Growth RateGDP Growth Rate YoY AdvQ412/31/2022 12:00:00 AMStatistics Singaporehttps://www.singstat.gov.sg/2.2%4.2%2.1%2.1%/singapore/gdp-growth-annual021/3/2023 12:00:00 AM4.1%%SGDPYOYSGDPYOY
3146251/3/2023 7:00:00 AMTurkeyInflation Rate MomInflation Rate MoMDec12/31/2022 12:00:00 AMTurkish Statistical Institutehttps://www.tuik.gov.tr/1.18%2.88%2.58%2.4%/turkey/inflation-rate-mom021/3/2023 7:00:38 AM%TURKEYINFRATMOMTURKEYINFRATMOM

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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
8722012/2/2016 1:30:00 PMUnited StatesNon Farm PayrollsNon Farm PayrollsNov11/30/2016 12:00:00 AMU.S. Bureau of Labor Statisticshttps://www.bls.gov/178K142K175K180K/united-states/non-farm-payrolls0312/2/2016 1:31:00 PM161KKNFP TCHNFP TCH
8566112/5/2016 5:00:00 AMJapanConsumer ConfidenceConsumer ConfidenceNov11/30/2016 12:00:00 AM“Cabinet Office, Japan”https://www.cao.go.jp40.942.343.842.53/japan/consumer-confidence0312/5/2016 5:03:00 AMJCOMACFJCOMACF
8570012/6/2016 1:30:00 PMCanadaBalance of TradeBalance of TradeOct10/31/2016 12:00:00 AMStatistics Canadahttps://www.statcan.gc.caC$-1.13BC$-4.38BC$-2.0BC$-3B/canada/balance-of-trade0312/6/2016 1:30:00 PMC$-4.08BC$BCATBTOTBCATBTOTB

By Ticker

Get all calendar events by calendar ticker

/calendar/ticker/{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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3136096/29/2023 12:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJun/246/24/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov239K265K265K266.0K/united-states/jobless-claims026/29/2023 12:30:20 PM264KKIJCUSAIJCUSA
3135786/22/2023 12:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJun/176/17/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov264K264K260K271.0K/united-states/jobless-claims026/22/2023 12:30:35 PM262KKIJCUSAIJCUSA
3135406/15/2023 12:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJun/106/10/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov262K262K249K275.0K/united-states/jobless-claims026/15/2023 12:30:41 PM261KKIJCUSAIJCUSA

/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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3128212/2/2023 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJan/281/28/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov186K192K205K202K/united-states/jobless-claims022/2/2023 1:30:20 PMKIJCUSAIJCUSA
3127841/26/2023 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJan/211/21/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov183K186K200K187.0K/united-states/jobless-claims021/26/2023 1:30:02 PM190KKIJCUSAIJCUSA
3159681/26/2023 12:00:00 PMBahrainInflation RateInflation Rate YoYDec12/31/2022 12:00:00 AMCentral Informatics Organisation - Kingdom of Bahrainhttps://www.data.gov.bh3.6%3.9%3.8%/bahrain/inflation-cpi011/26/2023 12:01:22 PM%BAHRAININFNRATEBAHRAININFNRATE

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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
1600256/21/2018 7:00:00 AMSpainFactory OrdersIndustrial Orders YoYApr4/30/2018 12:00:00 AMNational Statistics Institute (INE)https://www.ine.es/4.8%3.9%4.5%/spain/factory-orders016/21/2018 7:02:00 AM%SPAINFACORDSPAINFACORD
1600306/23/2018 6:15:00 AMBahrainInflation RateInflation Rate YoYMay5/31/2018 12:00:00 AMInformatics Organisation - Kingdom of Bahrainhttps://www.data.gov.bh2.8%2.6%2.80%/bahrain/inflation-cpi016/23/2018 6:13:00 AM%BAHRAININFNRATEBAHRAININFNRATE
1741086/19/2018 12:00:00 AMAzerbaijanHolidaysEnd of Ramadan (Substitute Day)/azerbaijan/holidays111/15/2018 1:39:00 PMHOLIDAYSAZERBAIJAN

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 FormatExample
yyyy-MM-dd2018-01-01
yyyy-mm-dd HH:mm2016-12-03 23:59:59