Default

Earnings Surprises

Changed on

Get company historical quarterly earnings surprise going back to 2000.

get/stock/earnings

Request

  • Base URL
    https://finnhub.io/api/v1
  • URL
    https://finnhub.io/api/v1/stock/earnings
  • Auth
    API key in query parameter token

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

Changes

  • fe3acff4e0d7Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • a148c0b2d583Revision changes
    • info

      api tag Default added

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status