Economic Calendar by Group

This endpoint facilitates retrieving a filtered snapshot by groups 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}

CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3364971/9/2023 10:45:00 AMEuropean UnionCalendar20-Year Bond Auction3.128%2.845%/european-union/calendar011/9/2023 10:54:57 AM%EUROPEANUCALEUROPEANUCAL
3371241/9/2023 10:45:00 AMEuropean UnionCalendar3-Year Bond Auction2.827%2.530%/european-union/calendar011/9/2023 10:54:48 AM%EUROPEANUCALEUROPEANUCAL
3126861/9/2023 2:00:00 PMFrance3 Month Bill Yield3-Month BTF AuctionAgence France Trésorhttps://www.aft.gouv.fr2.164%2.096%/france/3-month-bill-yield011/9/2023 1:58:35 PM%FRANCE3MONBILYIEFRANCE3MONBILYIE

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

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
889563/2/2016 10:40:00 AMGermany5 Year Note Yield5-Year Bobl AuctionDepartment of Treasuryhttps://www.deutsche-finanzagentur.de-0.360%-0.240%/germany/5-year-note-yield013/2/2016 10:43:00 AM%GERMANY5YNYGERMANY5YNY

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