Skip to main content
Financial metrics are derived ratios computed from a company’s statements and price: valuation multiples, margins, returns, and leverage.

​
Metrics

GET /financial-metrics
Time series of metrics for a single ticker.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringYes-Ticker symbol to query.
periodstringNottmttm | quarterly | annual.
limitintegerNo4Page size (max 100).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/financial-metrics?scenario_id=<id>&ticker=AAPL&period=ttm&limit=4" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "financial_metrics": [
    {
      "ticker": "AAPL",
      "report_period": "2026-03-31",
      "period": "ttm",
      "currency": "USD",
      "price_to_earnings_ratio": 28.4,
      "price_to_sales_ratio": 7.1,
      "gross_margin": 0.452,
      "operating_margin": 0.312,
      "net_margin": 0.271,
      "return_on_equity": 0.51,
      "debt_to_equity": 1.4,
      "market_cap": 2950000000000
    }
  ]
}

​
Metrics snapshot

GET /financial-metrics/snapshot
A point-in-time metrics snapshot across one or many tickers, joined with the price as of a date.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
as_ofdateNolatestPrice-snapshot cutoff.
limitintegerNo100Tickers (max 5000).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/financial-metrics/snapshot?scenario_id=<id>&as_of=2026-03-26&limit=50" \
  -H "X-API-KEY: YOUR_API_KEY"

{ "financial_metrics": [ { "ticker": "AAPL", "price_to_earnings_ratio": 28.4, "market_cap": 2950000000000, "...": "..." } ] }

​
Discovery helper

GET /financial-metrics/snapshot/tickers
Takes only scenario_id; returns tickers with metrics. 
{ "tickers": ["AAPL", "MSFT", "..."] }