# Token collateral statistics Source: https://docs.settlemint.com/docs/developers/api-integration/tokens/token-collateral-statistics Read indexed collateral, required backing, mintable supply, utilization, and confidence data for reserve-backed tokens through the DALP API. Token collateral statistics show the indexed backing state DALP can read for one token. Use this endpoint for reserve-backed asset dashboards and mint-control review. For reconciliation packs, compare DALP state with the external reserve evidence for the same asset and reporting period. The endpoint is read-only. It reports indexed collateral state and derived values. It does not issue a collateral claim, approve a mint, or prove that an off-chain reserve exists. ## Read collateral statistics [#read-collateral-statistics] Call the token statistics endpoint with the token address in the path. The response uses the single-resource envelope and preserves amount fields as decimal-safe values. ```bash curl "https://your-platform.example.com/api/v2/tokens/0xTOKEN/stats/collateral-ratio" \ -H "X-Api-Key: sm_dalp_xxxxxxxxxxxxxxxx" ``` ```json { "data": { "buckets": [ { "name": "collateralAvailable", "value": "250000.000000000000000000" }, { "name": "collateralUsed", "value": "750000.000000000000000000" } ], "totalCollateral": "1000000.000000000000000000", "requiredCollateral": "750000.000000000000000000", "mintableSupply": "1000000.000000000000000000", "collateralizationPercentage": 133.3, "configuredCollateralRatioBps": 10000, "parity_confidence": "high", "utilizationPercentage": 75 }, "links": { "self": "/v2/tokens/0xTOKEN/stats/collateral-ratio" } } ``` ## Fields [#fields] | Field | Type | Notes | | ------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `tokenAddress` | path string | Token contract address in the active tenant and system scope. | | `buckets[].name` | string | Collateral bucket name. DALP returns `collateralAvailable` and `collateralUsed`. | | `buckets[].value` | decimal value | Bucket amount after token decimals are applied for display-safe API output. | | `totalCollateral` | decimal value | Total collateral amount from the indexed valid collateral claim selected for the token. | | `requiredCollateral` | decimal value | Collateral required for the current indexed token supply and configured ratio. | | `mintableSupply` | decimal value | Maximum token supply that the current collateral amount can support at the configured collateral ratio. | | `collateralizationPercentage` | number | `totalCollateral / requiredCollateral * 100` when a requirement exists. Values above 100 mean the indexed collateral exceeds the requirement. | | `configuredCollateralRatioBps` | number | Configured collateral ratio in basis points. `10000` means 100%; `20000` means 200%; `0` means collateral enforcement is disabled. | | `parity_confidence` | string | `high` when indexed claim data is complete for the calculation, or `degraded` when malformed or incomplete collateral data was detected. | | `utilizationPercentage` | number | `requiredCollateral / totalCollateral * 100` when collateral exists. Values above 100 indicate the indexed requirement exceeds available collateral. | ## Empty and degraded states [#empty-and-degraded-states] If DALP has no indexed collateral stats for the token, the endpoint returns zero amounts, `configuredCollateralRatioBps: 0`, and `parity_confidence: "degraded"`. Treat that as missing or incomplete collateral-state data, not as proof that the asset has no reserve obligation. `parity_confidence: "degraded"` means the available indexed data included a malformed claim amount, missing registry address, or incomplete legacy collateral-parameter data. Refresh the collateral claim evidence and recheck indexing before using the numbers for an audit pack or mint-readiness decision. ## Reserve review boundary [#reserve-review-boundary] The statistic is indexer-backed. DALP reads indexed token collateral stats and collateral anomalies, applies token decimals, and returns total collateral, required collateral, mintable supply, collateralization, utilization, and confidence values. Those values support review. They are not a standalone proof of reserve. A reviewer still needs the reserve report, custodian statement, verifier attestation, vault record, treasury file, or audit evidence behind the collateral claim. Use the API response to compare DALP token state with that external evidence for the same asset, reporting period, and verifier attestation. ## Production handling [#production-handling] * Authenticate the request with an API key that has access to the target tenant and system. * Preserve collateral amounts as decimal-safe values in clients and reports. * Reconcile `totalCollateral`, `requiredCollateral`, and `mintableSupply` against the latest approved collateral claim and external reserve evidence. * Treat `parity_confidence: "degraded"` as a review warning. Do not use degraded data as final reserve evidence. * Check the mint transaction result separately. The stats endpoint supports review, while the configured collateral module enforces the mint check at transaction time. ## Related [#related] * [Supply cap and collateral](/docs/compliance-security/security/compliance/supply-cap-collateral) * [Collateral requirement](/docs/operators/compliance/collateral) * [Token lifecycle API](/docs/developers/api-integration/tokens/token-lifecycle) * [Token volume statistics](/docs/developers/api-integration/tokens/token-volume-statistics) * [Stablecoin operating responsibilities](/docs/compliance-security/security/stablecoin-architecture-trust-boundaries)