getTokenSupply

On Solana — the high-throughput chain whose native token is SOL — getTokenSupply returns the total supply of a token mint, summed across every account that holds it. The figure comes straight from the SPL Token (or Token-2022) mint account, so it reflects all mints and burns recorded on chain. Send a JSON-RPC 2.0 request with positional params to https://solana.therpc.io/YOUR_API_KEY, passing the mint address, and you get back the raw amount, the mint's decimals, and a uiAmountString.

Use cases

• Read a token's on-chain supply and multiply by price to compute an approximate market cap.
• Track supply changes over time as a mint authority issues new tokens or holders burn them — poll at finalized commitment for stable numbers.
• Display total supply in an explorer or token page alongside the figure shown on Solscan.

Parameters

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getTokenSupply",
8  "params": [
9    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
10    {}
11  ]
12}'

Errors & troubleshooting

Common pitfalls

• amount is a raw integer string in the mint's smallest unit — divide by 10 to the power of decimals, or just read uiAmountString, to get the human figure.
• The value reflects current on-chain supply: if the mint authority has not been revoked, the supply is still mintable and can rise on any later block, so cache it only briefly.

Supported networks

• Mainnet
• Devnet

See also

• getTokenLargestAccounts
• getSupply