Economic Calendar by Country

This endpoint facilitates retrieving a filtered snapshot by countries from the economic calendar.

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}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Currency	Unit	Ticker	Symbol
314956	1/5/2023 12:30:00 PM	United States	Challenger Job Cuts	Challenger Job Cuts	Dec	12/31/2022 12:00:00 AM	“Challenger, Gray and Christmas, Inc.”	https://www.challengergray.com	43.651K	76.835K		33K	/united-states/challenger-job-cuts	1	1/5/2023 12:30:00 PM			K	UNITEDSTACHAJOBCUT	UNITEDSTACHAJOBCUT
314792	1/5/2023 1:15:00 PM	United States	ADP Employment Change	ADP Employment Change	Dec	12/31/2022 12:00:00 AM	“Automatic Data Processing, Inc.”	https://adpemploymentreport.com/	235K	182K	150K	150K	/united-states/adp-employment-change	2	1/5/2023 1:31:54 PM	127K		K	UNITEDSTAADPEMPCHA	UNITEDSTAADPEMPCHA
314974	1/5/2023 1:30:00 PM	United States	Exports	Exports	Nov	11/30/2022 12:00:00 AM	U.S. Census Bureau	https://www.census.gov	$251.9B	$256.9B		$251.4B	/united-states/exports	2	1/5/2023 1:31:59 PM	$256.6B	$	B	TBEXTOT	TBEXTOT

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

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	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	3	2/1/2016 1:30:00 PM		%	UNITEDSTAPERINC	UNITEDSTAPERINC
73495	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.0%	0.5%	0.1%	0.2%	/united-states/personal-spending	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	https://www.bea.gov/	0.0%	0.2%	0.1%		/united-states/core-pce-price-index-mom	1	2/1/2016 1:39:00 PM	0.1%	%	USACPPIM	USACPPIM

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

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
312678	1/6/2023 1:30:00 PM	United States	Non Farm Payrolls	Non Farm Payrolls	Dec	12/31/2022 12:00:00 AM	U.S. Bureau of Labor Statistics	https://www.bls.gov/	223K	256K	200K	220K	/united-states/non-farm-payrolls	3	1/6/2023 1:30:05 PM	263K	K	NFP TCH	NFP TCH
312679	1/6/2023 1:30:00 PM	United States	Unemployment Rate	Unemployment Rate	Dec	12/31/2022 12:00:00 AM	U.S. Bureau of Labor Statistics	https://www.bls.gov/	3.5%	3.6%	3.7%	3.7%	/united-states/unemployment-rate	3	1/6/2023 1:30:04 PM	3.7%	%	USURTOT	USURTOT
314984	1/6/2023 3:00:00 PM	United States	Non Manufacturing PMI	ISM Non-Manufacturing PMI	Dec	12/31/2022 12:00:00 AM	Institute for Supply Management	https://www.ismworld.org	49.6	56.5	55	53	/united-states/non-manufacturing-pmi	3	1/6/2023 3:00:00 PM			UNITEDSTANONMANPMI	UNITEDSTANONMANPMI

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

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
312710	1/12/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/07	1/7/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	205K	206K	215K	215K	/united-states/jobless-claims	2	1/12/2023 1:30:33 PM	204K	K	IJCUSA	IJCUSA
312752	1/19/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/14	1/14/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	190K	205K	214K	207K	/united-states/jobless-claims	2	1/19/2023 1:30:17 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	186K	192K	205K	202K	/united-states/jobless-claims	2	1/26/2023 1:30:02 PM	190K	K	IJCUSA	IJCUSA

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

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	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	https://www.dol.gov	268K	251K	253K	253.1K	/united-states/jobless-claims	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	https://www.dol.gov	258K	268K	258K	263K	/united-states/jobless-claims	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	https://www.dol.gov	254K	258K	255K	256K	/united-states/jobless-claims	2	12/15/2016 1:30:00 PM	K	IJCUSA	IJCUSA

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

CalendarId	Date	Country	Category	Event	Source	SourceURL	Actual	Previous	URL	Importance	LastUpdate	Unit	Ticker	Symbol
312689	1/9/2023 4:30:00 PM	United States	3 Month Bill Yield	3-Month Bill Auction	Federal Reserve	https://www.treasurydirect.gov	4.56%	4.41%	/united-states/6-month-bill-yield	1	1/9/2023 4:32:00 PM	%	UNITEDSTA3MONBILYIE	UNITEDSTA3MONBILYIE
312690	1/9/2023 4:30:00 PM	United States	6 Month Bill Yield	6-Month Bill Auction	Federal Reserve	https://www.treasurydirect.gov	4.71%	4.635%	/united-states/3-month-bill-yield	1	1/9/2023 4:32:00 PM	%	UNITEDSTA6MONBILYIE	UNITEDSTA6MONBILYIE
312316	1/10/2023 6:00:00 PM	United States	3 Year Note Yield	3-Year Note Auction	Federal Reserve	https://www.treasurydirect.gov	3.977%	4.093%	/united-states/3-year-note-yield	1	1/10/2023 6:02:09 PM	%	UNITEDSTA3YEANOTYIE	UNITEDSTA3YEANOTYIE

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

CalendarId	Date	Country	Category	Event	ReferenceDate	Source	SourceURL	Actual	Previous	TEForecast	URL	Importance	LastUpdate	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	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	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	https://www.treasurydirect.gov	0.315%	0.325%	0.33%	/united-states/3-month-bill-yield	1	3/7/2016 4:44:00 PM	%	UNITEDSTA3MONBILYIE	UNITEDSTA3MONBILYIE

/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 Format	Example
yyyy-MM-dd	2018-01-01
yyyy-mm-dd HH:mm	2016-12-03 23:59:59