Economic Calendar by Country

By country

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

import tradingeconomics as te
te.login('your_api_key')
te.getCalendarData(country='united states')

With multi countries:

te.getCalendarData(country=['united states','china'])

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getCalendar(country = 'united states').then(function(data){
    console.log(data)     
});

With multi countries:

data = te.getCalendar(country = ['united states', 'china']).then(function(data){
    console.log(data)     
});

Using Requests:

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states?c=your_api_key"))
    {
        request.Headers.TryAddWithoutValidation("Upgrade-Insecure-Requests", "1");
        var response = await httpClient.SendAsync(request);
        if (response.IsSuccessStatusCode)
        {
            var content = await response.Content.ReadAsStringAsync(); 
            Console.WriteLine(content);
        }
    }
}

With multi countries:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states,china?c=your_api_key");

The response data format can be configured by appending the &f= parameter to the URL request.

/calendar/country/{country}

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

/calendar/country/{country}?f=json

[{"CalendarId":"319275","Date":"2023-04-03T13:45:00","Country":"United States","Category":"Manufacturing PMI","Event":"S&P Global Manufacturing PMI Final","Reference":"Mar","ReferenceDate":"2023-03-31T00:00:00","Source":"Markit Economics","SourceURL":"https://www.markiteconomics.com","Actual":"49.2","Previous":"47.3","Forecast":"49.3","TEForecast":"49.3","URL":"/united-states/manufacturing-pmi","DateSpan":"0","Importance":2,"LastUpdate":"2023-04-03T13:45:00.493","Revised":"","Currency":"","Unit":"","Ticker":"UNITEDSTAMANPMI","Symbol":"UNITEDSTAMANPMI"},{"CalendarId":"319279","Date":"2023-04-03T14:00:00","Country":"United States","Category":"ISM Manufacturing Prices","Event":"ISM Manufacturing Prices","Reference":"Mar","ReferenceDate":"2023-03-31T00:00:00","Source":"Institute for Supply Management","SourceURL":"https://www.ismworld.org","Actual":"49.2","Previous":"51.3","Forecast":"51","TEForecast":"51","URL":"/united-states/ism-manufacturing-prices","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-03T14:00:00.567","Revised":"","Currency":"","Unit":"","Ticker":"USAIMP","Symbol":"USAIMP"},{"CalendarId":"319280","Date":"2023-04-03T14:00:00","Country":"United States","Category":"ISM Manufacturing Employment","Event":"ISM Manufacturing Employment","Reference":"Mar","ReferenceDate":"2023-03-31T00:00:00","Source":"Institute for Supply Management","SourceURL":"https://www.ismworld.org","Actual":"46.9","Previous":"49.1","Forecast":"","TEForecast":"50","URL":"/united-states/ism-manufacturing-employment","DateSpan":"0","Importance":2,"LastUpdate":"2023-04-03T14:00:00.263","Revised":"","Currency":"","Unit":"","Ticker":"USAIME","Symbol":"USAIME"}]

/calendar/country/{country}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
319275,4/3/2023 1:45:00 PM,United States,Manufacturing PMI,S&P Global Manufacturing PMI Final,Mar,3/31/2023 12:00:00 AM,Markit Economics,https://www.markiteconomics.com,49.2,47.3,49.3,49.3,/united-states/manufacturing-pmi,0,2,4/3/2023 1:45:00 PM,,,,UNITEDSTAMANPMI,UNITEDSTAMANPMI
319279,4/3/2023 2:00:00 PM,United States,ISM Manufacturing Prices,ISM Manufacturing Prices,Mar,3/31/2023 12:00:00 AM,Institute for Supply Management,https://www.ismworld.org,49.2,51.3,51,51,/united-states/ism-manufacturing-prices,0,1,4/3/2023 2:00:00 PM,,,,USAIMP,USAIMP
319280,4/3/2023 2:00:00 PM,United States,ISM Manufacturing Employment,ISM Manufacturing Employment,Mar,3/31/2023 12:00:00 AM,Institute for Supply Management,https://www.ismworld.org,46.9,49.1,,50,/united-states/ism-manufacturing-employment,0,2,4/3/2023 2:00:00 PM,,,,USAIME,USAIME

/calendar/country/{country}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>319275</CalendarId>
<Date>2023-04-03T13:45:00</Date>
<Country>United States</Country>
<Category>Manufacturing PMI</Category>
<Event>S&P Global Manufacturing PMI Final</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Markit Economics</Source>
<SourceURL>https://www.markiteconomics.com</SourceURL>
<Actual>49.2</Actual>
<Previous>47.3</Previous>
<Forecast>49.3</Forecast>
<TEForecast>49.3</TEForecast>
<URL>/united-states/manufacturing-pmi</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-03T13:45:00.493</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>UNITEDSTAMANPMI</Ticker>
<Symbol>UNITEDSTAMANPMI</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>319279</CalendarId>
<Date>2023-04-03T14:00:00</Date>
<Country>United States</Country>
<Category>ISM Manufacturing Prices</Category>
<Event>ISM Manufacturing Prices</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Institute for Supply Management</Source>
<SourceURL>https://www.ismworld.org</SourceURL>
<Actual>49.2</Actual>
<Previous>51.3</Previous>
<Forecast>51</Forecast>
<TEForecast>51</TEForecast>
<URL>/united-states/ism-manufacturing-prices</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T14:00:00.567</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>USAIMP</Ticker>
<Symbol>USAIMP</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>319280</CalendarId>
<Date>2023-04-03T14:00:00</Date>
<Country>United States</Country>
<Category>ISM Manufacturing Employment</Category>
<Event>ISM Manufacturing Employment</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Institute for Supply Management</Source>
<SourceURL>https://www.ismworld.org</SourceURL>
<Actual>46.9</Actual>
<Previous>49.1</Previous>
<Forecast/>
<TEForecast>50</TEForecast>
<URL>/united-states/ism-manufacturing-employment</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-03T14:00:00.263</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>USAIME</Ticker>
<Symbol>USAIME</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country='united states', initDate='2016-02-01',
 endDate='2016-02-10')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states', start_date = '2016-02-01',
 end_date = '2016-02-10').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c=guest:guest");

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

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

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=json

[{"CalendarId":"73494","Date":"2016-02-01T13:30:00","Country":"United States","Category":"Personal Income","Event":"Personal Income (MoM)","Reference":"Dec","ReferenceDate":"2015-12-31T00:00:00","Source":"U.S. Bureau of Economic Analysis","SourceURL":"https://www.bea.gov","Actual":"0.3%","Previous":"0.3%","Forecast":"0.2%","TEForecast":"0.2%","URL":"/united-states/personal-income","DateSpan":"0","Importance":3,"LastUpdate":"2016-02-01T13:30:00","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDSTAPERINC","Symbol":"UNITEDSTAPERINC"},{"CalendarId":"73495","Date":"2016-02-01T13:30:00","Country":"United States","Category":"Personal Spending","Event":"Personal Spending MoM","Reference":"Dec","ReferenceDate":"2015-12-31T00:00:00","Source":"U.S. Bureau of Economic Analysis","SourceURL":"https://www.bea.gov","Actual":"0.0%","Previous":"0.5%","Forecast":"0.1%","TEForecast":"0.2%","URL":"/united-states/personal-spending","DateSpan":"0","Importance":3,"LastUpdate":"2016-02-01T13:30:00","Revised":"0.3%","Currency":"","Unit":"%","Ticker":"UNITEDSTAPERSPE","Symbol":"UNITEDSTAPERSPE"},{"CalendarId":"73496","Date":"2016-02-01T13:30:00","Country":"United States","Category":"Core PCE Price Index MoM","Event":"Core PCE Price Index MoM","Reference":"Dec","ReferenceDate":"2015-12-31T00:00:00","Source":"U.S. Bureau of Economic Analysis","SourceURL":"http://www.bea.gov/","Actual":"0.0%","Previous":"0.2%","Forecast":"0.1%","TEForecast":"","URL":"/united-states/core-pce-price-index-mom","DateSpan":"0","Importance":1,"LastUpdate":"2016-02-01T13:39:00","Revised":"0.1%","Currency":"","Unit":"%","Ticker":"USACPPIM","Symbol":"USACPPIM"}]

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
73494,2/1/2016 1:30:00 PM,United States,Personal Income,Personal Income (MoM),Dec,12/31/2015 12:00:00 AM,U.S. Bureau of Economic Analysis,https://www.bea.gov,0.3%,0.3%,0.2%,0.2%,/united-states/personal-income,0,3,2/1/2016 1:30:00 PM,,,%,UNITEDSTAPERINC,UNITEDSTAPERINC
73495,2/1/2016 1:30:00 PM,United States,Personal Spending,Personal Spending MoM,Dec,12/31/2015 12:00:00 AM,U.S. Bureau of Economic Analysis,https://www.bea.gov,0.0%,0.5%,0.1%,0.2%,/united-states/personal-spending,0,3,2/1/2016 1:30:00 PM,0.3%,,%,UNITEDSTAPERSPE,UNITEDSTAPERSPE
73496,2/1/2016 1:30:00 PM,United States,Core PCE Price Index MoM,Core PCE Price Index MoM,Dec,12/31/2015 12:00:00 AM,U.S. Bureau of Economic Analysis,http://www.bea.gov/,0.0%,0.2%,0.1%,,/united-states/core-pce-price-index-mom,0,1,2/1/2016 1:39:00 PM,0.1%,,%,USACPPIM,USACPPIM

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>73494</CalendarId>
<Date>2016-02-01T13:30:00</Date>
<Country>United States</Country>
<Category>Personal Income</Category>
<Event>Personal Income (MoM)</Event>
<Reference>Dec</Reference>
<ReferenceDate>2015-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>https://www.bea.gov</SourceURL>
<Actual>0.3%</Actual>
<Previous>0.3%</Previous>
<Forecast>0.2%</Forecast>
<TEForecast>0.2%</TEForecast>
<URL>/united-states/personal-income</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2016-02-01T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTAPERINC</Ticker>
<Symbol>UNITEDSTAPERINC</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>73495</CalendarId>
<Date>2016-02-01T13:30:00</Date>
<Country>United States</Country>
<Category>Personal Spending</Category>
<Event>Personal Spending MoM</Event>
<Reference>Dec</Reference>
<ReferenceDate>2015-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>https://www.bea.gov</SourceURL>
<Actual>0.0%</Actual>
<Previous>0.5%</Previous>
<Forecast>0.1%</Forecast>
<TEForecast>0.2%</TEForecast>
<URL>/united-states/personal-spending</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2016-02-01T13:30:00</LastUpdate>
<Revised>0.3%</Revised>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTAPERSPE</Ticker>
<Symbol>UNITEDSTAPERSPE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>73496</CalendarId>
<Date>2016-02-01T13:30:00</Date>
<Country>United States</Country>
<Category>Core PCE Price Index MoM</Category>
<Event>Core PCE Price Index MoM</Event>
<Reference>Dec</Reference>
<ReferenceDate>2015-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>http://www.bea.gov/</SourceURL>
<Actual>0.0%</Actual>
<Previous>0.2%</Previous>
<Forecast>0.1%</Forecast>
<TEForecast/>
<URL>/united-states/core-pce-price-index-mom</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-02-01T13:39:00</LastUpdate>
<Revised>0.1%</Revised>
<Currency/>
<Unit>%</Unit>
<Ticker>USACPPIM</Ticker>
<Symbol>USACPPIM</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and importance

importance = (1-Low, 2-Medium, 3-High)

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states?c={api_key}&importance=3'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country='united states', importance='3')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states?c=${api_key}&importance=3`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states', importance='3').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states?c=guest:guest&importance=3");

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

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}?importance={importance}?f=json

[{"CalendarId":"319282","Date":"2023-04-03T14:00:00","Country":"United States","Category":"Business Confidence","Event":"ISM Manufacturing PMI","Reference":"Mar","ReferenceDate":"2023-03-31T00:00:00","Source":"Institute for Supply Management","SourceURL":"https://www.ismworld.org","Actual":"46.3","Previous":"47.7","Forecast":"47.5","TEForecast":"49","URL":"/united-states/business-confidence","DateSpan":"0","Importance":3,"LastUpdate":"2023-04-03T14:00:00.68","Revised":"","Currency":"","Unit":"","Ticker":"NAPMPMI","Symbol":"NAPMPMI"},{"CalendarId":"318971","Date":"2023-04-04T14:00:00","Country":"United States","Category":"Job Offers","Event":"JOLTs Job Openings","Reference":"Feb","ReferenceDate":"2023-02-28T00:00:00","Source":"U.S. Bureau of Labor Statistics","SourceURL":"http://www.bls.gov","Actual":"9.931M","Previous":"10.563M","Forecast":"10.4M","TEForecast":"10.8M","URL":"/united-states/job-offers","DateSpan":"0","Importance":3,"LastUpdate":"2023-04-04T14:05:57.617","Revised":"10.824M","Currency":"","Unit":"M","Ticker":"UNITEDSTAJOBOFF","Symbol":"UNITEDSTAJOBOFF"},{"CalendarId":"319436","Date":"2023-04-05T12:30:00","Country":"United States","Category":"Balance of Trade","Event":"Balance of Trade","Reference":"Feb","ReferenceDate":"2023-02-28T00:00:00","Source":"Bureau of Economic Analysis (BEA)","SourceURL":"https://www.bea.gov","Actual":"$-70.5B","Previous":"$-68.7B","Forecast":"$-69B","TEForecast":"$-69.0B","URL":"/united-states/balance-of-trade","DateSpan":"0","Importance":3,"LastUpdate":"2023-04-05T12:30:00.64","Revised":"$-68.3B","Currency":"$","Unit":"B","Ticker":"USTBTOT","Symbol":"USTBTOT"}]

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

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
319282,4/3/2023 2:00:00 PM,United States,Business Confidence,ISM Manufacturing PMI,Mar,3/31/2023 12:00:00 AM,Institute for Supply Management,https://www.ismworld.org,46.3,47.7,47.5,49,/united-states/business-confidence,0,3,4/3/2023 2:00:00 PM,,,,NAPMPMI,NAPMPMI
318971,4/4/2023 2:00:00 PM,United States,Job Offers,JOLTs Job Openings,Feb,2/28/2023 12:00:00 AM,U.S. Bureau of Labor Statistics,http://www.bls.gov,9.931M,10.563M,10.4M,10.8M,/united-states/job-offers,0,3,4/4/2023 2:05:57 PM,10.824M,,M,UNITEDSTAJOBOFF,UNITEDSTAJOBOFF
319436,4/5/2023 12:30:00 PM,United States,Balance of Trade,Balance of Trade,Feb,2/28/2023 12:00:00 AM,Bureau of Economic Analysis (BEA),https://www.bea.gov,$-70.5B,$-68.7B,$-69B,$-69.0B,/united-states/balance-of-trade,0,3,4/5/2023 12:30:00 PM,$-68.3B,$,B,USTBTOT,USTBTOT

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

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>319282</CalendarId>
<Date>2023-04-03T14:00:00</Date>
<Country>United States</Country>
<Category>Business Confidence</Category>
<Event>ISM Manufacturing PMI</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Institute for Supply Management</Source>
<SourceURL>https://www.ismworld.org</SourceURL>
<Actual>46.3</Actual>
<Previous>47.7</Previous>
<Forecast>47.5</Forecast>
<TEForecast>49</TEForecast>
<URL>/united-states/business-confidence</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2023-04-03T14:00:00.68</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>NAPMPMI</Ticker>
<Symbol>NAPMPMI</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>318971</CalendarId>
<Date>2023-04-04T14:00:00</Date>
<Country>United States</Country>
<Category>Job Offers</Category>
<Event>JOLTs Job Openings</Event>
<Reference>Feb</Reference>
<ReferenceDate>2023-02-28T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Labor Statistics</Source>
<SourceURL>http://www.bls.gov</SourceURL>
<Actual>9.931M</Actual>
<Previous>10.563M</Previous>
<Forecast>10.4M</Forecast>
<TEForecast>10.8M</TEForecast>
<URL>/united-states/job-offers</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2023-04-04T14:05:57.617</LastUpdate>
<Revised>10.824M</Revised>
<Currency/>
<Unit>M</Unit>
<Ticker>UNITEDSTAJOBOFF</Ticker>
<Symbol>UNITEDSTAJOBOFF</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>319436</CalendarId>
<Date>2023-04-05T12:30:00</Date>
<Country>United States</Country>
<Category>Balance of Trade</Category>
<Event>Balance of Trade</Event>
<Reference>Feb</Reference>
<ReferenceDate>2023-02-28T00:00:00</ReferenceDate>
<Source>Bureau of Economic Analysis (BEA)</Source>
<SourceURL>https://www.bea.gov</SourceURL>
<Actual>$-70.5B</Actual>
<Previous>$-68.7B</Previous>
<Forecast>$-69B</Forecast>
<TEForecast>$-69.0B</TEForecast>
<URL>/united-states/balance-of-trade</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2023-04-05T12:30:00.64</LastUpdate>
<Revised>$-68.3B</Revised>
<Currency>$</Currency>
<Unit>B</Unit>
<Ticker>USTBTOT</Ticker>
<Symbol>USTBTOT</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and indicator

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country='united states',
 category='initial jobless claims')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states',
 indicator = 'initial jobless claims').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c=guest:guest");

/calendar/country/{countries}/indicator/{indicators}

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

/calendar/country/{countries}/indicator/{indicators}?f=json

[{"CalendarId":"313158","Date":"2023-04-06T12:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Apr/01","ReferenceDate":"2023-04-01T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"228K","Previous":"246K","Forecast":"200K","TEForecast":"205.0K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2023-04-06T12:30:09.96","Revised":"198K","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"},{"CalendarId":"313203","Date":"2023-04-13T12:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Apr/08","ReferenceDate":"2023-04-08T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"239K","Previous":"228K","Forecast":"232K","TEForecast":"234.0K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2023-04-13T12:30:05.787","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"},{"CalendarId":"313240","Date":"2023-04-20T12:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Apr/15","ReferenceDate":"2023-04-15T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"245K","Previous":"240K","Forecast":"240K","TEForecast":"244.0K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2023-04-20T12:30:02.75","Revised":"239K","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"}]

/calendar/country/{countries}/indicator/{indicators}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
313158,4/6/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/01,4/1/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,228K,246K,200K,205.0K,/united-states/jobless-claims,0,2,4/6/2023 12:30:09 PM,198K,,K,IJCUSA,IJCUSA
313203,4/13/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/08,4/8/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,239K,228K,232K,234.0K,/united-states/jobless-claims,0,2,4/13/2023 12:30:05 PM,,,K,IJCUSA,IJCUSA
313240,4/20/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/15,4/15/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,245K,240K,240K,244.0K,/united-states/jobless-claims,0,2,4/20/2023 12:30:02 PM,239K,,K,IJCUSA,IJCUSA

/calendar/country/{countries}/indicator/{indicators}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>313158</CalendarId>
<Date>2023-04-06T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Apr/01</Reference>
<ReferenceDate>2023-04-01T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>228K</Actual>
<Previous>246K</Previous>
<Forecast>200K</Forecast>
<TEForecast>205.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-06T12:30:09.96</LastUpdate>
<Revised>198K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313203</CalendarId>
<Date>2023-04-13T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Apr/08</Reference>
<ReferenceDate>2023-04-08T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>239K</Actual>
<Previous>228K</Previous>
<Forecast>232K</Forecast>
<TEForecast>234.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-13T12:30:05.787</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313240</CalendarId>
<Date>2023-04-20T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Apr/15</Reference>
<ReferenceDate>2023-04-15T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>245K</Actual>
<Previous>240K</Previous>
<Forecast>240K</Forecast>
<TEForecast>244.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-20T12:30:02.75</LastUpdate>
<Revised>239K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country, indicator and dates

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(category='initial jobless claims', country='united states',
 initDate='2016-12-01', endDate='2017-02-25')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

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)  

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest:guest");

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

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

/calendar/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=json

[{"CalendarId":"87213","Date":"2016-12-01T13:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Nov/26","ReferenceDate":"2016-11-26T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"268K","Previous":"251K","Forecast":"253K","TEForecast":"253.1K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2016-12-01T13:30:00","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"},{"CalendarId":"87229","Date":"2016-12-08T13:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Dec/03","ReferenceDate":"2016-12-03T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"258K","Previous":"268K","Forecast":"258K","TEForecast":"263K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2016-12-08T13:31:00","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"},{"CalendarId":"87240","Date":"2016-12-15T13:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Dec/10","ReferenceDate":"2016-12-10T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"254K","Previous":"258K","Forecast":"255K","TEForecast":"256K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2016-12-15T13:30:00","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"}]

/calendar/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
87213,12/1/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Nov/26,11/26/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,268K,251K,253K,253.1K,/united-states/jobless-claims,0,2,12/1/2016 1:30:00 PM,,,K,IJCUSA,IJCUSA
87229,12/8/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Dec/03,12/3/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,258K,268K,258K,263K,/united-states/jobless-claims,0,2,12/8/2016 1:31:00 PM,,,K,IJCUSA,IJCUSA
87240,12/15/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Dec/10,12/10/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,254K,258K,255K,256K,/united-states/jobless-claims,0,2,12/15/2016 1:30:00 PM,,,K,IJCUSA,IJCUSA

/calendar/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>87213</CalendarId>
<Date>2016-12-01T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Nov/26</Reference>
<ReferenceDate>2016-11-26T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>268K</Actual>
<Previous>251K</Previous>
<Forecast>253K</Forecast>
<TEForecast>253.1K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-01T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>87229</CalendarId>
<Date>2016-12-08T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Dec/03</Reference>
<ReferenceDate>2016-12-03T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>258K</Actual>
<Previous>268K</Previous>
<Forecast>258K</Forecast>
<TEForecast>263K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-08T13:31:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>87240</CalendarId>
<Date>2016-12-15T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Dec/10</Reference>
<ReferenceDate>2016-12-10T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>254K</Actual>
<Previous>258K</Previous>
<Forecast>255K</Forecast>
<TEForecast>256K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-15T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and group

group = (interest rate, inflation, bonds, consumer, gdp, government, housing, labour, markets, money, prices, trade, business)

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarEventsByGroup(country='united states', group='bonds')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendarEventsByGroup(country = 'united states',
 group = 'bonds').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c=guest:guest");

/calendar/country/{country}/group/{group}

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}?f=json

[{"CalendarId":"313137","Date":"2023-04-03T15:30:00","Country":"United States","Category":"3 Month Bill Yield","Event":"3-Month Bill Auction","Reference":"","ReferenceDate":null,"Source":"Federal Reserve","SourceURL":"http://www.treasurydirect.gov","Actual":"4.78%","Previous":"4.675%","Forecast":"","TEForecast":"","URL":"/united-states/3-month-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-03T15:32:15.98","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDSTA3MONBILYIE","Symbol":"UNITEDSTA3MONBILYIE"},{"CalendarId":"313138","Date":"2023-04-03T15:30:00","Country":"United States","Category":"6 Month Bill Yield","Event":"6-Month Bill Auction","Reference":"","ReferenceDate":null,"Source":"Federal Reserve","SourceURL":"http://www.treasurydirect.gov","Actual":"4.705%","Previous":"4.65%","Forecast":"","TEForecast":"","URL":"/united-states/6-month-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-03T15:33:02.4","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDSTA6MONBILYIE","Symbol":"UNITEDSTA6MONBILYIE"},{"CalendarId":"338272","Date":"2023-04-05T15:30:00","Country":"United States","Category":"Calendar","Event":"17-Week Bill Auction","Reference":"","ReferenceDate":null,"Source":"","SourceURL":"","Actual":"4.750%","Previous":"4.780%","Forecast":"","TEForecast":"","URL":"/united-states/calendar","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-05T15:34:42.987","Revised":"","Currency":"","Unit":"%","Ticker":"USD CALENDAR","Symbol":""}]

/calendar/country/{country}/group/{group}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
313137,4/3/2023 3:30:00 PM,United States,3 Month Bill Yield,3-Month Bill Auction,,,Federal Reserve,http://www.treasurydirect.gov,4.78%,4.675%,,,/united-states/3-month-bill-yield,0,1,4/3/2023 3:32:15 PM,,,%,UNITEDSTA3MONBILYIE,UNITEDSTA3MONBILYIE
313138,4/3/2023 3:30:00 PM,United States,6 Month Bill Yield,6-Month Bill Auction,,,Federal Reserve,http://www.treasurydirect.gov,4.705%,4.65%,,,/united-states/6-month-bill-yield,0,1,4/3/2023 3:33:02 PM,,,%,UNITEDSTA6MONBILYIE,UNITEDSTA6MONBILYIE
338272,4/5/2023 3:30:00 PM,United States,Calendar,17-Week Bill Auction,,,,,4.750%,4.780%,,,/united-states/calendar,0,1,4/5/2023 3:34:42 PM,,,%,USD CALENDAR,

/calendar/country/{country}/group/{group}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>313137</CalendarId>
<Date>2023-04-03T15:30:00</Date>
<Country>United States</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Federal Reserve</Source>
<SourceURL>http://www.treasurydirect.gov</SourceURL>
<Actual>4.78%</Actual>
<Previous>4.675%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T15:32:15.98</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA3MONBILYIE</Ticker>
<Symbol>UNITEDSTA3MONBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313138</CalendarId>
<Date>2023-04-03T15:30:00</Date>
<Country>United States</Country>
<Category>6 Month Bill Yield</Category>
<Event>6-Month Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Federal Reserve</Source>
<SourceURL>http://www.treasurydirect.gov</SourceURL>
<Actual>4.705%</Actual>
<Previous>4.65%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/6-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T15:33:02.4</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA6MONBILYIE</Ticker>
<Symbol>UNITEDSTA6MONBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>338272</CalendarId>
<Date>2023-04-05T15:30:00</Date>
<Country>United States</Country>
<Category>Calendar</Category>
<Event>17-Week Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source/>
<SourceURL/>
<Actual>4.750%</Actual>
<Previous>4.780%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/calendar</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-05T15:34:42.987</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>USD CALENDAR</Ticker>
<Symbol/>
</CalendarItem>
</ArrayOfCalendarItem>

By country, group and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarEventsByGroup(group='bonds', country='united states',
 initDate='2016-03-01', endDate='2018-03-03')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendarEventsByGroup(group = 'bonds', country = 'united states',
 start_date = '2016-03-01', end_date = '2018-03-03').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c=guest:guest");

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}

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

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}?f=json

[{"CalendarId":"74633","Date":"2016-03-01T16:30:00","Country":"United States","Category":"4 Week Bill Yield","Event":"4-Week Bill Auction","Reference":"","ReferenceDate":"2016-03-31T00:00:00","Source":"Federal Reserve","SourceURL":"https://www.treasurydirect.gov","Actual":"0.295%","Previous":"0.285%","Forecast":"","TEForecast":"0.29%","URL":"/united-states/4-week-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2016-03-01T16:35:00","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDSTA4WEEBILYIE","Symbol":"UNITEDSTA4WEEBILYIE"},{"CalendarId":"99625","Date":"2016-03-01T16:30:00","Country":"United States","Category":"52 Week Bill Yield","Event":"52-Week Bill Auction","Reference":"","ReferenceDate":null,"Source":"Federal Reserve","SourceURL":"https://www.treasurydirect.gov","Actual":"0.660%","Previous":"0.53%","Forecast":"","TEForecast":"","URL":"/united-states/52-week-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2016-03-01T16:35:00","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDSTA52WEEBILYIE","Symbol":"UNITEDSTA52WEEBILYIE"},{"CalendarId":"74869","Date":"2016-03-07T16:30:00","Country":"United States","Category":"3 Month Bill Yield","Event":"3-Month Bill Auction","Reference":"","ReferenceDate":"2016-03-31T00:00:00","Source":"Federal Reserve","SourceURL":"http://www.treasurydirect.gov","Actual":"0.315%","Previous":"0.325%","Forecast":"","TEForecast":"0.33%","URL":"/united-states/3-month-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2016-03-07T16:44:00","Revised":"","Currency":"","Unit":"%","Ticker":"UNITEDSTA3MONBILYIE","Symbol":"UNITEDSTA3MONBILYIE"}]

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
74633,3/1/2016 4:30:00 PM,United States,4 Week Bill Yield,4-Week Bill Auction,,3/31/2016 12:00:00 AM,Federal Reserve,https://www.treasurydirect.gov,0.295%,0.285%,,0.29%,/united-states/4-week-bill-yield,0,1,3/1/2016 4:35:00 PM,,,%,UNITEDSTA4WEEBILYIE,UNITEDSTA4WEEBILYIE
99625,3/1/2016 4:30:00 PM,United States,52 Week Bill Yield,52-Week Bill Auction,,,Federal Reserve,https://www.treasurydirect.gov,0.660%,0.53%,,,/united-states/52-week-bill-yield,0,1,3/1/2016 4:35:00 PM,,,%,UNITEDSTA52WEEBILYIE,UNITEDSTA52WEEBILYIE
74869,3/7/2016 4:30:00 PM,United States,3 Month Bill Yield,3-Month Bill Auction,,3/31/2016 12:00:00 AM,Federal Reserve,http://www.treasurydirect.gov,0.315%,0.325%,,0.33%,/united-states/3-month-bill-yield,0,1,3/7/2016 4:44:00 PM,,,%,UNITEDSTA3MONBILYIE,UNITEDSTA3MONBILYIE

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>74633</CalendarId>
<Date>2016-03-01T16:30:00</Date>
<Country>United States</Country>
<Category>4 Week Bill Yield</Category>
<Event>4-Week Bill Auction</Event>
<Reference/>
<ReferenceDate>2016-03-31T00:00:00</ReferenceDate>
<Source>Federal Reserve</Source>
<SourceURL>https://www.treasurydirect.gov</SourceURL>
<Actual>0.295%</Actual>
<Previous>0.285%</Previous>
<Forecast/>
<TEForecast>0.29%</TEForecast>
<URL>/united-states/4-week-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-01T16:35:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA4WEEBILYIE</Ticker>
<Symbol>UNITEDSTA4WEEBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>99625</CalendarId>
<Date>2016-03-01T16:30:00</Date>
<Country>United States</Country>
<Category>52 Week Bill Yield</Category>
<Event>52-Week Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Federal Reserve</Source>
<SourceURL>https://www.treasurydirect.gov</SourceURL>
<Actual>0.660%</Actual>
<Previous>0.53%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/52-week-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-01T16:35:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA52WEEBILYIE</Ticker>
<Symbol>UNITEDSTA52WEEBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>74869</CalendarId>
<Date>2016-03-07T16:30:00</Date>
<Country>United States</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month Bill Auction</Event>
<Reference/>
<ReferenceDate>2016-03-31T00:00:00</ReferenceDate>
<Source>Federal Reserve</Source>
<SourceURL>http://www.treasurydirect.gov</SourceURL>
<Actual>0.315%</Actual>
<Previous>0.325%</Previous>
<Forecast/>
<TEForecast>0.33%</TEForecast>
<URL>/united-states/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-07T16:44:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA3MONBILYIE</Ticker>
<Symbol>UNITEDSTA3MONBILYIE</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

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