getFinancialHighlights API

The getFinancialHighlights API provides key financial highlights, ratios and statistics for equities based on symbol. Fields include market capitalization, revenue, net income, revenue growth and earnings per share.

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. (list)
Example: GOOG,YHOO

fields (optional)
The fields requested. (list)
Example: lastQtrEPS,annualEPS,ttmEPS


OUTPUTS:

symbol (always returned)
A symbol or code that identifies a financial instrument. (string)
marketCapitalization (always returned)
The total number of outstanding shares multiplied by the current market value. In thousands. (int)
insiderShareholders (always returned)
The percent of stock held by insider shareholders. (double)
annualRevenue (always returned)
The company's annual revenue. (int)
ttmRevenue (always returned)
The company's revenue from the last 12 months. (int)
sharesOutstanding (always returned)
The total number of shares outstanding. In thousands. (int)
institutionalShareholders (always returned)
The percent of stock held by institutional shareholders. (double)
annualNetIncome (as requested)
The company's annual income after taxes but before the payout of common and preferred dividends. (int)
ttmNetIncome (as requested)
The net income from the last 12 months. (double)
ttmNetProfitMargin (as requested)
Net income dividend by revenue from the previous 12 months. (double)
oneYearReturn (always returned)
The percent change in price over a one-year period. (double)
threeYearReturn (always returned)
The percent change in price over a three-year period. (double)
fiveYearReturn (always returned)
The percent change in price over a five-year period. (double)
ttmRevenueGrowth (always returned)
The percent growth in revenue over the previous 12-months. (int)
fiveYearRevenueGrowth (always returned)
The percent growth in revenue over the past 5-years. (double)
fiveYearEarningsGrowth (always returned)
The percent growth in earnings over the past 5-years. (double)
fiveYearDividendGrowth (always returned)
The percent growth in dividends over the past 5-years. (double)
lastQtrEPS (as requested)
The earnings per share for the most recent quarter. (double)
annualEPS (always returned)
The earnings per share for the most recent annual period. (double)
ttmEPS (as requested)
The earnings per share for the previous 12-months. (double)
annualDividendRate (always returned)
The annual dividend amount. (double)
annualDividendYield (always returned)
The dividends per share over the trailing one-year period as a percentage of the current stock price. (double)
twelveMonthEPSChg (as requested)
The change in earnings per share over the past 12-months. (double)
peRatio (as requested)
The current price to earnings ratio. (double)
recentEarnings (as requested)
The last reported earnings per share amount. (double)
recentDividends (as requested)
The amount of the most recent dividends issued per share. (double)
recentSplit (as requested)
The most recent stock split and associated ratio. (string)
beta (as requested)
A measure of the volatility of a security in comparison to the volatility of the market. (double)
weightAlpha (always returned)
The weighted alpha of the sector. (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.