# Supported metric catalog

The API exposes **82** metrics, listed below by category. Use the **name** column verbatim wherever the API takes a metric id (e.g. `metric_names` on `POST /metric/items`, `formula_override` keys, `metric_names` on `POST /metric/historical`). Names marked **★** are **price-sensitive** — their realtime values require `current_price` in the request body (see [`POST /metric/all`](/documents/post-metricall.md)).

## Profitability (10)

| Name | Unit | Formula |
|------|------|---------|
| `gross_margin` | ratio | `(Revenue - CostOfRevenue) / Revenue` |
| `operating_margin` | ratio | `OperatingIncome / Revenue` |
| `net_margin` | ratio | `NetIncome / Revenue` |
| `ebitda_margin` | ratio | `(OperatingIncome + DepreciationAndAmortization) / Revenue` |
| `nopat` | reporting currency | `NI_cont + NetFinancialExpenseAfterTax` |
| `nopat_reported_oi_proxy` | reporting currency | `OperatingIncome * (1 - TaxRate)` |
| `nopat_margin` | ratio | `NOPAT / Revenue` |
| `owner_earnings_estimate` | reporting currency | `CFO - MaintenanceCapex - SBC_CF` |
| `owner_earnings_cash_proxy` | reporting currency | `CFO - Capex - SBC_CF` |
| `owner_earnings_per_share` | reporting currency | `OE_common / Shares_avg` |

## Returns (5)

| Name | Unit | Formula |
|------|------|---------|
| `return_on_equity` | ratio | `NetIncome / ((Equity + EquityPrior) / 2)` |
| `return_on_assets` | ratio | `NetIncome / ((Assets + AssetsPrior) / 2)` |
| `return_on_invested_capital` | ratio | `NetIncome / (((Equity + LongTermDebt + ShortTermDebt) + (EquityPrior + LongTermDebtPrior + ShortTermDebtPrior)) / 2)` |
| `return_on_tangible_equity` | ratio | `NetIncome / (((Equity - Goodwill - Intangibles) + (EquityPrior - GoodwillPrior - IntangiblesPrior)) / 2)` |
| `return_on_net_operating_assets` | ratio | `NOPAT / AvgNOA` |

## Leverage (8)

| Name | Unit | Formula |
|------|------|---------|
| `debt_to_equity` | ratio | `(LongTermDebt + ShortTermDebt) / Equity` |
| `debt_to_assets` | ratio | `(LongTermDebt + ShortTermDebt) / Assets` |
| `debt_to_ebitda` | ratio | `(LongTermDebt + ShortTermDebt) / (OperatingIncome + DepreciationAndAmortization)` |
| `interest_coverage` | ratio | `OperatingIncome / InterestExpense` |
| `net_debt` | reporting currency | `Debt - UnrestrictedCash` |
| `net_debt_to_ebitda` | ratio | `NetDebt / OperatingEBITDA` |
| `net_financial_obligations` | reporting currency | `FO - FA` |
| `net_financial_expense_after_tax` | reporting currency | `(InterestExpenseDebt - InterestIncome) * (1 - TaxRate)` |

## Liquidity (3)

| Name | Unit | Formula |
|------|------|---------|
| `current_ratio` | ratio | `CurrentAssets / CurrentLiabilities` |
| `quick_ratio` | ratio | `(CurrentAssets - Inventory) / CurrentLiabilities` |
| `cash_ratio` | ratio | `Cash / CurrentLiabilities` |

## Efficiency / activity (10)

| Name | Unit | Formula |
|------|------|---------|
| `asset_turnover` | ratio | `Revenue / ((Assets + AssetsPrior) / 2)` |
| `inventory_turnover` | ratio | `CostOfRevenue / Inventory` |
| `receivables_turnover` | ratio | `Revenue / AccountsReceivable` |
| `days_inventory` | days | `PeriodDays * Inventory / CostOfRevenue` |
| `days_receivable` | days | `PeriodDays * AccountsReceivable / Revenue` |
| `days_payable` | days | `PeriodDays * AccountsPayable / CostOfRevenue` |
| `cash_conversion_cycle` | days | `days_inventory + days_receivable − days_payable` |
| `payables_turnover` | ratio | `CostOfRevenue / ((AccountsPayable + AccountsPayablePrior) / 2)` |
| `net_operating_assets` | reporting currency | `TotalAssets - TotalLiabilities + FO - FA` |
| `net_operating_asset_turnover` | ratio | `Revenue / AvgNOA` |

## Cash flow & shareholder returns (18)

| Name | Unit | Formula |
|------|------|---------|
| `free_cash_flow` | reporting currency | `CFO - Capex` |
| `fcf_margin` | ratio | `(CFO - Capex) / Revenue` |
| `payout_ratio` | ratio | `Dividends / NetIncome` |
| `free_cash_flow_per_share` | reporting currency | `FCF / Shares_avg` |
| `free_cash_flow_after_sbc` | reporting currency | `FCF - SBC_PL` |
| `fcf_ex_sbc_addback` | reporting currency | `FCF - SBC_CF` |
| `free_cash_flow_cagr_3y` | ratio | `(FCF_t / FCF_t-3)^(1/3) - 1` |
| `free_cash_flow_cagr_5y` | ratio | `(FCF_t / FCF_t-5)^(1/5) - 1` |
| `free_cash_flow_cagr_10y` | ratio | `(FCF_t / FCF_t-10)^(1/10) - 1` |
| `free_cash_flow_per_share_cagr_3y` | ratio | `(FCF_per_share_t / FCF_per_share_t-3)^(1/3) - 1` |
| `free_cash_flow_per_share_cagr_5y` | ratio | `(FCF_per_share_t / FCF_per_share_t-5)^(1/5) - 1` |
| `free_cash_flow_per_share_cagr_10y` | ratio | `(FCF_per_share_t / FCF_per_share_t-10)^(1/10) - 1` |
| `cfo_to_net_income` | ratio | `CFO / NI` |
| `fcf_to_net_income` | ratio | `FCF / NI` |
| `cash_distributions_to_fcf` | ratio | `(CommonCashDividends + PreferredCashDividends + NCICashDistributions) / FCF` |
| `common_dividend_burden_on_group_fcf` | ratio | `CommonCashDividends / FCF` |
| `sbc_to_revenue` | ratio | `SBC_PL / Revenue` |
| `sbc_to_fcf` | ratio | `SBC_PL / FCF` |

## Valuation — price-sensitive (13) ★

These require `current_price` in the request body to compute their realtime values; without it the `realtime` block returns the standard *missing-price* hint.

| Name | Unit | Formula |
|------|------|---------|
| `market_cap` ★ | reporting currency | `SharesOutstanding * Price` |
| `enterprise_value` ★ | reporting currency | `MarketCap + LongTermDebt + ShortTermDebt - Cash` |
| `pe_ratio` ★ | ratio | `Price / EPS` |
| `price_to_book` ★ | ratio | `MarketCap / Equity` |
| `price_to_sales` ★ | ratio | `MarketCap / Revenue` |
| `price_to_cash_flow` ★ | ratio | `MarketCap / CFO` |
| `ev_to_ebitda` ★ | ratio | `EnterpriseValue / (OperatingIncome + DepreciationAndAmortization)` |
| `ev_to_revenue` ★ | ratio | `EnterpriseValue / Revenue` |
| `ev_to_fcf` ★ | ratio | `EnterpriseValue / (CFO - Capex)` |
| `fcf_yield` ★ | ratio | `(CFO - Capex) / MarketCap` |
| `dividend_yield` ★ | ratio | `DividendsPerShare / Price` |
| `buyback_yield` ★ | ratio | `StockRepurchases / MarketCap` |
| `owner_earnings_yield` ★ | ratio | `OE_common / MarketCap` |

## Growth (15)

Year-over-year (yoy) growth compares the current period to the same period one year earlier; quarter-over-quarter (qoq) compares the current quarter to the immediately preceding quarter.

| Name | Unit | Formula |
|------|------|---------|
| `revenue_growth_yoy` | ratio | `(Revenue_t - Revenue_{t-4Q}) / Revenue_{t-4Q}` |
| `revenue_growth_qoq` | ratio | `(Revenue_t - Revenue_{t-1Q}) / Revenue_{t-1Q}` |
| `revenue_growth_qoq_single_quarter` | ratio | `(Revenue_Qn_single - Revenue_Q(n-1)_single) / Revenue_Q(n-1)_single` |
| `eps_growth_yoy` | ratio | `(EPS_t - EPS_{t-4Q}) / EPS_{t-4Q}` |
| `net_income_growth_yoy` | ratio | `(NI_t - NI_{t-4Q}) / NI_{t-4Q}` |
| `fcf_growth_yoy` | ratio | `(FCF_t - FCF_{t-4Q}) / FCF_{t-4Q}` |
| `revenue_cagr_3y` | ratio | `(Revenue_t / Revenue_t-3)^(1/3) - 1` |
| `revenue_cagr_5y` | ratio | `(Revenue_t / Revenue_t-5)^(1/5) - 1` |
| `revenue_cagr_10y` | ratio | `(Revenue_t / Revenue_t-10)^(1/10) - 1` |
| `diluted_eps_cagr_3y` | ratio | `(DilutedEPS_t / DilutedEPS_t-3)^(1/3) - 1` |
| `diluted_eps_cagr_5y` | ratio | `(DilutedEPS_t / DilutedEPS_t-5)^(1/5) - 1` |
| `diluted_eps_cagr_10y` | ratio | `(DilutedEPS_t / DilutedEPS_t-10)^(1/10) - 1` |
| `shares_outstanding_cagr_3y` | ratio | `(Shares_end_t / Shares_end_t-3)^(1/3) - 1` |
| `shares_outstanding_cagr_5y` | ratio | `(Shares_end_t / Shares_end_t-5)^(1/5) - 1` |
| `shares_outstanding_cagr_10y` | ratio | `(Shares_end_t / Shares_end_t-10)^(1/10) - 1` |

Notes:
- A filing may not have every metric in this catalog.
- Non-USD reporters (20-F / 40-F filings whose `reporting_currency` is e.g. `brl`, `eur`) report `free_cash_flow` and `market_cap` / `enterprise_value` in their local currency; the per-metric `unit` field carries the actual currency.