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}&f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>314100</CalendarId>
<Date>2023-09-28T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Sep/23</Reference>
<ReferenceDate>2023-09-23T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>204K</Actual>
<Previous>202K</Previous>
<Forecast>215K</Forecast>
<TEForecast>205K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-09-28T12:30:06.72</LastUpdate>
<Revised>201K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>314067</CalendarId>
<Date>2023-09-21T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Sep/16</Reference>
<ReferenceDate>2023-09-16T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>201K</Actual>
<Previous>221K</Previous>
<Forecast>225K</Forecast>
<TEForecast>222.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-09-21T12:30:09.16</LastUpdate>
<Revised>220K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>314027</CalendarId>
<Date>2023-09-14T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Sep/09</Reference>
<ReferenceDate>2023-09-09T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>220K</Actual>
<Previous>217K</Previous>
<Forecast>225K</Forecast>
<TEForecast>221.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-09-14T12:30:13.403</LastUpdate>
<Revised>216K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

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}&f=xml

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

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