getTokenSupply

POSTTokensAll plans

Returns the total supply of an SPL Token or Token-2022 mint.

Try itSends a real request from your browser to the selected region.
POST
/

getTokenSupply returns a mint's total supply as a raw integer and pre-divided by its decimals.

It reflects on-chain mint state at the requested commitment level, updating immediately as tokens are minted or burned.

Plans & rate limitsAll plans
Free5/s
Operator50/s
Blade Runner200/s
Nexus500/s

Parameters

params is a JSON array, with values in this order: mint, config.

1mintstringrequired

Address of the mint account to check, base-58 encoded.

2configobject

Commitment configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to read the supply from.

Allowed values:finalizedconfirmedprocessed

Result

resultobject

The token supply, wrapped with context.

Show propertiesProperties
contextobjectrequired
Show propertiesProperties
slotinteger
apiVersionstring
valueobjectrequired
Show propertiesProperties
amountstringrequired

Raw total supply in the mint's smallest unit, as a string.

decimalsintegerrequired

Number of decimal places the mint uses.

uiAmountnumber | null

Supply divided by 10^decimals, as a float.

uiAmountStringstringrequired

Supply divided by 10^decimals, as an exact decimal string.

Notes

  • uiAmountString avoids the precision limits of uiAmount, a JSON float, for large-supply tokens.
  • Wrapped SOL (So11111111111111111111111111111111111111112) always reports supply 0, since it is tracked via each token account's lamport balance, not the mint's supply counter.