Ctrl+K

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

  • tokenstringRequired
    Token symbol or identifier for the stablecoin to get total supply for.
    Example: usd1
    Min length: >= 1 characters

Query Parameters

  • useCachedboolean
    Whether to return a cached response. Defaults to true (cached data). Set to false to force live data from the blockchain.
    Example:

200 Response

token string required
Token symbol or identifier
Min length: >= 1 characters
Example: usd1
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.
Min length: >= 1 characters
Example: "2000000000000000000000" (2000 tokens, with decimals=18)
decimals number required
Decimal precision of totalSupplyAggregated (the max decimals across all successful chains)
Example: 18
supplyByChain array[object] required
Breakdown of supply by chain
chain string required
Blockchain network identifier
Min length: >= 1 characters
Example: eth
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.
Min length: >= 1 characters
Example: "1000000000000000000000" (1000 tokens on an 18-decimal chain)
decimals number required
Number of decimal places for the token on this chain (e.g. 18 for EVM, 6 for Solana)
Example: 18
error string
Error message if supply fetch failed
Example: Network timeout
totalReserves string required
Total reserves
Min length: >= 1 characters

400 Response

404 Response

500 Response