get_valuation_metrics

Get what a US public company is TRADING AT, plus two parameter-free reference points. This is NOT an opinion of intrinsic worth — for that, call compute_dcf with assumptions you state explicitly, and present the result as a scenario, never as "the" fair value. Returns per-period data combining computed ratios (gross_margin, operating_margin, net_margin, ROE, ROA, ROIC, debt_to_equity, FCF, FCF margin), price-derived valuation_multiples (current_price, market_cap, pe_ratio, pb_ratio, ev_ebitda, dividend_yield), and reference_points (graham_number, ncav_per_share) — two assumption-free values computed directly from filed fundamentals, with no discount rate or growth assumption baked in. Profitability/cash-flow/leverage fields come from fact.parquet (PIT-safe via accepted_at). valuation_multiples and reference_points come from ratio.parquet's valuation category + stock_price.parquet period-end close (per-period current_price for every fiscal year), derived from EOD prices period-end-aligned. Each value is a {value, unit} pair (unit varies: x / USD / percent); a null value carries a null_reasons[field] code — ALWAYS check it before assuming zero (null != 0). Use this *instead of* get_financial_ratios when observed multiples matter; use get_financial_ratios when you only need the raw ratio table; use compute_dcf whenever the user is asking what the company is WORTH, not what it trades at. Available on all plans.