FocusAlphaDocs
Get key
API Reference

Financial Metrics

Pre-computed ratios per reporting period — margins, returns, liquidity, leverage, per-share figures, and growth rates — derived from the same SEC financials. One row per period, so you can chart a trend without computing the ratios yourself.

GET/v1/financial-metrics

Provide a ticker or cik and a period. Each row covers one reporting period and carries the source accession and filing URL when the canonical anchor observation has one.

Coverage & freshness
We cover ~2,000 US-listed companies — the entire S&P 500 plus roughly 1,500 more US mid- and small-caps — with numbers derived from SEC filings and kept current within about a day of a new 10-K or 10-Q. See Coverage & data source for the full list and the IFRS boundary.

Query parameters#

tickerstringoptional
US ticker, e.g. AAPL. Provide ticker or cik.
cikstringoptional
SEC Central Index Key — an alternative to ticker.
period"annual" | "quarterly" | "ttm"optional
Reporting period for each metrics row.
limitnumberoptional
Number of periods to return, newest first. Defaults to 4.
report_periodstringoptional
Return only the period whose report date equals this exact date (YYYY-MM-DD).
report_period_gtestringoptional
Date range filters on the report period (YYYY-MM-DD): report_period_gte / _lte / _gt / _lt.

Example request#

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

Response#

Returns a financial_metrics array, newest first. Each row shares the same identifying fields as Financials (ticker, cik, report_period, period, fiscal_period, currency, accession_number, filing_url) plus the metrics below. accession_number, filing_url, and fiscal_period may be null when the canonical anchor observation has no accession; any ratio that can’t be computed for a period is also null.

Profitability & returns#

gross_margin, operating_margin, net_margin, return_on_equity, return_on_assets, return_on_invested_capital.

Efficiency#

asset_turnover, inventory_turnover, receivables_turnover, days_sales_outstanding, operating_cycle, working_capital_turnover.

Liquidity & leverage#

current_ratio, quick_ratio, cash_ratio, operating_cash_flow_ratio, debt_to_equity, debt_to_assets, interest_coverage.

Per share & growth#

earnings_per_share, book_value_per_share, free_cash_flow_per_share, payout_ratio, revenue_growth, earnings_growth, earnings_per_share_growth, free_cash_flow_growth, operating_income_growth, ebitda_growth, book_value_growth.

Valuation ratios are market-dependent
Market-dependent ratios — enterprise_value, price_to_earnings_ratio, price_to_book_ratio, price_to_sales_ratio, enterprise_value_to_ebitda_ratio, enterprise_value_to_revenue_ratio, free_cash_flow_yield, and peg_ratio — are present in the schema but returned as null: they require pricing, and this dataset is SEC fundamentals only. Fundamentals-derived ratios (margins, returns, efficiency, liquidity, leverage, per-share, growth) are always computed.

Example response#

response.jsonjson
{
  "financial_metrics": [
    {
      "ticker": "AAPL",
      "cik": 320193,
      "report_period": "2024-09-28",
      "period": "annual",
      "fiscal_period": "FY",
      "currency": "USD",
      "accession_number": "0000320193-24-000123",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123",
      "gross_margin": 0.462,
      "operating_margin": 0.315,
      "net_margin": 0.239,
      "return_on_equity": 1.57,
      "return_on_assets": 0.257,
      "current_ratio": 0.867,
      "debt_to_equity": 1.87,
      "revenue_growth": 0.020
    }
  ]
}

Errors#

Statuses: 400 (missing both ticker and cik, or a missing or invalid period), 401 (bad or missing API key), 402 (per-minute rate limit or monthly quota exceeded), 404 (unresolvable ticker or CIK), 503 with a Retry-After header (temporarily unavailable — retry shortly), and 500. See Errors.