---
title: "Rate Shock Ladder Replay"
method: POST
path: "/v1/tools/run_rate_shock_ladder"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Rate Shock Ladder Replay

`POST /v1/tools/run_rate_shock_ladder`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/run_rate_shock_ladder`
- Auth: none declared

US OCC/FDIC interest-rate-risk parallel shock ladder: sweeps four prescribed parallel magnitudes (+/-100/200/300/400bp) over a bucketed repricing-gap schedule, returning both a duration-weighted delta-EVE leg and a 12-month cumulative-gap delta-NII leg per shock. Optional non-parallel steepener/flattener presets are caller-declared (short/long tenor bps split), not baked-in regulatory scalars. Distinct from the shipped BCBS d368 / EBA standardised six-scenario convention (art-183/art-185): sweeps multiple magnitudes rather than one, and combines EVE+NII in a single kernel. Complements CC-A repricing-gap schedules or user-supplied gap tables. NaN-safe. Zero network, zero PII.

**Tool URL:** https://ainumbers.co/chaingraph/art-369-run-rate-shock-ladder.html

## Request body

- object
  - `nii_12m_gap` unknown, required
  - `repricing_gaps` unknown
  - `shock_presets` unknown[], required
    - unknown

## Response `200`

Successful tool execution result

- object
  - `buckets_used` string[]
  - `convention` string
  - `ladder` object
    - `parallel_down_100bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_down_200bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_down_300bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_down_400bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_up_100bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_up_200bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_up_300bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
    - `parallel_up_400bp` object
      - `delta_eve` integer
      - `delta_nii` integer
      - `shock_bps` integer
  - `magnitudes_bps` integer[]
  - `nii_12m_gap` integer
  - `preset_shocks` object
    - `flattener` object
      - `delta_eve` integer
      - `delta_nii` string
      - `long_bps` integer
      - `short_bps` integer
    - `steepener` object
      - `delta_eve` integer
      - `delta_nii` string
      - `long_bps` integer
      - `short_bps` integer
  - `total_net_gap` integer
  - `worst_delta_eve` integer
  - `worst_scenario` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)