---
title: "Get Scenario Analysis"
method: GET
path: "/api/valuation/{ticker}/scenarios"
tags: ["scenarios"]
---

# Get Scenario Analysis

`GET /api/valuation/{ticker}/scenarios`

## Request

- Base URL: `https://api.equity-rank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.equity-rank.com/api/valuation/{ticker}/scenarios`
- Auth: HTTP bearer

Return Bear/Base/Bull DCF scenario model estimates, 5x5 sensitivity matrix,
and rate sensitivity table for a ticker.

- Missing financial data returns data_complete=false with partial info.
- Never returns 500 on legitimate data gaps.
- recession_scenario: sector-specific recession model estimate (wired).

Model estimates only. Not a price forecast or investment advice.

## Path parameters

- `ticker` string, required: US equity ticker, e.g. NVDA

## Response `200`

Successful Response

- ScenarioAnalysisResult: Top-level API response for GET /api/valuation/{ticker}/scenarios.
  - `ticker` string, required
  - `data_complete` boolean, required
  - `bear_base_bull` BearBaseBullResult, required: Container for the three Bear/Base/Bull DCF scenario points.
    - `bear` ScenarioPoint, required: A single Bear, Base, or Bull DCF scenario result.
      - `label` string, required
      - `fair_value` number, nullable, required
      - `revenue_delta_pp` number, required
      - `margin_delta_pp` number, required
      - `coe_delta_bps` number, required
      - `assumptions_note` string, required
    - `base` ScenarioPoint, required: A single Bear, Base, or Bull DCF scenario result.
      - `label` string, required
      - `fair_value` number, nullable, required
      - `revenue_delta_pp` number, required
      - `margin_delta_pp` number, required
      - `coe_delta_bps` number, required
      - `assumptions_note` string, required
    - `bull` ScenarioPoint, required: A single Bear, Base, or Bull DCF scenario result.
      - `label` string, required
      - `fair_value` number, nullable, required
      - `revenue_delta_pp` number, required
      - `margin_delta_pp` number, required
      - `coe_delta_bps` number, required
      - `assumptions_note` string, required
    - `data_complete` boolean
  - `sensitivity_matrix` SensitivityMatrix: 5x5 revenue x margin sensitivity grid (SA-02). grid[row][col] corresponds to margin_deltas_pp[row] and revenue_deltas_pp[col]. None means DataUnavailableError for that cell.
    - `revenue_deltas_pp` number[], required
    - `margin_deltas_pp` number[], required
    - `grid` array[], required
      - number[]
  - `rate_sensitivity` RateSensitivityTable: Rate-sensitivity table: five rate-shock rows + equity duration (SA-02).
    - `equity_duration` number, nullable, required
    - `rows` RateSensitivityRow[], required
      - `rate_shock_bps` integer, required
      - `delta_fv` number, nullable, required
      - `stressed_fv` number, nullable, required
  - `recession_scenario` RecessionScenario: Recession stress scenario using sector-specific haircut table (SA-04).
    - `sector` string, required
    - `revenue_haircut_pct` number, required
    - `margin_compression_bps` number, required
    - `fair_value` number, nullable, required
    - `assumptions_note` string, required
  - `disclaimer` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/equity-rank/apis/equity-rank-api.md) · [All operations](https://skmtc.dev/equity-rank/apis/equity-rank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/equity-rank/apis/equity-rank-api/revisions/c2f2463fee33?raw)