Skip to main content

Services documentation

Use high performance APIs provided by Infura to scale your dapp or Snap.

getSupply

Returns information about the current token supply. This method uses 160 credits from your daily balance.

Parameters

  • config: (object) [optional] - Configuration object with the following options:
    • commitment: (string) [optional] - The commitment level to use for the query. The default is finalized. Possible values are:
      • finalized - Queries the most recent block confirmed by a super majority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
      • confirmed - Queries the most recent block that has been voted on by a super majority of the cluster.
      • processed - Queries its most recent block. The block may still be skipped by the cluster.

Returns

result - An object with the following fields:

  • context - An object containing the following keys:
    • slot - The slot number of the block that was queried.
    • apiVersion - The API version used for the query.
  • value - An object with the following fields:
    • total - The total supply of lamports in the network.
    • circulating - The circulating supply of lamports in the network.
    • nonCirculating - The non-circulating supply of lamports in the network.
    • nonCirculatingAccounts - An array of account addresses that hold non-circulating lamports.

Request

curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "getSupply", "params": []}'

Response

{
"jsonrpc": "2.0",
"result": {
"context": {
"apiVersion": "2.2.3",
"slot": 373204187
},
"value": {
"circulating": 967687939079885400,
"nonCirculating": 315864946585692700,
"nonCirculatingAccounts": [
"Bzr4raUumaTNeqhMjvWYaF2Zm2gQwgFCDbVwcCNjNcT8",
"9NFMpkv65d2G7UMMFYHeXrBAaB6rVD3BgQ95bKiwr448",
...
"3RQvfXbzQQBT4PymcwrBPtSLVuEpK79NuPAt8k4PhrXe"
],
"total": 1283552885665578200
}
},
"id": 1
}