Financials

Financial metrics snapshot

GET/api/v2/financial-metrics-snapshot

Coverage: US / CN / JP
Billing: 20 cr / thousand calls

Returns a company's precomputed valuation and financial ratios: market cap, enterprise value, TTM valuation multiples, margins, returns, growth rates, leverage and liquidity ratios, and dividend metrics, one row per ticker as of the latest snapshot date. Ratios are always decimals (0.25 = 25%), not percentages; monetary fields are in currency (the trading currency), and market_capitalization_usd is additionally converted to USD at the snapshot-date rate.

Metrics are precomputed values calculated from the snapshot date's close, not real-time data; the endpoint does not provide real-time or raw quotes (US market data is served by /prices-snapshot, ; CN / JP have no market data endpoint). price_date tells you which trading day the close came from; the price itself is not returned.
The endpoint provides no forecast or estimate metrics; consensus price targets are served by /analyst-consensus, EPS / revenue estimates by /earnings-calendar.
Every metric can be null depending on per-company coverage, for one of three reasons: the statements lack a required component (the leverage ratios need interest-bearing debt and interest expense), there are too few statement periods (a three-year CAGR needs four complete fiscal years), or the company pays no dividend (the dividend metrics). price_date and statement_period_end tell you which trading day’s close and which statement period the row was computed from.
Interest-bearing debt is short-term plus long-term debt; where the statements do not carry a debt total, the two legs are added. When both legs are missing, the ratios that depend on them are null. Net debt is interest-bearing debt less cash and equivalents; with no debt data at all it is null rather than a negative value that would read as "holding cash means net cash".

Query parameters

Parameter	Type	Required	Description
ticker	string	required	Up to 50 tickers, comma-separated.

Response fields

Field	Type	Description
ticker	string	Canonical ticker (US has no suffix, e.g. `AAPL`; CN is `600519.SH`; JP is `7203.T`)
market	stringenum	Market code: `US` / `CN` / `JP`
currency	string	Trading currency; the amount fields below are denominated in this currency
shares_outstanding	number	Shares outstanding
market_capitalization	number	Market capitalization in local currency
market_capitalization_usd	number	Market capitalization in USD, converted at the snapshot-date exchange rate
enterprise_value	number	Enterprise value in local currency
pe_ratio_ttm	number	Valuation multiple: P/E (TTM)
peg_ratio_ttm	number	Valuation multiple: PEG (TTM)
pb_ratio_ttm	number	Valuation multiple: P/B (TTM)
ps_ratio_ttm	number	Valuation multiple: P/S (TTM)
pcf_ratio_ttm	number	Valuation multiple: P/CF (TTM)
ev_to_sales_ttm	number	EV multiple: EV/Sales (TTM)
ev_to_ebitda_ttm	number	EV multiple: EV/EBITDA (TTM)
ev_to_ebit_ttm	number	EV multiple: EV/EBIT (TTM)
gross_profit_margin_ttm	number	Gross profit margin (TTM)
ebitda_margin_ttm	number	EBITDA margin (TTM)
net_income_margin_ttm	number	Net income margin (TTM)
fcf_margin_ttm	number	Free cash flow margin (TTM)
roe_ttm	number	Return ratio: ROE (TTM)
roa_ttm	number	Return ratio: ROA (TTM)
roic_ttm	number	Return ratio: ROIC (TTM)
revenue_growth_ttm	number	Revenue TTM year-over-year growth
eps_growth_ttm	number	EPS TTM year-over-year growth
fcf_growth_ttm	number	Free cash flow TTM year-over-year growth
revenue_cagr_3y	number	Revenue 3-year CAGR
eps_cagr_3y	number	EPS 3-year CAGR
dividend_yield_ttm	number	Dividend yield (TTM)
payout_ratio_ttm	number	Payout ratio (TTM)
dividend_growth_1y	number	1-year dividend growth
consecutive_dividend_years	number	Consecutive years of dividend payments
debt_to_equity	number	Leverage: interest-bearing debt / equity attributable to the parent (x)
net_debt_to_equity	number	Leverage: net debt / equity attributable to the parent (x); `null` when the statements carry no interest-bearing debt, rather than reading cash alone as a net cash position
debt_to_assets	number	Leverage: interest-bearing debt / total assets (x)
debt_to_ebitda	number	Leverage: interest-bearing debt / EBITDA (TTM, x)
net_debt_to_ebitda	number	Leverage: net debt / EBITDA (TTM, x); same missing-data rule as `net_debt_to_equity`
interest_coverage	number	Leverage: EBIT / interest expense (TTM, x)
ebitda_to_interest	number	Leverage: EBITDA / interest expense (TTM, x)
current_ratio	number	Liquidity: current assets / current liabilities (x)
quick_ratio	number	Liquidity: quick assets / current liabilities (x), where quick assets are current assets less inventories
cash_ratio	number	Liquidity: cash and short-term investments / current liabilities (x)
working_capital	number	Liquidity: working capital, current assets less current liabilities, in `currency`
operating_cash_flow_ratio	number	Liquidity: operating cash flow / current liabilities (TTM, x)
fcf_to_debt	number	Leverage: free cash flow / interest-bearing debt (TTM, x)
ocf_to_debt	number	Leverage: operating cash flow / interest-bearing debt (TTM, x)
ebit_margin_ttm	number	EBIT margin (TTM)
capex_to_sales_ttm	number	Capital expenditures / revenue (TTM)
asset_turnover_ttm	number	Efficiency: revenue / total assets (TTM, x)
cash_per_share_ttm	number	Cash and short-term investments per share, in `currency`
ebitda_growth_ttm	number	EBITDA TTM year-over-year growth
ebit_growth_ttm	number	EBIT TTM year-over-year growth
ocf_growth_ttm	number	Operating cash flow TTM year-over-year growth
ebitda_cagr_3y	number	EBITDA 3-year CAGR
ebit_cagr_3y	number	EBIT 3-year CAGR
net_income_cagr_3y	number	Net income 3-year CAGR
fcf_cagr_3y	number	Free cash flow 3-year CAGR
book_value_cagr_3y	number	Book value 3-year CAGR
total_assets_cagr_3y	number	Total assets 3-year CAGR
dividend_rate_ttm	number	Dividend per share (TTM), in `currency`
fcf_payout_ratio_ttm	number	Free cash flow payout ratio (TTM)
dividend_cagr_3y	number	Dividend 3-year CAGR
dividend_frequency	stringenum	Payment frequency: `Monthly` / `Quarterly` / `Semi-Annual` / `Annual`, derived from the number of payments over the past two years; empty when there is no dividend record
price_date	date	Trading day of the closing price behind market cap and the valuation multiples; the price itself is not returned by this endpoint
statement_period_end	string	Period end of the latest statement the ratios are based on (`YYYY-MM-DD`, or a `YYYY-MM` year-month string in some markets)
statement_period	stringenum	Period code of that statement period: `FY` / `Q1` / `Q2` / `Q3` / `Q4`

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/financial-metrics-snapshot?ticker=AAPL"

Response · 200

{
  "data": [
    {
      "ticker": "AAPL",
      "market": "US",
      "currency": "USD",
      "shares_outstanding": 14780000000,
      "market_capitalization": 3421000000000,
      "market_capitalization_usd": 3421000000000,
      "enterprise_value": 3480000000000,
      "pe_ratio_ttm": 34.2,
      "peg_ratio_ttm": 2.9,
      "pb_ratio_ttm": 47.1,
      "ps_ratio_ttm": 8.5,
      "pcf_ratio_ttm": 28,
      "ev_to_sales_ttm": 8.7,
      "ev_to_ebitda_ttm": 26.3,
      "ev_to_ebit_ttm": 28.1,
      "gross_profit_margin_ttm": 0.463,
      "ebitda_margin_ttm": 0.334,
      "net_income_margin_ttm": 0.253,
      "fcf_margin_ttm": 0.27,
      "roe_ttm": 1.472,
      "roa_ttm": 0.29,
      "roic_ttm": 0.58,
      "revenue_growth_ttm": 0.061,
      "eps_growth_ttm": 0.083,
      "fcf_growth_ttm": 0.05,
      "revenue_cagr_3y": 0.04,
      "eps_cagr_3y": 0.09,
      "dividend_yield_ttm": 0.0042,
      "payout_ratio_ttm": 0.15,
      "dividend_growth_1y": 0.04,
      "consecutive_dividend_years": 13,
      "debt_to_equity": 1.45,
      "net_debt_to_equity": 0.24,
      "debt_to_assets": 0.29,
      "debt_to_ebitda": 0.62,
      "net_debt_to_ebitda": 0.1,
      "interest_coverage": 38.6,
      "ebitda_to_interest": 44.2,
      "current_ratio": 1.07,
      "quick_ratio": 1.02,
      "cash_ratio": 0.51,
      "working_capital": 9473000000,
      "operating_cash_flow_ratio": 0.89,
      "fcf_to_debt": 1.38,
      "ocf_to_debt": 1.54,
      "ebit_margin_ttm": 0.318,
      "capex_to_sales_ttm": 0.029,
      "asset_turnover_ttm": 1.19,
      "cash_per_share_ttm": 4.69,
      "ebitda_growth_ttm": 0.072,
      "ebit_growth_ttm": 0.059,
      "ocf_growth_ttm": 0.081,
      "ebitda_cagr_3y": 0.05,
      "ebit_cagr_3y": 0.04,
      "net_income_cagr_3y": 0.06,
      "fcf_cagr_3y": 0.03,
      "book_value_cagr_3y": -0.08,
      "total_assets_cagr_3y": 0.01,
      "dividend_rate_ttm": 1.04,
      "fcf_payout_ratio_ttm": 0.077,
      "dividend_cagr_3y": 0.042,
      "dividend_frequency": "Quarterly",
      "price_date": "2026-09-08",
      "statement_period_end": "2026-06-27",
      "statement_period": "Q3"
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.