v1

latestOpenAPI 3.0.1Apache-2.02026-07-17105189262.9 KB

Default

Earnings Surprises

Get company historical quarterly earnings surprise going back to 2000.

get/stock/earnings

Query parameters

symbolstring required

Symbol of the company: AAPL.

limitinteger

Limit number of period returned. Leave blank to get the full history.

Response

successful operation

actualnumber float

Actual earning result.

estimatenumber float

Estimated earning.

surprisenumber float

Surprise - The difference between actual and estimate.

surprisePercentnumber float

Surprise percent.

periodstring date

Reported period.

symbolstring

Company symbol.

yearinteger

Fiscal year.

quarterinteger

Fiscal quarter.

Example response

[
  {
    "actual": 0.8008282,
    "surprise": 1.4658129,
    "symbol": "symbol",
    "period": "2000-01-23",
    "year": 5,
    "surprisePercent": 5.962134,
    "estimate": 6.0274563,
    "quarter": 2
  }
]