Economic Calendar Point-in-Time

Point-in-time data lets you retrieve economic calendar events exactly as they appeared on a specific date, preserving the original values before any subsequent revisions. This is essential for backtesting models, auditing past forecasts, and building accurate historical datasets — ensuring your analysis reflects the information that was actually available at any given moment.

Use the initDate and endDate parameters to define the date range for your request. All calendar methods below accept string dates in the following formats:

Date FormatExample
yyyy-MM-dd2018-01-01
yyyy-mm-dd HH:mm2016-12-03 23:59:59

Point in time

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c={your_api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(category='initial jobless claims', country='united states',
 initDate='2016-12-01', endDate='2017-02-25')

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=${your_api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(indicator = 'initial jobless claims', country = 'united states',
 start_date = '2016-12-01', end_date = '2017-02-25').then(function(data){
    console.log(data)

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=your_api_key");

https://api.tradingeconomics.com/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?c={your_api_key}&f=json

[
  {
    "CalendarId": "87213",
    "Date": "2016-12-01T13:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Nov/26",
    "ReferenceDate": "2016-11-26T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "268K",
    "Previous": "251K",
    "Forecast": "253K",
    "TEForecast": "253.1K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2016-12-01T13:30:00",
    "Revised": "",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "87229",
    "Date": "2016-12-08T13:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Dec/03",
    "ReferenceDate": "2016-12-03T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "258K",
    "Previous": "268K",
    "Forecast": "258K",
    "TEForecast": "263K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2016-12-08T13:31:00",
    "Revised": "",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "87240",
    "Date": "2016-12-15T13:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Dec/10",
    "ReferenceDate": "2016-12-10T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "254K",
    "Previous": "258K",
    "Forecast": "255K",
    "TEForecast": "256K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2016-12-15T13:30:00",
    "Revised": "",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  }
]

https://api.tradingeconomics.com/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?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
87213,12/1/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Nov/26,11/26/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,268K,251K,253K,253.1K,/united-states/jobless-claims,0,2,12/1/2016 1:30:00 PM,,,K,IJCUSA,IJCUSA
87229,12/8/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Dec/03,12/3/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,258K,268K,258K,263K,/united-states/jobless-claims,0,2,12/8/2016 1:31:00 PM,,,K,IJCUSA,IJCUSA
87240,12/15/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Dec/10,12/10/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,254K,258K,255K,256K,/united-states/jobless-claims,0,2,12/15/2016 1:30:00 PM,,,K,IJCUSA,IJCUSA

https://api.tradingeconomics.com/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?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>87213</CalendarId>
<Date>2016-12-01T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Nov/26</Reference>
<ReferenceDate>2016-11-26T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>268K</Actual>
<Previous>251K</Previous>
<Forecast>253K</Forecast>
<TEForecast>253.1K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-01T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>87229</CalendarId>
<Date>2016-12-08T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Dec/03</Reference>
<ReferenceDate>2016-12-03T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>258K</Actual>
<Previous>268K</Previous>
<Forecast>258K</Forecast>
<TEForecast>263K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-08T13:31:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>87240</CalendarId>
<Date>2016-12-15T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Dec/10</Reference>
<ReferenceDate>2016-12-10T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>254K</Actual>
<Previous>258K</Previous>
<Forecast>255K</Forecast>
<TEForecast>256K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-15T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

https://api.tradingeconomics.com/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?c={your_api_key}
CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
8721312/1/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsNov/2611/26/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov268K251K253K253.1K/united-states/jobless-claims0212/1/2016 1:30:00 PMKIJCUSAIJCUSA
8722912/8/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsDec/0312/3/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov258K268K258K263K/united-states/jobless-claims0212/8/2016 1:31:00 PMKIJCUSAIJCUSA
8724012/15/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsDec/1012/10/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov254K258K255K256K/united-states/jobless-claims0212/15/2016 1:30:00 PMKIJCUSAIJCUSA