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.


Confirmed Earnings

GET
/confirmed_earnings
Description

Get confirmed earnings events by iso date, by year, or by ticker. Data is available from the beginning of 2020 and include future earnings events.

Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Response

An array of objects, each representing a confirmed earnings event.

  • date ISO date of this earnings event.
  • ticker Ticker as traded on the exchange.
  • url URL to the press release that confirmed this event.
  • title Title of the press release that confirmed this event.
  • 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".
  • pub_date Publication date of the press release that confirmed this event
[
  {
    "ticker": "NOV",
    "when": "postmarket",
    "date": "2020-07-27",
    "title": "National Oilwell Varco Announces Second Quarter 2020 Earnings Conference Call",
    "url": "https://www.businesswire.com/news/home/20200521005785/en",
    "pub_date": "2020-05-21T22:04:00",
    "security_name": "National Oilwell Varco, Inc. Common Stock",
    "exchange": "NYSE"
  },
  {
    "ticker": "WSM",
    "when": "postmarket",
    "date": "2020-05-28",
    "title": "Williams-Sonoma, Inc. announces release date for first quarter 2020 results: Thursday, May 28, 2020",
    "url": "https://www.businesswire.com/news/home/20200521005578/en",
    "pub_date": "2020-05-21T21:00:00",
    "security_name": "Williams-Sonoma, Inc. Common Stock (DE)",
    "exchange": "NYSE"
  },
...
Queries

Get today's events

curl "https://api.earningscalendar.net/confirmed_earnings?api_key=$KEY"

Get last 25 published releases

curl "https://api.earningscalendar.net/confirmed_earnings?latest=true&api_key=$KEY"

Get by ticker

curl "https://api.earningscalendar.net/confirmed_earnings?ticker=f&api_key=$KEY"

Get by earnings date

curl "https://api.earningscalendar.net/confirmed_earnings?date=2020-02-05&api_key=$KEY"

Get by year

curl "https://api.earningscalendar.net/confirmed_earnings?year=2020&api_key=$KEY"


Earnings

GET
/earnings
Description
Get earnings events by iso date, by year, or by ticker. Data is available from 2010-01-01 and include future earnings events.
Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Response

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"
},
...
Queries

Get today's events

curl "https://api.earningscalendar.net/earnings?api_key=$KEY"

Get by ticker

curl "https://api.earningscalendar.net/earnings?ticker=twtr&api_key=$KEY"

Get by earnings date

curl "https://api.earningscalendar.net/earnings?date=2019-10-24&api_key=$KEY"


Dividend Events

GET
/dividends
Description
Get dividends dates by iso ex date, by year, or by ticker. Data is available from 2010-01-01 and include future dividend events.
Data Format

JSON by default. CSV if the query parameter format=csv is added to the query.

Response

An array of objects, each representing a dividend 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"
},
...
Queries

Get today's events

curl "https://api.earningscalendar.net/dividends?api_key=$KEY"

Get by ex date

curl "https://api.earningscalendar.net/dividends?ex_date=2020-02-07&api_key=$KEY"

Get by ticker

curl "https://api.earningscalendar.net/dividends?ticker=aapl&api_key=$KEY"

Get by year

curl "https://api.earningscalendar.net/dividends?year=2020-02-07&api_key=$KEY"


Calendar Feed Subscription

Our calendar subscriptions are compatible with the majority of calendar software, including Apple Calendar , Microsoft Outlook and Google Calendar

Currently only the forward earnings dataset is available as a calendar subscription. Only a snippet is available in the calendar event body due to size limits. Each calendar earning event has a direct link to a CSV file containing the entire set of earnings happening that day.


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