---
title: "UMR / AANA Readiness Diagnostic"
method: POST
path: "/v1/tools/run_umr_aana_readiness"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# UMR / AANA Readiness Diagnostic

`POST /v1/tools/run_umr_aana_readiness`

## Request

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

Determines whether a group's declared AANA (average aggregate notional amount) puts it in scope for the uncleared margin rules (UMR), per AT-CLEARING-WAVE-SPEC.md CW-2, and flags which counterparties are over the regulatory initial-margin threshold with an open documentation or custody gap. Thresholds (AANA >EUR 8bn, IM threshold EUR 50m) are pinned constants echoed in the output as constants_version + vintage, never fetched. This is an eligibility/readiness checker, not a SIMM calculator -- estimated IM per counterparty is always a caller declaration, never derived here from risk-class sensitivities, since SIMM is a licensed ISDA methodology not reproduced by this node. Distinct from the shipped TradFi treasury-clearing cluster (art-48..51), which addresses the US Treasury cash/repo clearing mandate, and from the crypto cross-venue margin estimator (art-406). This receipt attests our computation over the AANA and per-counterparty inputs the caller declared -- it does not audit those inputs and is not a determination that any entity is in or out of UMR scope.

**Tool URL:** https://ainumbers.co/chaingraph/art-407-umr-aana-readiness-diagnostic.html

## Request body

- object
  - `aana_group_eur` number
  - `counterparties` unknown[], required
    - unknown

## Response `200`

Successful tool execution result

- object
  - `aana_group_eur` integer
  - `aana_in_scope_threshold_eur` integer
  - `constants_version` string
  - `counterparties` object[]
    - `counterparty_id` string
    - `custodian_ready` boolean
    - `documentation_status` string
    - `estimated_im_eur` integer
    - `over_im_threshold` boolean
    - `readiness_grade` string
  - `counterparties_over_im_threshold` integer
  - `counterparty_count` integer
  - `disambiguation` string
  - `im_threshold_eur` integer
  - `in_scope_aana` boolean
  - `note` string
  - `overall_grade` string
  - `remediation_checklist` object[]
    - `action` string
    - `counterparty_id` string
  - `thresholds_vintage` 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)