---
title: "Multi-regime portfolio stress test"
method: POST
path: "/v1/finsec/scenario/stress-test"
---

# Multi-regime portfolio stress test

`POST /v1/finsec/scenario/stress-test`

## Request

- Base URL: `https://financesec.api.caleralabs.com`
- URL: `https://financesec.api.caleralabs.com/v1/finsec/scenario/stress-test`
- Auth: API key in header `X-License-Key`

Stress portfolio positions across superposed macro regimes. Returns covenant breach flags and SEC filing provenance per holding. List regimes via GET /api/regime/scenarios.

## Request body

- ScenarioStressTestRequest
  - `portfolio_id` string, required
  - `positions` object[], required
    - `ticker` string, required
    - `exposure_usd` number, required
  - `macro_shock_vector` object, required
    - `us10y_yield_delta_bps` number
    - `wti_crude_oil_pct` number
    - `us_dollar_index_delta_pct` number
    - `credit_spread_widening_bps` number
  - `superposition_regimes` string[], required

## Response `200`

Scenario stress test execution completed

- ScenarioStressTestResponse
  - `status` string
  - `solver_latency_ms` number
  - `zero_hallucination_proof` string
  - `portfolio_summary` object
    - `weighted_interest_expense_surge_usd` number
    - `covenant_breach_risk_score` number
    - `most_vulnerable_holding` string
    - `vulnerability_rationale` string
  - `position_stress_breakdown` object[]
    - `ticker` string
    - `metric_evaluated` string
    - `baseline_value` number
    - `shocked_value` number
    - `covenant_threshold` number
    - `breach_projected` boolean
    - `provenance` object
      - `filing` string
      - `accession` string
      - `xbrl_concept` string

---

[API](https://skmtc.dev/caleralabs/apis/financesec-api-reference.md) · [All operations](https://skmtc.dev/caleralabs/apis/financesec-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/caleralabs/apis/financesec-api-reference/revisions/fed76f2ec6e5?raw)