Economic Calendar by Ticker

This endpoint enables the retrieval of a filtered snapshot by ticker from the economic calendar.

By ticker

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD?c={your_api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(ticker = 'IJCUSA')

With multi tickers:

te.getCalendarData(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'])

Using Requests:

const axios = require('axios');
(async () => {

    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD?c=${your_api_key}`)
    console.log(response.data)

})()

Or using our package:

data = te.getCalendar(ticker = 'IJCUSA').then(function(data){
    console.log(data)     
});

With multi tickers:

data = te.getCalendar(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE']).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/ticker/IJCUSA?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 tickers:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE?c=your_api_key");

https://api.tradingeconomics.com/calendar/ticker/{ticker}?c={your_api_key}&f=json

[
  {
    "CalendarId": "314100",
    "Date": "2023-09-28T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Sep/23",
    "ReferenceDate": "2023-09-23T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "204K",
    "Previous": "202K",
    "Forecast": "215K",
    "TEForecast": "205K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-09-28T12:30:06.72",
    "Revised": "201K",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "314067",
    "Date": "2023-09-21T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Sep/16",
    "ReferenceDate": "2023-09-16T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "201K",
    "Previous": "221K",
    "Forecast": "225K",
    "TEForecast": "222.0K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-09-21T12:30:09.16",
    "Revised": "220K",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "314027",
    "Date": "2023-09-14T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Sep/09",
    "ReferenceDate": "2023-09-09T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "220K",
    "Previous": "217K",
    "Forecast": "225K",
    "TEForecast": "221.0K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-09-14T12:30:13.403",
    "Revised": "216K",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  }
]

https://api.tradingeconomics.com/calendar/ticker/{ticker}?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
314100,9/28/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Sep/23,9/23/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,204K,202K,215K,205K,/united-states/jobless-claims,0,2,9/28/2023 12:30:06 PM,201K,,K,IJCUSA,IJCUSA
314067,9/21/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Sep/16,9/16/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,201K,221K,225K,222.0K,/united-states/jobless-claims,0,2,9/21/2023 12:30:09 PM,220K,,K,IJCUSA,IJCUSA
314027,9/14/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Sep/09,9/9/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,220K,217K,225K,221.0K,/united-states/jobless-claims,0,2,9/14/2023 12:30:13 PM,216K,,K,IJCUSA,IJCUSA

https://api.tradingeconomics.com/calendar/ticker/{ticker}?c={your_api_key}
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3136096/29/2023 12:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJun/246/24/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov239K265K265K266.0K/united-states/jobless-claims026/29/2023 12:30:20 PM264KKIJCUSAIJCUSA
3135786/22/2023 12:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJun/176/17/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov264K264K260K271.0K/united-states/jobless-claims026/22/2023 12:30:35 PM262KKIJCUSAIJCUSA
3135406/15/2023 12:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJun/106/10/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov262K262K249K275.0K/united-states/jobless-claims026/15/2023 12:30:41 PM261KKIJCUSAIJCUSA

By ticker and date

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE/2018-01-01/2018-03-01?c={your_api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'],
 initDate='2018-01-01', endDate='2018-03-01')

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE/2018-01-01/2018-03-01?c=${your_api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(ticker = ['IJCUSA', 'SPAINFACORD', 'BAHRAININFNRATE'],
 start_date = '2018-01-01',end_date = '2018-03-01').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE/2018-01-01/2018-03-01?c=your_api_key");

https://api.tradingeconomics.com/calendar/ticker/{ticker}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}&f=json

[
  {
    "CalendarId": "313272",
    "Date": "2023-04-27T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Apr/22",
    "ReferenceDate": "2023-04-22T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "230K",
    "Previous": "246K",
    "Forecast": "248K",
    "TEForecast": "249.0K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-04-27T12:30:01.413",
    "Revised": "245K",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "320371",
    "Date": "2023-04-27T12:00:00",
    "Country": "Bahrain",
    "Category": "Inflation Rate",
    "Event": "Inflation Rate YoY",
    "Reference": "Mar",
    "ReferenceDate": "2023-03-31T00:00:00",
    "Source": "Central Informatics Organisation - Kingdom of Bahrain",
    "SourceURL": "http://www.data.gov.bh",
    "Actual": "-0.1%",
    "Previous": "1.1%",
    "Forecast": "",
    "TEForecast": "0.5%",
    "URL": "/bahrain/inflation-cpi",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2023-04-27T12:00:33.17",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "BAHRAININFNRATE",
    "Symbol": "BAHRAININFNRATE"
  },
  {
    "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"
  }
]

https://api.tradingeconomics.com/calendar/ticker/{ticker}/{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
313272,4/27/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/22,4/22/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,230K,246K,248K,249.0K,/united-states/jobless-claims,0,2,4/27/2023 12:30:01 PM,245K,,K,IJCUSA,IJCUSA
320371,4/27/2023 12:00:00 PM,Bahrain,Inflation Rate,Inflation Rate YoY,Mar,3/31/2023 12:00:00 AM,Central Informatics Organisation - Kingdom of Bahrain,http://www.data.gov.bh,-0.1%,1.1%,,0.5%,/bahrain/inflation-cpi,0,1,4/27/2023 12:00:33 PM,,,%,BAHRAININFNRATE,BAHRAININFNRATE
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

https://api.tradingeconomics.com/calendar/ticker/{ticker}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
3128212/2/2023 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsJan/281/28/2023 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov186K192K205K202K/united-states/jobless-claims022/2/2023 1:30:20 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.gov183K186K200K187.0K/united-states/jobless-claims021/26/2023 1:30:02 PM190KKIJCUSAIJCUSA
3159681/26/2023 12:00:00 PMBahrainInflation RateInflation Rate YoYDec12/31/2022 12:00:00 AMCentral Informatics Organisation - Kingdom of Bahrainhttps://www.data.gov.bh3.6%3.9%3.8%/bahrain/inflation-cpi011/26/2023 12:01:22 PM%BAHRAININFNRATEBAHRAININFNRATE

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