---
title: "Settlement Efficiency KPI Engine"
method: POST
path: "/v1/tools/compute_settlement_efficiency_kpi"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Settlement Efficiency KPI Engine

`POST /v1/tools/compute_settlement_efficiency_kpi`

## Request

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

Aggregates batch settlement data into CSDR/T+1-relevant KPIs: settlement rate, fail rate, total CSDR penalty cost, on-time allocation rate, SSI golden-source coverage, buy-in triggered count, and fail-duration distribution. Benchmarks against ESMA annual settlement-efficiency statistics (~97.5% EU average).

**Tool URL:** https://ainumbers.co/chaingraph/art-84-settlement-efficiency-kpi.html

## Request body

- object
  - `instructions` unknown
  - `period_label` string: type not evidenced by kernel source

## Response `200`

Successful tool execution result

- object
  - `benchmark` object
    - `esma_settlement_rate_pct` number
    - `source` string
  - `buyin_triggered_count` integer
  - `fail_duration_distribution` object
    - `1_day` integer
    - `2_to_5_days` integer
    - `6_to_10_days` integer
    - `over_10_days` integer
  - `fail_rate` integer
  - `note` string
  - `on_time_allocation_rate` integer
  - `period_label` string
  - `settlement_grade` string
  - `settlement_rate` integer
  - `ssi_golden_coverage_pct` integer
  - `total_instructions` integer
  - `total_penalty_cost` 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)