Economic Calendar by Group

This endpoint facilitates retrieving a filtered snapshot by countries from the economic calendar. The data can be filtered by groups: interest rates, inflation, bonds, consumer, GDP, government, housing, labor, markets, money, prices, trade, and business.

By group

Using Requests:

                     
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/group/bonds?c={api_key}'

data = requests.get(url).json()
print(data)

Or using our package:

                     
import tradingeconomics as te
te.login('your_api_key')
te.getCalendarEventsByGroup(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/group/bonds?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

                     
const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getCalendarEventsByGroup(group = 'bonds').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/group/bonds?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);
        }
    }
}

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

/calendar/group/{group}

CalendarId	Date	Country	Category	Event	Source	SourceURL	Actual	Previous	URL	Importance	LastUpdate	Unit	Ticker	Symbol
336497	1/9/2023 10:45:00 AM	European Union	Calendar	20-Year Bond Auction			3.128%	2.845%	/european-union/calendar	1	1/9/2023 10:54:57 AM	%	EUROPEANUCAL	EUROPEANUCAL
337124	1/9/2023 10:45:00 AM	European Union	Calendar	3-Year Bond Auction			2.827%	2.530%	/european-union/calendar	1	1/9/2023 10:54:48 AM	%	EUROPEANUCAL	EUROPEANUCAL
312686	1/9/2023 2:00:00 PM	France	3 Month Bill Yield	3-Month BTF Auction	Agence France Trésor	https://www.aft.gouv.fr	2.164%	2.096%	/france/3-month-bill-yield	1	1/9/2023 1:58:35 PM	%	FRANCE3MONBILYIE	FRANCE3MONBILYIE

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

                     
[{"CalendarId":"337874","Date":"2023-04-03T03:35:00","Country":"Japan","Category":"3 Month Bill Yield","Event":"3-Month Bill Auction","Reference":"","ReferenceDate":null,"Source":"","SourceURL":"","Actual":"-0.1681%","Previous":"-0.2292%","Forecast":"","TEForecast":"","URL":"/japan/3-month-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-03T03:32:11.24","Revised":"","Currency":"","Unit":"%","Ticker":"GJGB3M","Symbol":"GJGB3M"},{"CalendarId":"335151","Date":"2023-04-03T09:30:00","Country":"Germany","Category":"3 Month Bill Yield","Event":"3-Month Bubill Auction","Reference":"","ReferenceDate":null,"Source":"","SourceURL":"","Actual":"2.8344%","Previous":"2.8607%","Forecast":"","TEForecast":"","URL":"/germany/3-month-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-03T09:39:12.837","Revised":"","Currency":"","Unit":"%","Ticker":"GDBR3M","Symbol":"GDBR3M"},{"CalendarId":"313134","Date":"2023-04-03T13:00:00","Country":"France","Category":"3 Month Bill Yield","Event":"3-Month BTF Auction","Reference":"","ReferenceDate":null,"Source":"Agence France Trésor","SourceURL":"https://www.aft.gouv.fr","Actual":"2.881%","Previous":"2.804%","Forecast":"","TEForecast":"","URL":"/france/3-month-bill-yield","DateSpan":"0","Importance":1,"LastUpdate":"2023-04-03T13:02:19.34","Revised":"","Currency":"","Unit":"%","Ticker":"FRANCE3MONBILYIE","Symbol":"FRANCE3MONBILYIE"}]

/calendar/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
337874,4/3/2023 3:35:00 AM,Japan,3 Month Bill Yield,3-Month Bill Auction,,,,,-0.1681%,-0.2292%,,,/japan/3-month-bill-yield,0,1,4/3/2023 3:32:11 AM,,,%,GJGB3M,GJGB3M
335151,4/3/2023 9:30:00 AM,Germany,3 Month Bill Yield,3-Month Bubill Auction,,,,,2.8344%,2.8607%,,,/germany/3-month-bill-yield,0,1,4/3/2023 9:39:12 AM,,,%,GDBR3M,GDBR3M
313134,4/3/2023 1:00:00 PM,France,3 Month Bill Yield,3-Month BTF Auction,,,Agence France Trésor,https://www.aft.gouv.fr,2.881%,2.804%,,,/france/3-month-bill-yield,0,1,4/3/2023 1:02:19 PM,,,%,FRANCE3MONBILYIE,FRANCE3MONBILYIE

/calendar/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>337874</CalendarId>
<Date>2023-04-03T03:35:00</Date>
<Country>Japan</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source/>
<SourceURL/>
<Actual>-0.1681%</Actual>
<Previous>-0.2292%</Previous>
<Forecast/>
<TEForecast/>
<URL>/japan/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T03:32:11.24</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>GJGB3M</Ticker>
<Symbol>GJGB3M</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>335151</CalendarId>
<Date>2023-04-03T09:30:00</Date>
<Country>Germany</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month Bubill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source/>
<SourceURL/>
<Actual>2.8344%</Actual>
<Previous>2.8607%</Previous>
<Forecast/>
<TEForecast/>
<URL>/germany/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T09:39:12.837</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>GDBR3M</Ticker>
<Symbol>GDBR3M</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313134</CalendarId>
<Date>2023-04-03T13:00:00</Date>
<Country>France</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month BTF Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Agence France Trésor</Source>
<SourceURL>https://www.aft.gouv.fr</SourceURL>
<Actual>2.881%</Actual>
<Previous>2.804%</Previous>
<Forecast/>
<TEForecast/>
<URL>/france/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T13:02:19.34</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>FRANCE3MONBILYIE</Ticker>
<Symbol>FRANCE3MONBILYIE</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By group and date

Using Requests:

                     
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/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', 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/group/bonds/2016-03-01/2018-03-03?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

                     
data = te.getCalendarEventsByGroup(group = 'bonds', 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/group/bonds/2016-03-01/2018-03-03?c=guest:guest");

/calendar/group/{group}/{yyyy-mm-dd}/{yyyy-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
88956	3/2/2016 10:40:00 AM	Germany	5 Year Note Yield	5-Year Bobl Auction		Department of Treasury	https://www.deutsche-finanzagentur.de	-0.360%	-0.240%		/germany/5-year-note-yield	1	3/2/2016 10:43:00 AM	%	GERMANY5YNY	GERMANY5YNY

/calendar/group/{group}/{yyyy-mm-dd}/{yyyy-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":"88956","Date":"2016-03-02T10:40:00","Country":"Germany","Category":"5 Year Note Yield","Event":"5-Year Bobl Auction","Reference":"","ReferenceDate":null,"Source":"Department of Treasury","SourceURL":"https://www.deutsche-finanzagentur.de","Actual":"-0.360%","Previous":"-0.240%","Forecast":"","TEForecast":"","URL":"/germany/5-year-note-yield","DateSpan":"0","Importance":1,"LastUpdate":"2016-03-02T10:43:00","Revised":"","Currency":"","Unit":"%","Ticker":"GERMANY5YNY","Symbol":"GERMANY5YNY"}]

/calendar/group/{group}/{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
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
88956,3/2/2016 10:40:00 AM,Germany,5 Year Note Yield,5-Year Bobl Auction,,,Department of Treasury,https://www.deutsche-finanzagentur.de,-0.360%,-0.240%,,,/germany/5-year-note-yield,0,1,3/2/2016 10:43:00 AM,,,%,GERMANY5YNY,GERMANY5YNY

/calendar/group/{group}/{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>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>88956</CalendarId>
<Date>2016-03-02T10:40:00</Date>
<Country>Germany</Country>
<Category>5 Year Note Yield</Category>
<Event>5-Year Bobl Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Department of Treasury</Source>
<SourceURL>https://www.deutsche-finanzagentur.de</SourceURL>
<Actual>-0.360%</Actual>
<Previous>-0.240%</Previous>
<Forecast/>
<TEForecast/>
<URL>/germany/5-year-note-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-02T10:43:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>GERMANY5YNY</Ticker>
<Symbol>GERMANY5YNY</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