--- title: "GET /stocks/financials/v1/ratios" method: GET path: "/stocks/financials/v1/ratios" tags: ["financials"] --- # GET /stocks/financials/v1/ratios `GET /stocks/financials/v1/ratios` A comprehensive financial ratios dataset providing key valuation, profitability, liquidity, and leverage metrics for public companies. Combines data from income statements, balance sheets, and cash flow statements with daily stock prices to calculate ratios on a daily basis. Uses trailing twelve months (TTM) data for income/cash flow metrics and quarterly data for balance sheet items. Fundamental data updates are applied starting from each filing's period end date. Market cap calculations use point-in-time shares outstanding for historical accuracy. ## Query parameters - `ticker` string - `ticker.any_of` string - `ticker.gt` string - `ticker.gte` string - `ticker.lt` string - `ticker.lte` string - `cik` string - `cik.any_of` string - `cik.gt` string - `cik.gte` string - `cik.lt` string - `cik.lte` string - `price` number, double - `price.gt` number, double - `price.gte` number, double - `price.lt` number, double - `price.lte` number, double - `average_volume` number, double - `average_volume.gt` number, double - `average_volume.gte` number, double - `average_volume.lt` number, double - `average_volume.lte` number, double - `market_cap` number, double - `market_cap.gt` number, double - `market_cap.gte` number, double - `market_cap.lt` number, double - `market_cap.lte` number, double - `earnings_per_share` number, double - `earnings_per_share.gt` number, double - `earnings_per_share.gte` number, double - `earnings_per_share.lt` number, double - `earnings_per_share.lte` number, double - `price_to_earnings` number, double - `price_to_earnings.gt` number, double - `price_to_earnings.gte` number, double - `price_to_earnings.lt` number, double - `price_to_earnings.lte` number, double - `price_to_book` number, double - `price_to_book.gt` number, double - `price_to_book.gte` number, double - `price_to_book.lt` number, double - `price_to_book.lte` number, double - `price_to_sales` number, double - `price_to_sales.gt` number, double - `price_to_sales.gte` number, double - `price_to_sales.lt` number, double - `price_to_sales.lte` number, double - `price_to_cash_flow` number, double - `price_to_cash_flow.gt` number, double - `price_to_cash_flow.gte` number, double - `price_to_cash_flow.lt` number, double - `price_to_cash_flow.lte` number, double - `price_to_free_cash_flow` number, double - `price_to_free_cash_flow.gt` number, double - `price_to_free_cash_flow.gte` number, double - `price_to_free_cash_flow.lt` number, double - `price_to_free_cash_flow.lte` number, double - `dividend_yield` number, double - `dividend_yield.gt` number, double - `dividend_yield.gte` number, double - `dividend_yield.lt` number, double - `dividend_yield.lte` number, double - `return_on_assets` number, double - `return_on_assets.gt` number, double - `return_on_assets.gte` number, double - `return_on_assets.lt` number, double - `return_on_assets.lte` number, double - `return_on_equity` number, double - `return_on_equity.gt` number, double - `return_on_equity.gte` number, double - `return_on_equity.lt` number, double - `return_on_equity.lte` number, double - `debt_to_equity` number, double - `debt_to_equity.gt` number, double - `debt_to_equity.gte` number, double - `debt_to_equity.lt` number, double - `debt_to_equity.lte` number, double - `current` number, double - `current.gt` number, double - `current.gte` number, double - `current.lt` number, double - `current.lte` number, double - `quick` number, double - `quick.gt` number, double - `quick.gte` number, double - `quick.lt` number, double - `quick.lte` number, double - `cash` number, double - `cash.gt` number, double - `cash.gte` number, double - `cash.lt` number, double - `cash.lte` number, double - `ev_to_sales` number, double - `ev_to_sales.gt` number, double - `ev_to_sales.gte` number, double - `ev_to_sales.lt` number, double - `ev_to_sales.lte` number, double - `ev_to_ebitda` number, double - `ev_to_ebitda.gt` number, double - `ev_to_ebitda.gte` number, double - `ev_to_ebitda.lt` number, double - `ev_to_ebitda.lte` number, double - `enterprise_value` number, double - `enterprise_value.gt` number, double - `enterprise_value.gte` number, double - `enterprise_value.lt` number, double - `enterprise_value.lte` number, double - `free_cash_flow` number, double - `free_cash_flow.gt` number, double - `free_cash_flow.gte` number, double - `free_cash_flow.lt` number, double - `free_cash_flow.lte` number, double - `limit` integer - `sort` string ## Response `200` A list of results. - object - `next_url` string — If present, this value can be used to fetch the next page. - `request_id` string, required — A request id assigned by the server. - `results` object[], required — The results for this request. - `average_volume` number, double — Average trading volume over the last 30 trading days, providing context for liquidity. - `cash` number, double — Cash ratio, calculated as cash and cash equivalents divided by current liabilities, measuring the most liquid form of liquidity coverage. - `cik` string — Central Index Key (CIK) number assigned by the SEC to identify the company. - `current` number, double — Current ratio, calculated as total current assets divided by total current liabilities, measuring short-term liquidity. - `date` string, required — Date for which the ratios are calculated, representing the trading date with available price data. - `debt_to_equity` number, double — 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, double — Dividend yield, calculated as annual dividends per share divided by stock price, measuring the income return on investment. - `earnings_per_share` number, double — Earnings per share, calculated as net income available to common shareholders divided by weighted shares outstanding. - `enterprise_value` number, double — Enterprise value, calculated as market capitalization plus total debt minus cash and cash equivalents, representing total company value. - `ev_to_ebitda` number, double — 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, double — Enterprise value to sales ratio, calculated as enterprise value divided by revenue, measuring company valuation relative to sales. - `free_cash_flow` number, double — Free cash flow, calculated as operating cash flow minus capital expenditures (purchase of property, plant, and equipment). - `market_cap` number, double — Market capitalization, calculated as stock price multiplied by total shares outstanding. - `price` number, double, required — Stock price used in ratio calculations, typically the closing price for the given date. - `price_to_book` number, double — 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, double — 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, double — 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, double — 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, double — Price-to-sales ratio, calculated as stock price divided by revenue per share, measuring valuation relative to sales. - `quick` number, double — Quick ratio (acid-test ratio), calculated as (current assets minus inventories) divided by current liabilities, measuring immediate liquidity. - `return_on_assets` number, double — 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, double — Return on equity ratio, calculated as net income divided by total shareholders' equity, measuring profitability relative to shareholders' equity. - `ticker` string, required — Stock ticker symbol for the company. - `status` 'OK', required — The status of this request's response. ## Other responses - `400` — An error message. --- [API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)