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
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/calendar/group/bonds?c={your_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 your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/group/bonds?c=${your_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.

https://api.tradingeconomics.com/calendar/group/{group}?c={your_api_key}&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"
  }
]

https://api.tradingeconomics.com/calendar/group/{group}?c={your_api_key}&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

https://api.tradingeconomics.com/calendar/group/{group}?c={your_api_key}
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

By group and date

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/calendar/group/bonds/2016-03-01/2018-03-03?c={your_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 your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/group/bonds/2016-03-01/2018-03-03?c=${your_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=your_api_key");

https://api.tradingeconomics.com/calendar/group/{group}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}&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"
  }
]

https://api.tradingeconomics.com/calendar/group/{group}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}&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

https://api.tradingeconomics.com/calendar/group/{group}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}
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

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