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

Changes

Changed in 3 of the 35 revisions of this API.46

  • fe3acff4e0d72See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • a148c0b2d5833See the full diff
    • ○

      api tag Default added

      api-tag-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • c5b8e420b78c41See the full diff
    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ○

      api tag Default removed

      api-tag-removed

    This revision also has 146 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog