EarningsCalendar API documentation

This REST API allows you to access the corporate earnings calendar since 2010 until ~30 days out at the time of the call.

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.

API calls

GET
/tickers
Query Parameters

ticker (string)

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


year (int)

Year for which to dump the entire earnings calendar for.


date (string)

ISO date (ie. 2019-01-30) for which to retrieve tickers announcing earnings this day.


format (string)

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

Description
List tickers announcing earnings by iso date, by year, or by ticker.

Past data goes back to 2010-01-01. Forecast goes until ~30 days out at the time of the call.

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

An array of objects, each representing an earnings event.

  • date ISO date when earnings were released.
  • ticker Company ticker symbol as traded on NYSE or NASDAQ.
  • weight Proprietary signal reflecting confidence in the accuracy of the earnings date. The higher the weight, the more accurate a date is.
  • when When is are earnings slated to be released that day: Before Market Opens or After Market Closes. Returned only if known, otherwise NULL.
  • updated_at When this announcement date was last checked for accuracy. In ISO date time format.
[
  {
    "ticker": "TWTR",
    "when": "AMC",
    "weight": 3,
    "date": "2014-02-05",
    "updated_at": "2020-01-19T23:37:27"
  },
  {
    "ticker": "TWTR",
    "when": "AMC",
    "weight": 4,
    "date": "2014-04-29",
    "updated_at": "2020-01-19T23:37:27"
  },
  {
    "ticker": "TWTR",
    "when": "AMC",
    "weight": 3,
    "date": "2014-07-29",
    "updated_at": "2020-01-19T23:37:27"
  },
  ...
]
Example 2): Get tickers announcing at a given date
curl "https://api.earningscalendar.net/tickers?date=2019-10-24&api_key=$KEY"
Output

An array of objects, each representing an earnings event)

[
  {
    "ticker": "AAGRY",
    "when": "NULL",
    "weight": 1,
    "date": "2019-10-24",
    "updated_at": "2020-01-19T23:37:27"
  },
  {
    "ticker": "AAL",
    "when": "BMO",
    "weight": 4,
    "date": "2019-10-24",
    "updated_at": "2020-01-19T23:37:27"
  },
  {
    "ticker": "AB",
    "when": "BMO",
    "weight": 4,
    "date": "2019-10-24",
    "updated_at": "2020-01-19T23:37:27"
  },
  ...
]
Example 3): CSV Export of the earnings calendar
curl "https://api.earningscalendar.net/tickers?year=2019&api_key=$KEY&format=csv"
Output

A CSV formatted String

2020-04-15,AA,NULL,1,2020-01-20T14:45:59
2020-04-15,ATHE,AMC,1,2020-01-20T14:45:59
2020-04-15,BAC,BMO,1,2020-01-20T14:45:59
2020-04-15,BWMY,NULL,1,2020-01-20T14:45:59
2020-04-15,C,BMO,1,2020-01-20T14:45:59
...

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