getSupply RPC Method

Returns information about the current supply.

params

object optional Configuration object containing the following fields:

commitment

The commitment describes how finalized a block is at that point in time. See Configuring State Commitment.

excludeNonCirculatingAccountsList

Exclude non circulating accounts list from response

result

object The result will be a JSON object containing:

total

Total supply in lamports

circulating

Circulating supply in lamports

nonCirculating

Non-circulating supply in lamports

nonCirculatingAccounts

An array of account addresses of non-circulating accounts, as strings. If excludeNonCirculatingAccountsList is enabled, the returned array will be empty.

cURL

curl https://us-seattle.openverse.network/api -s -X \
 POST -H "Content-Type: application/json" -d ' 
 {
   "jsonrpc": "2.0",
   "id": 1,
   "method": "getSupply"
 }
'

Response

{
 "jsonrpc": "2.0",
 "result": {
   "context": { "slot": 1114 },
   "value": {
     "total": 1016000,
     "circulating": 16000,
     "nonCirculating": 1000000,
     "nonCirculatingAccounts": [
       "FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5",
       "9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA",
       "3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9",
       "BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z"
     ]
   }
 },
 "id": 1
}