---
title: "Settlement-Fail Predictor"
method: POST
path: "/v1/tools/predict_settlement_fail"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Settlement-Fail Predictor

`POST /v1/tools/predict_settlement_fail`

## Request

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

Scores a trade's fail probability from anonymized configuration features (SSI match status, instrument liquidity tier, counterparty fail-history band, deadline proximity, partial-settlement availability) and ranks a batch for pre-settlement intervention. No PII. Transparent weighted scorecard: dominant driver per trade.

**Tool URL:** https://ainumbers.co/chaingraph/art-79-settlement-fail-predictor.html

## Request body

- object
  - `trades` unknown

## Response `200`

Successful tool execution result

- object
  - `batch_fail_rate_estimate` integer
  - `methodology` object
    - `data_source` string
    - `description` string
    - `feature_weights` object
      - `counterparty_fail_band` string
      - `deadline_proximity` string
      - `inventory_status` string
      - `liquidity_tier` string
      - `partial_available` string
      - `ssi_match_status` string
  - `note` string
  - `scored_trades` unknown[]
    - unknown
  - `top_drivers` unknown[]
    - unknown
  - `trade_count` integer

---

[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)