GET /stocks/financials/v1/ratios — polygon-api

latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

benzinga9

crypto:aggregates7

crypto:last:trade1

crypto:open-close1

crypto:snapshot4

crypto:trades2

etfglobal5

fable2

fed4

financials4

futures:aggregates1

fx:aggregates7

fx:conversion1

fx:last:quote1

fx:quotes1

fx:snapshot3

fx:trades1

global_crypto1

global_forex1

indices:aggregates6

indices:snapshot1

options:aggregates6

options:last:trade1

options:open-close1

options:quotes1

options:snapshot2

options:trades1

reference14

reference:conditions1

reference:dividends1

reference:exchanges1

reference:news1

reference:options:contract1

reference:options:contracts:list1

reference:related:companies1

reference:sec:filing1

reference:sec:filing:file1

reference:sec:filing:files1

reference:sec:filings1

reference:stocks2

reference:stocks:ipos1

reference:stocks:market2

reference:tickers:get2

reference:tickers:list1

reference:tickers:types1

stocks:aggregates7

stocks:last:quote1

stocks:last:trade1

stocks:open-close2

stocks:quotes2

stocks:snapshot3

stocks:trades2

tmx1

us_futures8

us_options3

us_stocks_all2

us_stocks_reference3

financials

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.

get/stocks/financials/v1/ratios

Query parameters

tickerstring

Stock ticker symbol for the company.

ticker.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

ticker.gtstring

Filter greater than the value.

ticker.gtestring

Filter greater than or equal to the value.

ticker.ltstring

Filter less than the value.

ticker.ltestring

Filter less than or equal to the value.

cikstring

Central Index Key (CIK) number assigned by the SEC to identify the company.

cik.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

cik.gtstring

Filter greater than the value.

cik.gtestring

Filter greater than or equal to the value.

cik.ltstring

Filter less than the value.

cik.ltestring

Filter less than or equal to the value.

pricenumber double

Stock price used in ratio calculations, typically the closing price for the given date. Value must be a floating point number.

price.gtnumber double

Filter greater than the value. Value must be a floating point number.

price.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

price.ltnumber double

Filter less than the value. Value must be a floating point number.

price.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

average_volumenumber double

Average trading volume over the last 30 trading days, providing context for liquidity. Value must be a floating point number.

average_volume.gtnumber double

Filter greater than the value. Value must be a floating point number.

average_volume.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

average_volume.ltnumber double

Filter less than the value. Value must be a floating point number.

average_volume.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

market_capnumber double

Market capitalization, calculated as stock price multiplied by total shares outstanding. Value must be a floating point number.

market_cap.gtnumber double

Filter greater than the value. Value must be a floating point number.

market_cap.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

market_cap.ltnumber double

Filter less than the value. Value must be a floating point number.

market_cap.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

earnings_per_sharenumber double

Earnings per share, calculated as net income available to common shareholders divided by weighted shares outstanding. Value must be a floating point number.

earnings_per_share.gtnumber double

Filter greater than the value. Value must be a floating point number.

earnings_per_share.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

earnings_per_share.ltnumber double

Filter less than the value. Value must be a floating point number.

earnings_per_share.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

price_to_earningsnumber double

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_earnings.gtnumber double

Filter greater than the value. Value must be a floating point number.

price_to_earnings.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

price_to_earnings.ltnumber double

Filter less than the value. Value must be a floating point number.

price_to_earnings.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

price_to_booknumber double

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_book.gtnumber double

Filter greater than the value. Value must be a floating point number.

price_to_book.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

price_to_book.ltnumber double

Filter less than the value. Value must be a floating point number.

price_to_book.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

price_to_salesnumber double

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_sales.gtnumber double

Filter greater than the value. Value must be a floating point number.

price_to_sales.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

price_to_sales.ltnumber double

Filter less than the value. Value must be a floating point number.

price_to_sales.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

price_to_cash_flownumber 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. Value must be a floating point number.

price_to_cash_flow.gtnumber double

Filter greater than the value. Value must be a floating point number.

price_to_cash_flow.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

price_to_cash_flow.ltnumber double

Filter less than the value. Value must be a floating point number.

price_to_cash_flow.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

price_to_free_cash_flownumber 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. Value must be a floating point number.

price_to_free_cash_flow.gtnumber double

Filter greater than the value. Value must be a floating point number.

price_to_free_cash_flow.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

price_to_free_cash_flow.ltnumber double

Filter less than the value. Value must be a floating point number.

price_to_free_cash_flow.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

dividend_yieldnumber double

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.

dividend_yield.gtnumber double

Filter greater than the value. Value must be a floating point number.

dividend_yield.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

dividend_yield.ltnumber double

Filter less than the value. Value must be a floating point number.

dividend_yield.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

return_on_assetsnumber double

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_assets.gtnumber double

Filter greater than the value. Value must be a floating point number.

return_on_assets.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

return_on_assets.ltnumber double

Filter less than the value. Value must be a floating point number.

return_on_assets.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

return_on_equitynumber double

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.

return_on_equity.gtnumber double

Filter greater than the value. Value must be a floating point number.

return_on_equity.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

return_on_equity.ltnumber double

Filter less than the value. Value must be a floating point number.

return_on_equity.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

debt_to_equitynumber double

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.

debt_to_equity.gtnumber double

Filter greater than the value. Value must be a floating point number.

debt_to_equity.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

debt_to_equity.ltnumber double

Filter less than the value. Value must be a floating point number.

debt_to_equity.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

currentnumber double

Current ratio, calculated as total current assets divided by total current liabilities, measuring short-term liquidity. Value must be a floating point number.

current.gtnumber double

Filter greater than the value. Value must be a floating point number.

current.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

current.ltnumber double

Filter less than the value. Value must be a floating point number.

current.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

quicknumber double

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.

quick.gtnumber double

Filter greater than the value. Value must be a floating point number.

quick.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

quick.ltnumber double

Filter less than the value. Value must be a floating point number.

quick.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

cashnumber double

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.

cash.gtnumber double

Filter greater than the value. Value must be a floating point number.

cash.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

cash.ltnumber double

Filter less than the value. Value must be a floating point number.

cash.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

ev_to_salesnumber double

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_sales.gtnumber double

Filter greater than the value. Value must be a floating point number.

ev_to_sales.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

ev_to_sales.ltnumber double

Filter less than the value. Value must be a floating point number.

ev_to_sales.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

ev_to_ebitdanumber 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. Value must be a floating point number.

ev_to_ebitda.gtnumber double

Filter greater than the value. Value must be a floating point number.

ev_to_ebitda.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

ev_to_ebitda.ltnumber double

Filter less than the value. Value must be a floating point number.

ev_to_ebitda.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

enterprise_valuenumber double

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.

enterprise_value.gtnumber double

Filter greater than the value. Value must be a floating point number.

enterprise_value.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

enterprise_value.ltnumber double

Filter less than the value. Value must be a floating point number.

enterprise_value.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

free_cash_flownumber double

Free cash flow, calculated as operating cash flow minus capital expenditures (purchase of property, plant, and equipment). Value must be a floating point number.

free_cash_flow.gtnumber double

Filter greater than the value. Value must be a floating point number.

free_cash_flow.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

free_cash_flow.ltnumber double

Filter less than the value. Value must be a floating point number.

free_cash_flow.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

limitinteger

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.

sortstring

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

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.