API documentation

This REST API allows you to access calendar APIs since 2010 until 90 days out.

It's a simple HTTPS API returning data in JSON and CSV formats.

1. REST API

Authentication

All API calls requires authentication with an API key which can be passed either as an URL query parameter ?api_key=$KEY or as an HTTP header X-Api-Key: $KEY

Fair Use

The REST API is rate limited to 1 request per second per API key.

2. API Resources

GET
/earnings
Query Parameters

ticker (string)

Case-insensitive ticker for which to retrieve past and future earnings events.


year (int)

Year for which to export the entire earnings calendar.


date (string)

ISO date (ie. 2019-01-30) for which to retrieve earnings events.


format (string)

One of [json, csv]. Default to json if unspecified.

Description
Get earnings events by iso date, by year, or by ticker.

Past data goes back to 2010-01-01. Forecast goes up to ~90 days out.

Example 1): Get earnings events for a ticker
curl "https://api.earningscalendar.net/earnings?ticker=twtr&api_key=$KEY"
Output

An array of objects, each representing an earnings event.

  • date ISO date of this earnings event.
  • ticker Ticker as traded on the exchange.
  • weight Proprietary signal reflecting accuracy of the earnings events. The bigger the more accurate.
  • security_name Name of the security trading under this symbol/ticker.
  • exchange The exchange where the security is trading. One of AMEX, NASDAQ, NYSE.
  • when When are earnings slated to be released that day. Returned only if known, otherwise the string "null".
  • updated_at When this announcement date was last checked for accuracy. In ISO date time format.
[
  {
    "ticker":"TWTR",
    "when":"premarket",
    "weight":5,
    "date":"2019-02-07",
    "security_name":"Twitter, Inc. Common Stock",
    "exchange":"NYSE",
    "updated_at":"2020-01-30T03:07:42"
},
  {
    "ticker":"TWTR",
    "when":"premarket",
    "weight":5,
    "date":"2019-04-23",
    "security_name":"Twitter, Inc. Common Stock",
    "exchange":"NYSE",
    "updated_at":"2020-01-30T03:12:56"
},
...
Example 2): Get earnings events at a given date
curl "https://api.earningscalendar.net/earnings?date=2019-10-24&api_key=$KEY"
Output

An array of objects, each representing an earnings event.

[
  {
    "ticker":"AAL",
    "when":"premarket",
    "weight":5,
    "date":"2019-10-24",
    "security_name":"American Airlines Group, Inc. - Common Stock",
    "exchange":"NASDAQ",
    "updated_at":"2020-01-30T03:26:13"

  },
  {
    "ticker":"AB",
    "when":"premarket",
    "weight":5,
    "date":"2019-10-24",
    "security_name":"AllianceBernstein Holding L.P.  Units",
    "exchange":"NYSE",
    "updated_at":"2020-01-30T03:26:13"

  },
  ...
Example 3): CSV Export of the earnings calendar
curl "https://api.earningscalendar.net/earnings?year=2019&api_key=$KEY&format=csv"
Output

A CSV formatted String

date|exchange|symbol|when|weight|security_name|updated_at
2019-01-03|NYSE|ARDC||1|Ares Dynamic Credit Allocation Fund, Inc. Common Shares|2020-01-30T03:05:36
2019-01-03|AMEX|CCF|postmarket|4|Chase Corporation Common Stock|2020-01-30T03:05:36
2019-01-03|NYSE|EDD||1|Morgan Stanley Emerging Markets Domestic Debt Fund, Inc. Morgan Stanley Emerging Markets Domestic Debt Fund, Inc. Common
...
GET
/dividends
Query Parameters

ticker (string)

Case-insensitive ticker for which to retrieve past and future dividend events.


year (int)

Year for which to export the entire dividends calendar.


ex_date (string)

ISO ex-date (ie. 2019-01-30) for which to retrieve dividends events.


format (string)

One of [json, csv]. Default to json if unspecified.

Description
Get dividends dates by iso ex-date, by year, or by ticker.

Past data goes back to 2010-01-01. Forecast goes up to ~90 days out.

Example 1): Get dividends events for a ticker
curl "https://api.earningscalendar.net/dividends?ticker=aapl&api_key=$KEY"
Output

An array of objects, each representing a dividends event.

  • ex_date ISO formatted ex-date of this dividends event.
  • record_date ISO formatted record date of this dividends event.
  • declare_date ISO formatted declaration date of this dividends event.
  • amount Dividend amount.
  • ticker Ticker as traded on the exchange.
  • security_name Name of the security trading under this symbol/ticker.
  • exchange The exchange where the security is trading. One of AMEX, NASDAQ, NYSE.
  • updated_at When this announcement date was last checked for accuracy. In ISO date time format.
[
  {
    "ticker":"AAPL",
    "ex_date":"2019-02-08",
    "record_date":"2019-02-11",
    "amount":0.73,
    "declare_date":"2019-01-29",
    "security_name":"Apple Inc. - Common Stock",
    "exchange":"NASDAQ",
    "updated_at":"2020-01-30T02:08:34"
},
  {
    "ticker":"AAPL",
    "ex_date":"2019-05-10",
    "record_date":"2019-05-13",
    "amount":0.77,
    "declare_date":"2019-05-01",
    "security_name":"Apple Inc. - Common Stock",
    "exchange":"NASDAQ",
    "updated_at":"2020-01-30T02:15:03"
},
...
Example 2): Get dividends events by ex-date
curl "https://api.earningscalendar.net/dividends?ex_date=2020-02-07&api_key=$KEY"
Output

An array of objects, each representing a dividends event.

[
  {
    "ticker":"AAPL",
    "ex_date":"2020-02-07",
    "record_date":"2020-02-10",
    "amount":0.77,
    "declare_date":"2020-01-28",
    "security_name":"Apple Inc. - Common Stock",
    "exchange":"NASDAQ",
    "updated_at":"2020-01-30T06:01:30"
  },
  {
    "ticker":"AEP",
    "ex_date":"2020-02-07",
    "record_date":"2020-02-10",
    "amount":0.7,
    "declare_date":"2020-01-21",
    "security_name":"American Electric Power Company, Inc. Common Stock",
    "exchange":"NYSE",
    "updated_at":"2020-01-29T08:38:51"
  },
  ...
Example 3): CSV Export of the dividends calendar
curl "https://api.earningscalendar.net/dividends?year=2019&api_key=$KEY&format=csv"
Output

A CSV formatted String

ex_date|exchange|symbol|amount|record_date|declare_date|security_name|updated_at
2019-01-02|NYSE|ABM|0.18|2019-01-03|2018-12-18|ABM Industries Incorporated Common Stock|2020-01-30T02:03:08
2019-01-02|NYSE|CLI|0.2|2019-01-03|2018-12-11|Mack-Cali Realty Corporation Common Stock|2020-01-30T02:03:08
2019-01-02|NYSE|ESE|0.08|2019-01-03|2018-11-15|ESCO Technologies Inc. Common Stock|2020-01-30T02:03:08
...

copyright © 2017-2020 Kalendarium
built with in oakland, california.