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

Comments

    1. EOD Historical Data Support Article Author

      Hello Robert, we have no this information for the moment, we will try to add it later, but I can’t provide you exact ETA now.

  1. AU

    It’s an important feature… Will be very helpful. is this data available for markets outside the United states?

    1. EOD Historical Data Support Article Author

      Yes, the data is available for non-US markets but not for all and with some limitations.

      1. Ilya Bykov

        So I have no way of knowing about future ETF splits using the upcoming splits api? Or does the Historical Splits API have information about the splits that will happen in the near future?

  2. Sven M

    Hello, the APi does not deliver upcoming earnings for MSFT.US for example. How many days in advance do they appear? The earning call is on 3/4 of Feb, but not yet listed.

    1. EOD Historical Data Support Article Author

      Yes, just use ‘to=’ parameter, by default upcoming earnings only for +7 days. With ‘to=2022-01-01’ you will get all upcoming earnings we have for 2021

  3. Pablo

    Hello,

    The … /calendar/earnings/… url returns data with a field called ‘Report_Date’

    At the same time in https://eodhistoricaldata.com/financial-apis/stock-etfs-fundamental-data-feeds/
    i can fetch data from another url, …/api/fundamentals/… and get among other things quarterly financial data, the CashFlow, Balance Sheet and Income Statement, which all have a field called ‘filing_date’

    I have compared those 2 fields for some companies and they do not match, for example for AAPL.US the ‘filing_date’ dates one or a few days after the ‘Report_Date’.

    Is there any difference between the two?

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.