Skip to main content

getSupply

Returns information about the current token supply.

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
}
On this page