getSupply Solana RPC Method

POST

getSupply

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getSupply",
  "params": []
}
'

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

Authorizations

api-key

string

query

required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json

jsonrpc

enum<string>

default:2.0

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

default:1

A unique identifier for the request.

Example:

"1"

method

enum<string>

default:getSupply

The name of the RPC method to invoke.

Available options:

getSupply

Example:

"getSupply"

params

object[]

Optional configuration object.

Show child attributes

params.commitment

enum<string>

The commitment level for the request.

Available options:

confirmed,

finalized,

processed

Example:

"finalized"

params.excludeNonCirculatingAccountsList

boolean

Option to exclude the detailed list of non-circulating SOL reserve accounts for faster response.

Example:

true

Response

Successfully retrieved the supply information.

jsonrpc

enum<string>

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

Identifier matching the request.

Example:

"1"

result

object

Context and supply details.

Show child attributes

result.context

object

Context of the response.

Show child attributes

result.context.slot

integer

Slot in which the data was fetched.

Example:

1114

result.value

object

Supply details.

Show child attributes

result.value.total

integer

Total SOL supply in existence (in lamports), including both circulating and locked tokens.

Example:

1016000

result.value.circulating

integer

Amount of SOL (in lamports) currently in circulation and available for public use.

Example:

16000

result.value.nonCirculating

integer

Amount of SOL (in lamports) held in reserve accounts and not currently available in circulation.

Example:

1000000

result.value.nonCirculatingAccounts

string[]

List of Solana wallet addresses that hold non-circulating SOL tokens in reserve.

Example:

[
  "FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5",
  "9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA",
  "3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9",
  "BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z"
]

getTokenAccountBalanceReturns the token balance of an SPL Token account.

⌘I

getSupply

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getSupply",
  "params": []
}
'

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

API Reference

Solana RPC APIs

Solana APIs

Data Streaming APIs

Event Listening APIs

Deprecated APIs

getSupply

Authorizations

Body

Response