ApiFinance AI logo
Dashboard Sign in

Fundamental Metrics

Retrieve normalized research metrics for a symbol using the latest available TTM or annual financial period.

Use this endpoint when you want research-ready quality, efficiency, leverage, liquidity, and payout metrics without recomputing them from raw statements.

Endpoint

GET /stocks/{symbol}/fundamental-metrics
Test request
/stocks/AAPL/fundamental-metrics

You can inspect the health endpoint without a key, but most endpoints require one. Create a free account to run the full workflow.

Send a request to view the response.

Authentication

Required.

Authorization: Bearer <your_api_key>

Path Parameters

  • symbol: ticker or symbol to resolve

What The Endpoint Is Good For

Use fundamental-metrics when you need to:

  • screen stocks by quality or capital efficiency
  • compare leverage and liquidity across companies
  • feed AI-agent research prompts with normalized ratios
  • avoid rebuilding the same formula layer on the client side

Response

Returns:

  • metadata
  • metrics

metadata includes:

  • symbol
  • as_of_date
  • period_type
  • currency
  • calculation_version

metrics includes:

  • gross_margin
  • operating_margin
  • net_margin
  • fcf_margin
  • ebit_margin
  • ebitda_margin
  • roic
  • roce
  • roe
  • roa
  • croic
  • asset_turnover
  • inventory_turnover
  • receivables_turnover
  • debt_to_equity
  • net_debt_to_ebitda
  • interest_coverage
  • current_ratio
  • quick_ratio
  • cash_conversion_ratio
  • shareholder_yield
  • buyback_yield
  • dividend_yield_ttm

Response Notes

  • The imported snapshot currently prefers the latest available ttm financial period and falls back to the latest annual period if needed.
  • Metrics are materialized during import and served from a stored snapshot, so research clients and agents do not need to repeat the same calculations.
  • Some metrics may be unavailable for certain securities or sectors if the necessary denominator fields are missing.
  • calculation_version is included so downstream systems can track methodology changes over time.

Common Workflow

  1. Resolve the symbol with Search if needed.
  2. Call fundamental-metrics for normalized research ratios.
  3. Use Quote for current trading context.
  4. Use statement endpoints if you need to inspect the raw underlying fields.

Example Request

curl -H "Authorization: Bearer $your_api_key" \
  "https://api.apifinance.ai/stocks/AAPL/fundamental-metrics"

Related Endpoints

Next step

Run this endpoint with your own API key

Use the playground to inspect the response first, then create a key and move into implementation once the payload fits your product.

Get Free API KeyOpen playground

Cash Flow Statement

Retrieve quarterly or annual cash flow statement periods for a symbol.

Growth

Retrieve annualized revenue, EPS, free cash flow, per-share book value, share-count, and dividend growth for a symbol.