Skip to main content
GET
/
calendar
/
earnings
Get earnings calendar
curl --request GET \
  --url https://openapi.ainvest.com/open/calendar/earnings \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "data": [
      {
        "ticker": "<string>",
        "unique_id": "<string>",
        "period_name": "<string>",
        "eps_actual": 123,
        "eps_forecast": 123,
        "eps_surprise": 123,
        "revenue_actual": 123,
        "revenue_forecast": 123,
        "revenue_surprise": 123
      }
    ]
  },
  "status_code": 123,
  "status_msg": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ainvest.com/llms.txt

Use this file to discover all available pages before exploring further.

For more info including corresponding SEC forms and investor call transcripts, please refer to earnings by ticker API endpoint. An earnings report is a company’s official statement showing how much money they made (or lost) during the previous quarter. Securities and Exchange Commission (SEC) requires all public companies to file Form 10-Q for each of the first three quarters of the company’s fiscal year. At the last quarter of a fiscal year the quarterly report is not published, the annual Form 10-K must be filed instead. This report, unlike the quarterly one, is audited by an independent audit firm and tends to have more details. The exact filing dates depend on organization’s fiscal year.

​
The two numbers that matter most

Earnings reports matter because they’re the closest thing to financial truth in the stock market. Earnings Per Share (EPS): This is the company’s total profit divided by the number of shares outstanding. If a company earned $100 million and has 50 million shares, that’s $2 per share. EPS tells you how profitable the company is. Revenue: This is the total amount of money flowing into the company before expenses. Revenue shows whether the business is growing, shrinking, or staying flat. A company might have great revenue but poor profits, or they might have lower revenue but excellent profit margins. Here’s where it gets interesting for traders. Before each earnings report, analysts make predictions about what they think the EPS and revenue will be. These are called “estimates” or “expectations”. Beat expectations? Stock often jumps up. Miss expectations? Stock often goes down. Sometimes even good news sends stocks down if investors were expecting great news. There are multiple strategies that can help making a decision, one of them is testing on historical data.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your key. Get the key here

Query Parameters

​
date
string
required

The date for which to get earnings announcements, format YYYY-MM-DD

Response

Successful response in standard envelope

​
data
object
​
status_code
number

Status code, 0 for success

​
status_msg
string

Status message, success for success