getEarningsEstimates API

The getEarningsEstimates API provides per share earnings estimates on public companies for quarterly and annual periods based on symbol. Multiple symbols can be used to return estimated earnings data, including average estimate, number of analysts, high estimate, low estimate and estimated growth rate.

Pricing is based on the number of monthly queries and fields requested. We offer four packages: Small, Medium, Large, Enterprise. Contact us for additional details.


API Documentation

INPUTS:

symbols (required)
A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used. (list)
Example: IBM,GOOG

fields (optional)
Additional fields requested. (list)
Example: bid,bidSize,ask,askSize


OUTPUTS:

symbol (always returned)
A symbol or code that identifies the futures contract. (string)
symbolName (always returned)
The full name of the instrument. (string)
period (always returned)
The period, either quarter or annual, that the estimate pertains to. For example, Q42013 or FY122013. (string)
averageEstimate (always returned)
The average estimated earnings per share based on all analysts. (double)
numAnalysts (as requested)
The number of analysts providing earnings estimates. (int)
highEstimate (as requested)
The highest earnings per share estimate amount. (double)
lowEstimate (as requested)
The lowest earnings per share estimate amount. (double)
priorYear (as requested)
The average earnings per share estimated last year. (double)
growthRateEstimate (as requested)
The estimated growth rate in earnings based off of the average estimate (year-over-year). (double)
currentQtrExpectedReportDate (as requested)
The expected report date for the most recent quarter. (date)
expectedEarningsStatus (as requested)
Whether the expected earnings information is late or not. (string)
expectedEarningsSource (as requested)
The source of the expected earnings report date. (string)
dividendType (as requested)
Type of dividend payout. (string)
indicatedAnnualDvnd (as requested)
The indicated annual dividend per share for given instrument. (double)
dividendStatus (as requested)
Whether the dividend data is late or not. (string)
paymentDate (as requested)
The dividend payment date. (date)
recordDate (as requested)
Date when dividend info was reported (date)
declarationDate (as requested)
Date when dividend info was annouced. (date)
exDividendDate (as requested)
The last possible date to have owned shares of a stock and still be entitled to the associated dividend. (date)
dividendRate (as requested)
Last dividend payout amount. (double)

STATUS CODE RESPONSES:

200 OK Success
400 Bad Request The request was invalid, please see the message for more information.
500 Internal Server Error Something is not working correctly, please contact support.