Equity Financial Metrics

GET/gateway/v1/equity/metrics

Returns paginated standardized financial ratios, growth measures, per-share values, and valuation metrics for a US-listed equity.

Query Parameters

symbolstringrequired

US equity ticker symbol

Example: AAPL

periodenum<string>

Financial metric period

Available options:quarterlyannualttm

end_datestring

Inclusive latest period end date in YYYY-MM-DD format

Example: 2024-12-31

limitinteger

Maximum financial periods to return

Equity Financial Metrics

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/equity/metrics?symbol=AAPL&end_date=2024-12-31', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseEquityFinancialMetricsItem.json",
  "data": [
    {
      "asset_turnover": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "book_value_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "book_value_per_share": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "calculated_at": 123,
      "cash_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "change_in_cash_per_share": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "currency": "<string>",
      "current_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "days_sales_outstanding": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "debt_to_assets": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "debt_to_equity": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "earnings_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "earnings_per_share": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "earnings_per_share_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "ebit_margin": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "ebitda": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "ebitda_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "ebitda_margin": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "enterprise_value": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "enterprise_value_to_ebitda_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "enterprise_value_to_revenue_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "fiscal_period": "<string>",
      "fiscal_quarter": 123,
      "fiscal_year": 123,
      "free_cash_flow_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "free_cash_flow_margin": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "free_cash_flow_per_share": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "free_cash_flow_yield": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "gross_margin": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "interest_coverage": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "inventory_turnover": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "liabilities_to_assets": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "market_cap": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_debt": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "net_margin": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_cash_flow_per_share": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_cash_flow_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_cycle": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_income_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "operating_margin": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "payout_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "peg_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "period": "<string>",
      "price_to_book_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "price_to_earnings_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "price_to_sales_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "quick_ratio": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "receivables_turnover": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "report_period": "<string>",
      "return_on_assets": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "return_on_equity": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "return_on_invested_capital": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "revenue_growth": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      },
      "source_updated_at": 123,
      "symbol": "<string>",
      "working_capital_turnover": {
        "quality_reason_codes": [],
        "reason_code": "<string>",
        "source_accessions": [],
        "source_financial_metric_snapshot_ids": [],
        "source_revision_ids": [],
        "source_statement_ids": [],
        "status": "<string>",
        "value": 123,
        "value_origin": "<string>"
      }
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}