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>"
}
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

200
application/json

Successful response in standard envelope

The response is of type object.