Token collateral statistics
Verify that a reserve-backed token holds sufficient collateral before approving a mint or preparing a reconciliation pack.
Token collateral statistics expose the indexed backing state for one token. Use this endpoint to power reserve-backed asset dashboards and mint-control review.
For reconciliation packs, compare the indexed values with external reserve evidence for the same asset and reporting period.
The endpoint is read-only. It reports indexed collateral data and derived values. It does not issue a collateral claim, approve a mint, or prove that an off-chain reserve exists.
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 strings.
curl "https://your-platform.example.com/api/v2/tokens/0xTOKEN/stats/collateral-ratio" \
-H "X-Api-Key: sm_dalp_xxxxxxxxxxxxxxxx"{
"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
| 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 equals 100%; 20000 equals 200%; 0 disables collateral enforcement. |
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
If DALP has no indexed collateral stats for the token, the endpoint returns zero amounts, configuredCollateralRatioBps: 0, and parity_confidence: "degraded". Treat that response as missing or incomplete collateral-state data, not as proof that the asset has no reserve obligation.
parity_confidence: "degraded" signals that 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 you use the numbers in an audit pack or mint-readiness decision.
Reserve review boundary
The statistic is indexer-backed. DALP reads indexed collateral data and 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. You still need 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
- Authenticate the request with an API key that has access to the target tenant and system.
- Preserve collateral amounts as decimal-safe strings in clients and reports.
- Reconcile
totalCollateral,requiredCollateral, andmintableSupplyagainst the latest approved collateral claim and external reserve documentation. - Treat
parity_confidence: "degraded"as a review warning. Do not rely on degraded data as final reserve proof. - Check the mint transaction result separately. The stats endpoint supports your review; the configured collateral module enforces the mint check at transaction time.