---
title: "Credit Concentration Top-N / Sector Checker"
method: POST
path: "/v1/tools/check_credit_concentration_topn_sector"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Credit Concentration Top-N / Sector Checker

`POST /v1/tools/check_credit_concentration_topn_sector`

## Request

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

Credit-concentration screen over a flat exposure list (name, sector, amount): returns the top-N single-name exposures by amount, a per-sector rollup, single-name and sector Herfindahl-Hirschman Index (0-10000 scale), and a breach list against caller-declared single-name and sector limit percentages. Concentration limits are your own institution's risk-appetite policy, not a fixed regulatory threshold, so nothing is baked in. Distinct from the shipped IRRBB/NII shock kernels (art-183/art-185/art-369), which measure rate-risk exposure rather than name/sector diversification. NaN-safe. Zero network, zero PII.

**Tool URL:** https://ainumbers.co/chaingraph/art-445-credit-concentration-topn-sector.html

## Request body

- object
  - `exposures` unknown[], required
    - unknown
  - `sector_limit_pct` unknown, required
  - `single_name_limit_pct` unknown, required
  - `top_n` unknown, required

## Response `200`

Successful tool execution result

- object
  - `portfolio_total` integer
  - `sector_breaches` object[]
    - `pct_of_portfolio` integer
    - `sector` string
  - `sector_hhi` number
  - `sector_limit_pct` integer
  - `sector_totals` object[]
    - `amount` integer
    - `pct_of_portfolio` integer
    - `sector` string
  - `single_name_breaches` object[]
    - `name` string
    - `pct_of_portfolio` number
  - `single_name_hhi` number
  - `single_name_limit_pct` integer
  - `top_n` integer
  - `top_n_exposures` object[]
    - `amount` integer
    - `name` string
    - `pct_of_portfolio` number
    - `sector` string
  - `worst_sector` string
  - `worst_single_name` 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)