valuation
Read-onlyIdempotent
Calculate pre-computed valuation ratios like P/E, EV/EBITDA, P/B, and dividend yield for one or more tickers, so you can assess a stock's value without parsing raw financial statements.
Instructions
Pre-computed valuation ratios (P/E, EPS, EV/EBITDA, EV/EBIT, P/B, P/S, PEG, dividend yield, FCF yield, market cap, forward P/E, forward PEG). Requires tickers='AAPL' — use comma-separated values for multiple tickers. Use instead of raw financial statements. Supports quarterly=true and start_date/end_date. get_forward_price_earnings_ratio and get_forward_price_earnings_growth_ratio additionally require a Premium FMP subscription and are fetched on first use only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lag | No | Number of periods to lag when computing growth rates. | |
| limit | No | The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. | |
| growth | No | Return period-over-period growth rates instead of absolute values. | |
| diluted | No | For get_earnings_per_share: Whether to use diluted earnings per share. For get_revenue_per_share, get_price_to_earnings_ratio, get_price_to_earnings_growth_ratio, get_book_value_per_share, get_price_to_book_ratio, get_interest_debt_per_share, get_capex_per_share, get_earnings_yield, get_weighted_dividend_yield, get_price_to_cash_flow_ratio, get_price_to_free_cash_flow_ratio, get_market_cap, get_enterprise_value, get_ev_to_sales_ratio, get_ev_to_ebit, get_ev_to_ebitda_ratio, get_ev_to_operating_cashflow_ratio, get_ev_to_free_cash_flow_ratio, get_buyback_yield, get_shareholder_yield, get_price_to_sales_ratio: Whether to use diluted shares in the calculation. | |
| tickers | No | Comma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'. | |
| end_date | No | End of the date range in YYYY-MM-DD format. | 2026-10-27 |
| trailing | No | Trailing window size in number of periods. Sums the raw values over the trailing N periods (e.g. trailing=4 on quarterly data gives a trailing-4-quarter / TTM-style sum) instead of returning one value per period. | |
| indicator | Yes | Name of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name. | |
| quarterly | No | Return quarterly data instead of annual when True. | |
| show_daily | No | For get_price_to_earnings_ratio, get_price_to_book_ratio, get_earnings_yield, get_weighted_dividend_yield, get_price_to_cash_flow_ratio, get_price_to_free_cash_flow_ratio, get_market_cap, get_enterprise_value, get_ev_to_sales_ratio, get_ev_to_ebit, get_ev_to_ebitda_ratio, get_ev_to_operating_cashflow_ratio, get_ev_to_free_cash_flow_ratio, get_price_to_sales_ratio: Whether to show daily values: the close of each trading day against the statement figures of the latest period that has ended on or before that day, so no figures are used before their period closes. For get_dividend_yield: Whether to show daily values: the close of each trading day against the dividends paid in the 365 calendar days up to that day (or the `trailing` periods in days). Days less than one window after the first price are NaN. | |
| start_date | No | Start of the date range in YYYY-MM-DD format. | 2021-10-28 |
| standardize | No | Return the Z-Score (standard score) instead of the raw values, i.e. how many standard deviations each value is from the mean of its own series. When combined with growth=True, the growth values are standardized instead of the raw values. | |
| show_columns | No | Comma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage. | |
| benchmark_ticker | No | Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'. | SPY |
| include_dividends | No | For get_earnings_per_share: Whether to deduct the preferred dividends paid from net income. For get_price_to_earnings_ratio, get_earnings_yield: Whether to deduct preferred dividends from net income. For get_price_to_earnings_growth_ratio: Whether to deduct preferred dividends from net income, in both the P/E and the EPS growth (not in the EBITDA growth). | |
| use_ebitda_growth_rate | No | Whether to use EBITDA growth rate for the calculation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |