REST API›Mint›Stablecoin

GET

Get cross-chain total supply for a token

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

Path Params

  • token string required
    Token symbol or identifier for the stablecoin to get total supply for.

    at least 1 characters

Query Params

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

Responses

200
OK

Response Body

object

  • token string required
    Token symbol or identifier

    at least 1 characters

  • 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.

    at least 1 characters

  • decimals number required
    Decimal precision of totalSupplyAggregated (the max decimals across all successful chains)
  • supplyByChain array of objects required
    supplyByChain object
    • chain string required
      Blockchain network identifier

      at least 1 characters

    • 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.

      at least 1 characters

    • 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

    at least 1 characters

400
Bad Request
No response body
404
Not Found
No response body
500
Internal Server Error
No response body