Ratios
GET
/stocks/financials/v1/ratios
Retrieve comprehensive financial ratios data providing key valuation, profitability, liquidity, and leverage metrics for public companies. This dataset combines data from income statements, balance sheets, and cash flow statements with daily stock prices to calculate ratios for the most recent trading day using trailing twelve months (TTM) financials.
Use Cases: Company valuation, comparative analysis, financial health assessment, investment screening.
Plan AccessIncluded in select Stocks plans
Plan
Recency
Not included
Not included
Not included
End-of-day
End-of-day
End-of-day
End-of-day
Plan RecencyEnd-of-day (updated daily)
Plan
History
Not included
Not included
Not included
All history
All history
All history
All history
Plan HistoryRecords date back to March 29, 2009
Query Parameters
ticker
string
Stock ticker symbol for the company.
cik
string
Central Index Key (CIK) number assigned by the SEC to identify the company.
price
number
Stock price used in ratio calculations, typically the closing price for the given date. Value must be a floating point number.
average_volume
number
Average trading volume over a recent period, providing context for liquidity. Value must be a floating point number.
market_cap
number
Market capitalization, calculated as stock price multiplied by total shares outstanding. Value must be a floating point number.
earnings_per_share
number
Earnings per share, calculated as net income available to common shareholders divided by weighted shares outstanding. Value must be a floating point number.
price_to_earnings
number
Price-to-earnings ratio, calculated as stock price divided by earnings per share. Only calculated when earnings per share is positive. Value must be a floating point number.
price_to_book
number
Price-to-book ratio, calculated as stock price divided by book value per share, comparing market value to book value. Value must be a floating point number.
price_to_sales
number
Price-to-sales ratio, calculated as stock price divided by revenue per share, measuring valuation relative to sales. Value must be a floating point number.
price_to_cash_flow
number
Price-to-cash-flow ratio, calculated as stock price divided by operating cash flow per share. Only calculated when operating cash flow per share is positive. Value must be a floating point number.
price_to_free_cash_flow
number
Price-to-free-cash-flow ratio, calculated as stock price divided by free cash flow per share. Only calculated when free cash flow per share is positive. Value must be a floating point number.
dividend_yield
number
Dividend yield, calculated as annual dividends per share divided by stock price, measuring the income return on investment. Value must be a floating point number.
return_on_assets
number
Return on assets ratio, calculated as net income divided by total assets, measuring how efficiently a company uses its assets to generate profit. Value must be a floating point number.
return_on_equity
number
Return on equity ratio, calculated as net income divided by total shareholders' equity, measuring profitability relative to shareholders' equity. Value must be a floating point number.
debt_to_equity
number
Debt-to-equity ratio, calculated as total debt (current debt plus long-term debt) divided by total shareholders' equity, measuring financial leverage. Value must be a floating point number.
current
number
Current ratio, calculated as total current assets divided by total current liabilities, measuring short-term liquidity. Value must be a floating point number.
quick
number
Quick ratio (acid-test ratio), calculated as (current assets minus inventories) divided by current liabilities, measuring immediate liquidity. Value must be a floating point number.
cash
number
Cash ratio, calculated as cash and cash equivalents divided by current liabilities, measuring the most liquid form of liquidity coverage. Value must be a floating point number.
ev_to_sales
number
Enterprise value to sales ratio, calculated as enterprise value divided by revenue, measuring company valuation relative to sales. Value must be a floating point number.
ev_to_ebitda
number
Enterprise value to EBITDA ratio, calculated as enterprise value divided by EBITDA, measuring company valuation relative to earnings before interest, taxes, depreciation, and amortization. Value must be a floating point number.
enterprise_value
number
Enterprise value, calculated as market capitalization plus total debt minus cash and cash equivalents, representing total company value. Value must be a floating point number.
free_cash_flow
number
Free cash flow, calculated as operating cash flow minus capital expenditures (purchase of property, plant, and equipment). Value must be a floating point number.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'ticker' if not specified. The sort order defaults to 'asc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
average_volume
number
optional
Average trading volume over a recent period, providing context for liquidity.
cash
number
optional
Cash ratio, calculated as cash and cash equivalents divided by current liabilities, measuring the most liquid form of liquidity coverage.
cik
string
optional
Central Index Key (CIK) number assigned by the SEC to identify the company.
current
number
optional
Current ratio, calculated as total current assets divided by total current liabilities, measuring short-term liquidity.
date
string
Date for which the ratios are calculated, representing the trading date with available price data.
debt_to_equity
number
optional
Debt-to-equity ratio, calculated as total debt (current debt plus long-term debt) divided by total shareholders' equity, measuring financial leverage.
dividend_yield
number
optional
Dividend yield, calculated as annual dividends per share divided by stock price, measuring the income return on investment.
earnings_per_share
number
optional
Earnings per share, calculated as net income available to common shareholders divided by weighted shares outstanding.
enterprise_value
number
optional
Enterprise value, calculated as market capitalization plus total debt minus cash and cash equivalents, representing total company value.
ev_to_ebitda
number
optional
Enterprise value to EBITDA ratio, calculated as enterprise value divided by EBITDA, measuring company valuation relative to earnings before interest, taxes, depreciation, and amortization.
ev_to_sales
number
optional
Enterprise value to sales ratio, calculated as enterprise value divided by revenue, measuring company valuation relative to sales.
free_cash_flow
number
optional
Free cash flow, calculated as operating cash flow minus capital expenditures (purchase of property, plant, and equipment).
market_cap
number
optional
Market capitalization, calculated as stock price multiplied by total shares outstanding.
price
number
Stock price used in ratio calculations, typically the closing price for the given date.
price_to_book
number
optional
Price-to-book ratio, calculated as stock price divided by book value per share, comparing market value to book value.
price_to_cash_flow
number
optional
Price-to-cash-flow ratio, calculated as stock price divided by operating cash flow per share. Only calculated when operating cash flow per share is positive.
price_to_earnings
number
optional
Price-to-earnings ratio, calculated as stock price divided by earnings per share. Only calculated when earnings per share is positive.
price_to_free_cash_flow
number
optional
Price-to-free-cash-flow ratio, calculated as stock price divided by free cash flow per share. Only calculated when free cash flow per share is positive.
price_to_sales
number
optional
Price-to-sales ratio, calculated as stock price divided by revenue per share, measuring valuation relative to sales.
quick
number
optional
Quick ratio (acid-test ratio), calculated as (current assets minus inventories) divided by current liabilities, measuring immediate liquidity.
return_on_assets
number
optional
Return on assets ratio, calculated as net income divided by total assets, measuring how efficiently a company uses its assets to generate profit.
return_on_equity
number
optional
Return on equity ratio, calculated as net income divided by total shareholders' equity, measuring profitability relative to shareholders' equity.
ticker
string
Stock ticker symbol for the company.
status
enum (OK)
The status of this request's response.
Code Examples
Query URL
GET
Run query unavailable
Create account or sign in to Polygon
Scroll to see updated query response
Response Object