Financial Metrics

Financial Metrics provides computed ratios and per-share figures for a company, one row per reporting period. Each observation is derived from that period’s as-reported statements — margins, returns, leverage measures and per-share figures. Rows are returned newest first.

Plan: Free and above · Credits: 1 per call

What You Can Use Financial Metrics For

Compare profitability and returns across periods without recomputing them. Screen a company’s margin trend. Assemble valuation inputs alongside daily market cap. Avoid re-deriving ratios that would otherwise have to be recomputed consistently across companies with different reporting shapes.

Financial Metrics Coverage

Coverage follows the underlying statements: SEC filers, for the periods their XBRL filings cover. A metric is null where the inputs it needs were not reported for that period.

Key Financial Metrics Fields

Rows carry margin measures, return measures, per-share figures and leverage measures, alongside report_period, period, currency and accounting_standard.

Currency and Accounting Standard

Every row carries currency and accounting_standard. Currency values are as reported and are never converted to US dollars, so per-share and absolute figures are in the company’s own currency. Ratios are dimensionless and are comparable across currencies, but they are still affected by the accounting standard: us_gaap and ifrs define several inputs differently. Check both fields before comparing across companies.

Financial Metrics Date Convention

report_period is the end of the fiscal period the metrics are computed for, and it is what the report-period filters apply to. period is annual, quarterly, or ttm for a trailing-twelve-month window ending at report_period. Trailing-twelve-month metrics are computed from a rolling window rather than from a period the company reported as such.

Financial Metrics Sources

Metrics are calculated by FocusAlpha from the company’s own as-reported XBRL figures. They are not read from the filing, and companies do not publish them in this form. The inputs are as filed, so a metric inherits any peculiarity of the company’s own reporting.

Query Financial Metrics

Use the financial metrics endpoint. One of ticker or cik is required, and period is required.

string

Trading symbol. One of ticker or cik is required.

string

SEC Central Index Key. One of ticker or cik is required.

string

required

annual, quarterly or ttm.

string

Exact period end, YYYY-MM-DD. The _gte, _lte, _gt and _lt variants bound a range.

integer

default:"4"

Number of period rows to return, newest first.

See also Income Statements, Balance Sheets and Cash Flow Statements for the inputs, and Company Screening to filter the whole universe on fundamental measures rather than reading one company.

curl "https://api.focusalpha.ai/v1/financial-metrics?ticker=AAPL&period=annual&limit=2" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"

{
  "financial_metrics": [
    {
      "ticker": "AAPL",
      "cik": 320193,
      "report_period": "2025-09-27",
      "period": "annual",
      "fiscal_period": "FY",
      "currency": "USD",
      "accounting_standard": "us_gaap",
      "gross_margin": 0.4690516410716045,
      "operating_margin": 0.31970799762591884,
      "net_margin": 0.2691506412181824,
      "return_on_equity": 1.7142244974480232,
      "return_on_assets": 0.3093254683307996,
      "return_on_invested_capital": 0.8314270092598283,
      "current_ratio": 0.8932929222186667,
      "debt_to_equity": 1.3380304612588665,
      "revenue_growth": 0.0642551178283274,
      "earnings_growth": 0.19495177946573355,
      "earnings_per_share": 7.49,
      "book_value_per_share": 4.930454155878939,
      "free_cash_flow_per_share": 6.604453441656995,
      "payout_ratio": 0.1376752075707526,
      "enterprise_value": null,
      "price_to_earnings_ratio": null
    }
  ]
}

Get started

Core concepts

Screening tools

ETF data

Company essentials

Ownership & incentives

Advisers & investors

Real-time events

Account

What You Can Use Financial Metrics For

Financial Metrics Coverage

Key Financial Metrics Fields

Currency and Accounting Standard

Financial Metrics Date Convention

Financial Metrics Sources

Query Financial Metrics

​What You Can Use Financial Metrics For

​Financial Metrics Coverage

​Key Financial Metrics Fields

​Currency and Accounting Standard

​Financial Metrics Date Convention

​Financial Metrics Sources

​Query Financial Metrics

​Related Datasets

What You Can Use Financial Metrics For

Financial Metrics Coverage

Key Financial Metrics Fields

Currency and Accounting Standard

Financial Metrics Date Convention

Financial Metrics Sources

Query Financial Metrics

Related Datasets