Economic Calendar by Country

Get Economic Calendar snapshot by country.

/calendar/country/{country}

import tradingeconomics as te
te.login('your_api_key')
te.getCalendarData(country='united states')
const te = require('tradingeconomics');
te.login('your_api_key');
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3149561/5/2023 12:30:00 PMUnited StatesChallenger Job CutsChallenger Job CutsDec12/31/2022 12:00:00 AM“Challenger, Gray and Christmas, Inc.”https://www.challengergray.com43.651K76.835K33K/united-states/challenger-job-cuts011/5/2023 12:30:00 PMKUNITEDSTACHAJOBCUTUNITEDSTACHAJOBCUT
3147921/5/2023 1:15:00 PMUnited StatesADP Employment ChangeADP Employment ChangeDec12/31/2022 12:00:00 AM“Automatic Data Processing, Inc.”https://adpemploymentreport.com/235K182K150K150K/united-states/adp-employment-change021/5/2023 1:31:54 PM127KKUNITEDSTAADPEMPCHAUNITEDSTAADPEMPCHA
3149741/5/2023 1:30:00 PMUnited StatesExportsExportsNov11/30/2022 12:00:00 AMU.S. Census Bureauhttps://www.census.gov$251.9B$256.9B$251.4B/united-states/exports021/5/2023 1:31:59 PM$256.6B$BTBEXTOTTBEXTOT

By country and date

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

te.getCalendarData(country='united states', initDate='2016-02-01',
 endDate='2016-02-10')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
734942/1/2016 1:30:00 PMUnited StatesPersonal IncomePersonal Income (MoM)Dec12/31/2015 12:00:00 AMU.S. Bureau of Economic Analysishttps://www.bea.gov0.3%0.3%0.2%0.2%/united-states/personal-income032/1/2016 1:30:00 PM%UNITEDSTAPERINCUNITEDSTAPERINC
734952/1/2016 1:30:00 PMUnited StatesPersonal IncomePersonal Income (MoM)Dec12/31/2015 12:00:00 AMU.S. Bureau of Economic Analysishttps://www.bea.gov0.0%0.5%0.1%0.2%/united-states/personal-spending032/1/2016 1:30:00 PM0.3%%UNITEDSTAPERSPEUNITEDSTAPERSPE
734962/1/2016 1:30:00 PMUnited StatesCore PCE Price Index MoMCore PCE Price Index MoMDec12/31/2015 12:00:00 AMU.S. Bureau of Economic Analysishttps://www.bea.gov/0.0%0.2%0.1%/united-states/core-pce-price-index-mom012/1/2016 1:39:00 PM0.1%%USACPPIMUSACPPIM

By country and importance

/calendar/country/{countries}?importance={importance}

te.getCalendarData(country='united states', importance='3')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3126781/6/2023 1:30:00 PMUnited StatesNon Farm PayrollsNon Farm PayrollsDec12/31/2022 12:00:00 AMU.S. Bureau of Labor Statisticshttps://www.bls.gov/223K256K200K220K/united-states/non-farm-payrolls031/6/2023 1:30:05 PM263KKNFP TCHNFP TCH
3126791/6/2023 1:30:00 PMUnited StatesUnemployment RateUnemployment RateDec12/31/2022 12:00:00 AMU.S. Bureau of Labor Statisticshttps://www.bls.gov/3.5%3.6%3.7%3.7%/united-states/unemployment-rate031/6/2023 1:30:04 PM3.7%%USURTOTUSURTOT
3149841/6/2023 3:00:00 PMUnited StatesNon Manufacturing PMIISM Non-Manufacturing PMIDec12/31/2022 12:00:00 AMInstitute for Supply Managementhttps://www.ismworld.org49.656.55553/united-states/non-manufacturing-pmi031/6/2023 3:00:00 PMUNITEDSTANONMANPMIUNITEDSTANONMANPMI

/calendar/country/{countries}

te.getCalendarData(country=['united states','china'])
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3150021/7/2023 3:00:00 AMChinaForeign Exchange ReservesForeign Exchange ReservesDec12/31/2022 12:00:00 AMPeople’s Bank of Chinahttps://www.pbc.gov.cn$3.128T$3.117T$3.154T$ 3T/china/foreign-exchange-reserves011/7/2023 7:37:42 AM$TCHINAFOREXCRESCHINAFOREXCRES
3375921/9/2023 3:30:00 PMUnited StatesCalendarNY Fed Treasury Purchases 0 to 2.25 yrs$80M/united-states/calendar012/2/2023 12:17:24 PMUSD CALENDAR
3150791/9/2023 4:00:00 PMUnited StatesInflation ExpectationsConsumer Inflation ExpectationsDec12/31/2022 12:00:00 AMFederal Reserve Bank of New Yorkhttps://www.newyorkfed.org5%5.2%5.2%/united-states/inflation-expectations011/9/2023 4:00:41 PM%UNITEDSTAINFEXPUNITEDSTAINFEXP

By countries

/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')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
902352/10/2016 3:00:00 PMUnited StatesInterest RateFed Yellen Testimony HFSCFederal Reservehttps://www.federalreserve.gov//united-states/interest-rate022/5/2016 4:51:00 PMFDTRFDTR
878592/10/2016 3:30:00 PMUnited StatesCrude Oil Stocks ChangeEIA Crude Oil Stocks ChangeFeb/052/5/2016 12:00:00 AMU.S. Energy Information Administrationhttps://www.eia.gov-0.754M7.792M3.6M4.1M/united-states/crude-oil-stocks-change022/10/2016 3:31:00 PMMUNITEDSTACRUOILSTOCHUNITEDSTACRUOILSTOCH
883722/10/2016 3:30:00 PMUnited StatesGasoline Stocks ChangeEIA Gasoline Stocks ChangeFeb/052/5/2016 12:00:00 AMU.S. Energy Information Administrationhttps://www.eia.gov1258K5938K400K2185.4K/united-states/gasoline-stocks-change022/10/2016 3:33:00 PMKUNITEDSTAGASSTOCHAUNITEDSTAGASSTOCHA

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')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3127101/12/2023 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJan/071/7/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov205K206K215K215K/united-states/jobless-claims021/12/2023 1:30:33 PM204KKIJCUSAIJCUSA
3127521/19/2023 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJan/141/14/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov190K205K214K207K/united-states/jobless-claims021/19/2023 1:30:17 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.gov186K192K205K202K/united-states/jobless-claims021/26/2023 1:30:02 PM190KKIJCUSAIJCUSA

By country, indicator and dates

/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')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
8721312/1/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsNov/2611/26/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov268K251K253K253.1K/united-states/jobless-claims0212/1/2016 1:30:00 PMKIJCUSAIJCUSA
8722912/8/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsDec/0312/3/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov258K268K258K263K/united-states/jobless-claims0212/8/2016 1:31:00 PMKIJCUSAIJCUSA
8724012/15/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsDec/1012/10/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov254K258K255K256K/united-states/jobless-claims0212/15/2016 1:30:00 PMKIJCUSAIJCUSA

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')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3126891/9/2023 4:30:00 PMUnited States3 Month Bill Yield3-Month Bill AuctionFederal Reservehttps://www.treasurydirect.gov4.56%4.41%/united-states/6-month-bill-yield011/9/2023 4:32:00 PM%UNITEDSTA3MONBILYIEUNITEDSTA3MONBILYIE
3126901/9/2023 4:30:00 PMUnited States6 Month Bill Yield6-Month Bill AuctionFederal Reservehttps://www.treasurydirect.gov4.71%4.635%/united-states/3-month-bill-yield011/9/2023 4:32:00 PM%UNITEDSTA6MONBILYIEUNITEDSTA6MONBILYIE
3123161/10/2023 6:00:00 PMUnited States3 Year Note Yield3-Year Note AuctionFederal Reservehttps://www.treasurydirect.gov3.977%4.093%/united-states/3-year-note-yield011/10/2023 6:02:09 PM%UNITEDSTA3YEANOTYIEUNITEDSTA3YEANOTYIE

/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')

te.getCalendarEventsByGroup(group='bonds', country='united states',
 initDate='2016-03-01 00:00:00', endDate='2018-03-03 23:59:59')
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");
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
746333/1/2016 4:30:00 PMUnited States4 Week Bill Yield4-Week Bill Auction3/31/2016 12:00:00 AMFederal Reservehttps://www.treasurydirect.gov0.295%0.285%0.29%/united-states/4-week-bill-yield013/1/2016 4:35:00 PM%UNITEDSTA4WEEBILYIEUNITEDSTA4WEEBILYIE
996253/1/2016 4:30:00 PMUnited States52 Week Bill Yield52-Week Bill AuctionFederal Reservehttps://www.treasurydirect.gov0.660%0.53%/united-states/52-week-bill-yield013/1/2016 4:35:00 PM%UNITEDSTA52WEEBILYIEUNITEDSTA52WEEBILYIE
748693/7/2016 4:30:00 PMUnited States3 Month Bill Yield3-Month Bill Auction3/31/2016 12:00:00 AMFederal Reservehttps://www.treasurydirect.gov0.315%0.325%0.33%/united-states/3-month-bill-yield013/7/2016 4:44:00 PM%UNITEDSTA3MONBILYIEUNITEDSTA3MONBILYIE

Supported Date Formats

Calendar methods described above support string dates in different formats

FormatExample
yyyy-MM-dd2018-01-01
yyyy-mm-dd HH:mm2016-12-03 23:59:59