Skip to main content

0.05 credits per call

getSupply on Solana: Returns information about the current supply of SOL.

​
Endpoint

https://rpc.goldrushdata.com/v1/solana-mainnet
Authenticate with Authorization: Bearer <GOLDRUSH_API_KEY>. See authentication.

​
Parameters

NameTypeRequiredDescriptionExample
configobjectno{commitment?, excludeNonCirculatingAccountsList?}.{"excludeNonCirculatingAccountsList":true}

​
Returns

object: {context, value: {total, circulating, nonCirculating, nonCirculatingAccounts}}: values in lamports. 
{"context":{"slot":372877175},"value":{"total":600000000000000000,"circulating":520000000000000000,"nonCirculating":80000000000000000,"nonCirculatingAccounts":[]}}

​
Examples

curl https://rpc.goldrushdata.com/v1/solana-mainnet \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSupply",
    "params": [{"excludeNonCirculatingAccountsList":true}]
  }'

import {
  createDefaultRpcTransport,
  createSolanaRpcFromTransport,
} from "@solana/kit";

const transport = createDefaultRpcTransport({
  url: "https://rpc.goldrushdata.com/v1/solana-mainnet",
  headers: { Authorization: `Bearer ${process.env.GOLDRUSH_API_KEY}` },
});
const rpc = createSolanaRpcFromTransport(transport);

const result = await rpc.getSupply({"excludeNonCirculatingAccountsList":true}).send();
console.log(result);

import os
import requests

resp = requests.post(
    "https://rpc.goldrushdata.com/v1/solana-mainnet",
    headers={
        "Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "getSupply", "params": [{"excludeNonCirculatingAccountsList":true}]},
)
print(resp.json()["result"])

​
Errors

Standard JSON-RPC errors: -32600 invalid request, -32601 method not found, -32602 invalid params.