Financial Ratios
Retrieve calculated financial ratios including liquidity, profitability, leverage, and efficiency metrics. Compare company performance against industry standards.
Use Case: Screen for companies with current ratio above 2.0 and debt-to-equity below 0.5 for stability.
Documentation Index
Fetch the complete documentation index at: https://finance.dev/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Query Parameters
Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company.
"AAPL"
Comma-separated list of ticker symbols.
"AAPL,MSFT,GOOG"
Ticker pagination lower bound. Returns symbols alphabetically after this ticker, excluding the ticker itself.
Ticker greater than or equal (inclusive)
Ticker pagination upper bound. Returns symbols alphabetically before this ticker, excluding the ticker itself.
Ticker less than or equal (inclusive)
CIK company identifier from the SEC. Use this when filtering by SEC registrant instead of ticker.
Comma-separated SEC CIK identifiers. Use this to filter several registrants in one request.
CIK pagination lower bound. Returns records with CIK values greater than this value, excluding the value itself.
CIK greater than or equal (inclusive)
CIK pagination upper bound. Returns records with CIK values less than this value, excluding the value itself.
CIK upper-bound filter. Returns records with CIK values less than or equal to this value.
Exact price filter. Use it when you need records matching one specific price value.
Price lower-bound filter. Returns records above this value, excluding the value itself.
Price greater than or equal (inclusive)
Price upper-bound filter. Returns records below this value, excluding the value itself.
Price less than or equal (inclusive)
Exact average-volume filter. Use it when screening for one specific average volume value.
Average volume greater than (exclusive)
Average volume greater than or equal (inclusive)
Average volume less than (exclusive)
Average volume less than or equal (inclusive)
Exact market-cap filter. Use it when screening for one specific company size value.
Market cap greater than (exclusive)
Market cap greater than or equal (inclusive)
Market-cap upper-bound filter. Returns companies below this value, excluding the value itself.
Market cap less than or equal (inclusive)
Exact earnings-per-share filter. Use it when screening for one EPS value.
EPS lower-bound filter. Returns companies with EPS above this value, excluding the value itself.
EPS greater than or equal (inclusive)
EPS upper-bound filter. Returns companies with EPS below this value, excluding the value itself.
EPS upper-bound filter. Returns companies with EPS less than or equal to this value.
Exact price-to-earnings ratio filter. Use it when screening for one valuation value.
P/E ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
P/E ratio greater than or equal (inclusive)
P/E ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
P/E ratio less than or equal (inclusive)
Exact price-to-book ratio filter. Use it when screening for one valuation value.
P/B ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
P/B ratio greater than or equal (inclusive)
P/B ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
P/B ratio less than or equal (inclusive)
Exact price-to-sales ratio filter. Use it when screening for one valuation value.
P/S ratio lower-bound filter. Returns companies above this valuation, excluding the value itself.
P/S ratio greater than or equal (inclusive)
P/S ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
P/S ratio less than or equal (inclusive)
Exact price-to-cash-flow ratio filter. Use it when screening for one valuation value.
P/CF ratio greater than (exclusive)
P/CF ratio greater than or equal (inclusive)
P/CF ratio upper-bound filter. Returns companies below this valuation, excluding the value itself.
P/CF ratio less than or equal (inclusive)
Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.
x >= 1Field used to sort results. Enter one of the sort fields supported by this endpoint.
Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.