getFinancialRatios API

The getFinancialRatios API provides key financial ratios for equities based on symbol. Up to 8 years of financial ratios are available and fields include earnings per share, return on equity and price to earnings.

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


symbols (required)
A symbol or code that identifies a financial instrument. (list)
Example: AAPL,GOOG

fields (optional)
The fields requested. (list)
Example: debtEquity,interestCoverage,bookValue,dividendPayout


symbol (always returned)
A symbol or code that identifies a financial instrument. (string)
eps (always returned)
Earnings per share, calculated by dividing the total net income by the company's outstanding shares. (double)
profitMargin (always returned)
Net profit divided by revenue, expressed as a percentage. (double)
roe (always returned)
Net income divided by shareholder equity, expressed as a percentage. (double)
roa (always returned)
Net income divided by total assets, expressed as a percentage. (double)
priceSales (always returned)
Market capitalization divided by revenue. (double)
priceEarnings (always returned)
Stock price divided by earnings per share. (double)
priceBook (always returned)
Market capitalization divided by total book value. (double)
debtEquity (as requested)
Total debt divided by equity. (double)
interestCoverage (as requested)
A measurement of a company's ability to pay interest on outstanding debt. (double)
bookValue (as requested)
Total assets less intangible assets and liabilities. (double)
dividendPayout (as requested)
The percentage of net income a firm pays to its shareholders as dividends. (double)


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.