getSupply

getSupply returns a snapshot of the SOL supply on Solana — how much of the native token exists and how much of it is actually in circulation. Because SOL is continuously minted through staking inflation, the supply moves over time, and this method gives you the current figures. POST a JSON-RPC 2.0 request to https://solana.therpc.io/YOUR_API_KEY and the node returns an RpcResponse whose value holds total (all SOL in existence), circulating (the freely transferable portion), nonCirculating (locked or reserved SOL), and nonCirculatingAccounts (the list of accounts counted as non-circulating). All amounts are reported in lamports.

Use cases

• Compute SOL's circulating market cap by converting value.circulating from lamports to SOL and multiplying by a price feed — the right denominator for market-cap math rather than total supply.
• Track the split between circulating and nonCirculating SOL over time to monitor how much of the supply is locked or reserved versus liquid.
• Use value.total as the replacement for the legacy getTotalSupply method, which no longer exists; the total SOL figure now lives inside this response.

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": "getSupply",
8  "params": [
9    {}
10  ]
11}'

Errors & troubleshooting

Common pitfalls

• Every amount — total, circulating, and nonCirculating — is in lamports. Divide by 1,000,000,000 (1e9) to get SOL, and use a big-integer or decimal type so you do not lose precision on these large numbers.
• The nonCirculatingAccounts list can be long and bloat the response. Pass excludeNonCirculatingAccountsList: true in the config object when you only need the supply totals, to return an empty list and lighten the payload.

Supported networks

• Mainnet
• Devnet

See also

• getLargestAccounts
• getInflationRate