Sign in
latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Stablecoin

Get cross-chain total supply for a token

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

get/api/stablecoin/v1/tokens/{token}/details

Path parameters

tokenstring required
Example:usd1

Token symbol or identifier for the stablecoin to get total supply for.

Query parameters

useCachedboolean
Example:true

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

Response

OK

tokenstring required

Token symbol or identifier

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

decimalsnumber required

Decimal precision of totalSupplyAggregated (the max decimals across all successful chains)

totalReservesstring required

Total reserves

Example response

{
  "token": "usd1",
  "totalSupplyAggregated": "\"2000000000000000000000\" (2000 tokens, with decimals=18)",
  "decimals": 18,
  "supplyByChain": [
    {
      "chain": "eth",
      "supply": "\"1000000000000000000000\" (1000 tokens on an 18-decimal chain)",
      "decimals": 18,
      "error": "Network timeout"
    }
  ]
}