Skip to main content
Get pre-computed financial ratios for a company across five categories: valuation (P/E, P/B, P/S, EV/sales, EV/EBITDA), profitability (return on equity and assets, gross, operating, and net margins), liquidity (current, quick, and cash ratios), leverage (debt-to-equity, interest coverage), and per-share (EPS, book value per share, dividend yield). Request a subset of categories or omit the filter to get them all. Endpoint: POST /api/v1/fundamentals/ratios Tier: point · Delivery: sync

Request

FieldType
tickerstring
as_of_datestring
ratio_categories("valuation" | "profitability" | "liquidity" | "leverage" | "per_share")[]

Response

The response is the two-key envelope { finterm, data }, where data is the finterm.result:FinancialRatios/v1 contract:
FieldDescription
tickerThe stock ticker symbol, uppercased (e.g. “AAPL”).
priceThe share price the ratios are computed against, in USD; null if unavailable.
market_capMarket capitalization in USD; null if unavailable.
ratiosThe requested ratio categories. Each block is present only when requested (default: all): valuation (price_to_earnings, price_to_book, price_to_sales, ev_to_sales, ev_to_ebitda); profitability (return_on_equity, return_on_assets, gross_margin, operating_margin, net_margin); liquidity (current_ratio, quick_ratio, cash_ratio); leverage (debt_to_equity, interest_coverage); per_share (earnings_per_share, book_value_per_share, dividend_yield). A value is null when not computable.

Example

finterm tool financial_ratios AAPL --as-of-date 2024-03-31