With our Financial Calendar data feed, we provide data about upcoming earnings, IPOs, and splits. If you are looking for an economic calendar, which includes an earnings calendar and IPOs calendar, this API is for you.

To get access to Calendar API you should be subscribed either to Calendar API or to the ‘All-In-One’ data package, which includes all possible data feeds we have. More information with prices you can get on our main page.

For IPOs we have dated from January 2015 and up to 2-3 weeks in the future. For splits, we have data from January 2015 up to several months in the future and full historical data is provided under our Splits and Dividends API. And for earnings, we have data from the beginning and up to several months in the future.

Upcoming Earnings API

Basic URL to access

https://eodhistoricaldata.com/api/calendar/earnings

Parameters

  • api_token: REQUIRED. Your api_token to access the API. You will get it after registration.
  • from: OPTIONAL. Format: YYYY-MM-DD. The start date for earnings data, if not provided, today will be used.
  • to: OPTIONAL. Format: YYYY-MM-DD. The end date for earnings data, if not provided, today + 7 days will be used.
  • symbols: OPTIONAL. You can request specific symbols to get historical and upcoming data. If ‘symbols’ used, then ‘from’ and ‘to’ parameters will be ignored. You can use one symbol: ‘AAPL.US’ or several symbols separated by a comma: ‘AAPL.US, MS’
  • fmt: OPTIONAL. Output format, possible values: ‘csv’ – for CSV output and ‘json’ – for JSON output. Default value is ‘csv’.

Examples

An example to get all earnings from December 2, 2018, to December 6, 2018, in JSON format:

https://eodhistoricaldata.com/api/calendar/earnings?api_token=YOUR_API_KEY&fmt=json&from=2018-12-02&to=2018-12-06

An example to get all earnings, including historical and upcoming, for AAPL.US, MSFT.US, and AI.PA from January 2018:

https://eodhistoricaldata.com/api/calendar/earnings?api_token=YOUR_API_KEY&fmt=json&symbols=AAPL.US,MSFT.US,AI.PA&from=2018-01-01

Output

An example output in CSV format you can download here:

  • All earnings from December 2, 2018, to December 6, 2018
  • All earnings, including historical and upcoming, for AAPL.US, MSFT.US, and AI.PA

Earnings Trends API

Basic URL to access 

https://eodhistoricaldata.com/api/calendar/trends

Parameters

  • api_token: REQUIRED. Your api_token to access the API. You will get it after registration.
  • symbols: REQUIRED. You can request specific symbols to get historical and upcoming data. If ‘symbols’ used, then ‘from’ and ‘to’ parameters will be ignored. You can use one symbol: ‘AAPL.US’ or several symbols separated by a comma: ‘AAPL.US, MS’
  • fmt: The data for trends is available only in JSON format due to a complex data structure.

Examples

An example to get all earning trends, including historical and upcoming, for AAPL.US, MSFT.US, and AI.PA:

https://eodhistoricaldata.com/api/calendar/trends?api_token=YOUR_API_KEY&fmt=json&symbols=AAPL.US,MSFT.US,AI.PA

Upcoming IPOs API

Basic URL to access

https://eodhistoricaldata.com/api/calendar/ipos

Parameters

  • api_token: REQUIRED. Your api_token to access the API. You will get it after registration.
  • from: OPTIONAL. Format: YYYY-MM-DD. The start date for ipos data, if not provided, today will be used.
  • to: OPTIONAL. Format: YYYY-MM-DD. The end date for ipos data, if not provided, today + 7 days will be used.
  • fmt: OPTIONAL. Output format, possible values: ‘csv’ – for CSV output and ‘json’ – for JSON output. Default value is ‘csv’.

Examples

An example to get all IPOs from December 2, 2018 to December 6, 2018 in JSON format:

https://eodhistoricaldata.com/api/calendar/ipos?api_token=YOUR_API_TOKEN&fmt=json&from=2018-12-02&to=2018-12-06

Output

An example output in CSV format you can download here:

  • All ipos from December 2, 2018, to December 6, 2018

JSON example

Upcoming Splits API

Basic URL to access

https://eodhistoricaldata.com/api/calendar/splits

Parameters

  • api_token: REQUIRED. Your api_token to access the API. You will get it after registration.
  • from: OPTIONAL. Format: YYYY-MM-DD. The start date for splits data, if not provided, today will be used.
  • to: OPTIONAL. Format: YYYY-MM-DD. The end date for splits data, if not provided, today + 7 days will be used.
  • fmt: OPTIONAL. Output format, possible values: ‘csv’ – for CSV output and ‘json’ – for JSON output. Default value is ‘csv’.

Examples

An example to get all splits from December 2, 2018, to December 6, 2018, in JSON format:

https://eodhistoricaldata.com/api/calendar/splits?api_token=YOUR_API_TOKEN&fmt=json&from=2018-12-02&to=2018-12-06

Output

An example output in CSV format you can download here:

  • All splits from December 2, 2018 to December 6, 2018