Metric definitions and formulas
Plain-English reference for standard financial metrics, units, ratios, formulas, required inputs, and growth calculations.
This reference explains the standard financial metrics used by Rangler. It currently contains 140 metrics, 56 ratios, 6 unit formats, and 2 growth calculations.
Income statement metrics
Income, expense, profit, banking, insurance, and per-share concepts.
Balance-sheet metrics
Assets, liabilities, equity, reserves, deposits, and share counts.
Cash-flow metrics
Operating, investing, financing, and capital-expenditure cash flows.
Ratios and formulas
Profitability, returns, leverage, liquidity, banking, and valuation formulas.
Growth calculations
Supported growth periods, formulas, required metrics, and API formats.
Metric availability by company
The full metric list applies across Rangler, but a company response contains only the metrics supported by its filings and reporting model. A bank can return net_interest_income while an industrial issuer can return revenue and gross_profit.
These standard metrics do not replace issuer wording. Use reported tables when you need every printed line item or the exact label from a filing.
A metric definition explains what the value represents. Check metric_origins to learn whether a specific value came directly from a filing, was calculated from other line items, or was built from other periods.
Unit conventions
| Key | Unit | API format | Definition |
|---|---|---|---|
currency | Currency amount | base_currency_units | A monetary amount in the ISO 4217 currency declared by the containing period. Values are expanded to base currency units; a statement printed in thousands is not returned in thousands. |
per_share | Currency per share | currency_per_share | A monetary amount per share in the major unit of the ISO 4217 currency declared by the containing period. Reported subunits such as kobo or cents are converted to the major currency unit. |
currency_per_share | Currency per share | currency_per_share | A derived monetary amount per share in the containing period's ISO 4217 currency. |
percent | Percentage | decimal_fraction | A decimal fraction. For example, 0.184 represents 18.4 percent. |
ratio | Ratio or multiple | decimal_ratio | A decimal ratio with no currency or other unit. For example, 2.4 represents 2.4 times. |
shares | Share count | individual_shares | An absolute count of individual shares, expanded from any reported statement scale. |
Machine-readable catalog
Applications can retrieve the same catalog as JSON:
curl -s "https://api.rangler.co/v1/financials/metric-catalog" \
-H "X-API-Key: rgl_live_your_key_here" | python3 -m json.toolThe endpoint returns the same metric list for every company. Applications can use it to find available keys, format values, check formulas, and record which catalog version they used.
Current generated catalog version: sha256:6b4eb2d565686cd7f5961dc870478224055c51aea363fd8c2ba5de8c47644410.
Versioning and caching
Every standardized statement response includes catalog_version. Cache the catalog under that version and fetch it again only when the version changes. Keep older versions if you need to recreate a previous export.