---
title: "Get cross-chain total supply for a token"
method: GET
path: "/api/stablecoin/v1/tokens/{token}/details"
tags: ["Stablecoin"]
---

# Get cross-chain total supply for a token

`GET /api/stablecoin/v1/tokens/{token}/details`

Returns the aggregated total supply for a token across all supported chains.

## Path parameters

- `token` string, required

## Query parameters

- `useCached` boolean

## Response `200`

OK

- GetTokenDetailsResponse
  - `token` string, required — Token symbol or identifier
  - `totalSupplyAggregated` string, required — Total supply across all chains, normalized to the highest decimal precision among chains. Each chain's supply is scaled to this common precision before summing: chainSupply * 10^(decimals - chain.decimals). Divide by 10^decimals for the human-readable total. Note: supplyByChain[].supply values use each chain's own decimals, not this one.
  - `decimals` number, required — Decimal precision of totalSupplyAggregated (the max decimals across all successful chains)
  - `supplyByChain` object[], required
    - `chain` string, required — Blockchain network identifier
    - `supply` string, required — Total supply for this chain in the chain's native smallest unit. Divide by 10^decimals to get the human-readable token amount. Note: this is NOT normalized to the aggregated decimals — use the per-chain decimals field to interpret.
    - `decimals` number, required — Number of decimal places for the token on this chain (e.g. 18 for EVM, 6 for Solana)
    - `error` string — Error message if supply fetch failed
  - `totalReserves` string, required — Total reserves

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)