getBalance RPC Method

Parameters

address

string

REQUIRED

The Pubkey of the account to query encoded as base-58 string

object

array

The configuration object with the following fields:

commitment

string

The level of commitment required for the query. The options include:

finalized

string

The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized

confirmed

string

The node will query the most recent block that has been voted on by the supermajority of the cluster

processed

string

The node will query its most recent block. Note that the block may not be complete

minContextSlot

integer

The minimum slot at which the request can be evaluated

Returns

result

Null if the account doesn't exist otherwise RpcResponse JSON object with the following fields:

context

An object that contains metadata about the current state of the Solana network at the time the request was processed

apiVersion

The version number

slot

The current slot in the Solana cluster during which the transactions are processed and new blocks are added to the blockchain

value

The balance of the account of provided Pubkey

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0", "id":1, "method":"getBalance", "params":["7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"]}'

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
  ]
})

response = https.request(request)
puts response.read_body

import {
    createSolanaRpc,
    address,
  } from "@solana/kit";
  
  (async () => {
    const searchAddress = address('7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy');
    const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
    const { value: lamports } = await solanaRpc.getBalance(searchAddress).send();
    console.log(lamports.toString());
  })();

const web3 = require("@solana/web3.js");
(async () => {
  const publicKey = new web3.PublicKey(
    "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
  );
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
  console.log(await solana.getBalance(publicKey));
})();

from solana.rpc.api import Client
from solana.publickey import PublicKey
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
print(solana_client.get_balance(PublicKey('7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy')))

use reqwest::header;
use reqwest::Client;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = Client::new();
    let json_data = r#"
    {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "getBalance",
        "params": [
            "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
        ]
    }"#;
    let response = client
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
        .headers(headers)
        .body(json_data)
        .send()
        .await?; 

    let body = response.text().await?;
    println!("{}", body);

    Ok(())
}

Response

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "apiVersion": "2.1.21",
      "slot": 335585259
    },
    "value": 709301491443
  },
  "id": 1
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free