---
title: "Custody Segregation Ratio"
method: POST
path: "/v1/tools/compute_custody_segregation_ratio"
tags: ["compliance_control", "custody", "proof-of-reserves", "exchange-assurance"]
---

# Custody Segregation Ratio

`POST /v1/tools/compute_custody_segregation_ratio`

## Request

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

Generic, jurisdiction-neutral custody-segregation check: segregated_custody_assets_musd / customer_claims_musd, per asset class and rolled up. FULLY_SEGREGATED at or above 1.0, UNDER_SEGREGATED below it, OVER_SEGREGATED above an optional configurable ceiling. A zero-claims line resolves segregation_ratio null and status NO_CLAIMS_OUTSTANDING -- never a division artifact. Aggregate totals only (no per-customer or per-wallet line item). SEC Rule 15c3-3 possession-or-control (17 CFR 240.15c3-3(b)) is named as one crosswalk-annex instance among possibly several -- the arithmetic does not depend on that citation, and the SEC 15c3-3 Exhibit A reserve formula stays a distinct, unedited node (art-396).

**Tool URL:** https://ainumbers.co/chaingraph/art-538-custody-segregation-ratio.html

## Request body

- object
  - `over_segregation_ceiling` number
  - `segregated_assets` object[]
    - `asset_class` string
    - `custody_location_type` string
    - `amount_musd` number
  - `customer_claims` object[]
    - `asset_class` string
    - `amount_musd` number

## Response `200`

Successful tool execution result

- object
  - `line_items` object[]
    - `asset_class` string
    - `segregated_custody_assets_musd` number
    - `customer_claims_musd` number
    - `segregation_ratio` number, nullable
    - `status` string
  - `total_segregated_musd` number
  - `total_claims_musd` number
  - `segregation_ratio` number, nullable
  - `status` string
  - `over_segregation_ceiling` number, nullable
  - `custody_location_breakdown` object
  - `formula` string
  - `note` 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)