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
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD?c={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 api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD?c=${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");

/calendar/ticker/{ticker}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
313609	6/29/2023 12:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jun/24	6/24/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	239K	265K	265K	266.0K	/united-states/jobless-claims	2	6/29/2023 12:30:20 PM	264K	K	IJCUSA	IJCUSA
313578	6/22/2023 12:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jun/17	6/17/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	264K	264K	260K	271.0K	/united-states/jobless-claims	2	6/22/2023 12:30:35 PM	262K	K	IJCUSA	IJCUSA
313540	6/15/2023 12:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jun/10	6/10/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	262K	262K	249K	275.0K	/united-states/jobless-claims	2	6/15/2023 12:30:41 PM	261K	K	IJCUSA	IJCUSA

/calendar/ticker/{ticker}?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"}]

/calendar/ticker/{ticker}?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

/calendar/ticker/{ticker}?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>

By ticker and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/ticker/IJCUSA,SPAINFACORD,BAHRAININFNRATE/2018-01-01/2018-03-01?c={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 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=${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=guest:guest");

/calendar/ticker/{ticker}/{yyyy-mm-dd}/{yyyy-mm-dd}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
312821	2/2/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/28	1/28/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	186K	192K	205K	202K	/united-states/jobless-claims	2	2/2/2023 1:30:20 PM		K	IJCUSA	IJCUSA
312784	1/26/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/21	1/21/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	183K	186K	200K	187.0K	/united-states/jobless-claims	2	1/26/2023 1:30:02 PM	190K	K	IJCUSA	IJCUSA
315968	1/26/2023 12:00:00 PM	Bahrain	Inflation Rate	Inflation Rate YoY	Dec	12/31/2022 12:00:00 AM	Central Informatics Organisation - Kingdom of Bahrain	https://www.data.gov.bh	3.6%	3.9%		3.8%	/bahrain/inflation-cpi	1	1/26/2023 12:01:22 PM		%	BAHRAININFNRATE	BAHRAININFNRATE

/calendar/ticker/{ticker}/{yyyy-mm-dd}/{yyyy-mm-dd}?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"}]

/calendar/ticker/{ticker}/{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
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

/calendar/ticker/{ticker}/{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>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>

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