Parameters

pubkey

string

The Pubkey of token Mint to query encoded as base-58 string

object

object

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

Returns

result

An object with the following fields:

context

The information about the current state of the program

apiVersion

The version of the Solana RPC API to use

slot

An integer representing the slot for which to retrieve the fee calculator

value

A JSON object with the following fields:

amount

The raw total token supply without decimals, a string representation of a u64 integer

decimals

An integer value representing the number of decimal places used by the token

uiAmount

The total token supply using mint-prescribed decimals (DEPRECATED)

uiAmountString

The total token supply as a string using mint-prescribed decimals

Request

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

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

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getTokenAccountBalance",
16
  "params": [
17
    "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
18
  ]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getTokenAccountBalance",
16
  "params": [
17
    "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
18
  ]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

1
import { createSolanaRpc, address } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  const publicKey = address("DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN");
7
  try {
8
    const tokenAccountBalance = await solanaRpc.getTokenAccountBalance(publicKey).send();
9

10
    console.log(tokenAccountBalance);
11
  } catch (error) {
12
    console.error("Error fetching token account balance:", error);
13
  }
14
})();
15

1
import { createSolanaRpc, address } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  const publicKey = address("DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN");
7
  try {
8
    const tokenAccountBalance = await solanaRpc.getTokenAccountBalance(publicKey).send();
9

10
    console.log(tokenAccountBalance);
11
  } catch (error) {
12
    console.error("Error fetching token account balance:", error);
13
  }
14
})();
15

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
4
  console.log(
5
    await solana.getTokenAccountBalance(
6
      new web3.PublicKey("DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN")
7
    )
8
  );
9
})();
10

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
4
  console.log(
5
    await solana.getTokenAccountBalance(
6
      new web3.PublicKey("DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN")
7
    )
8
  );
9
})();
10

1
import base58
2
from solana.rpc.api import Client
3
from solders.pubkey import Pubkey
4
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
5

6
encoded_pubkey = "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
7
decoded_pubkey = base58.b58decode(encoded_pubkey)
8

9
print(len(decoded_pubkey)) #32 bytes
10

11
address = Pubkey(decoded_pubkey)
12

13
print(solana_client.get_token_account_balance(address))

1
import base58
2
from solana.rpc.api import Client
3
from solders.pubkey import Pubkey
4
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
5

6
encoded_pubkey = "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
7
decoded_pubkey = base58.b58decode(encoded_pubkey)
8

9
print(len(decoded_pubkey)) #32 bytes
10

11
address = Pubkey(decoded_pubkey)
12

13
print(solana_client.get_token_account_balance(address))

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

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

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getTokenAccountBalance",
16
        "params": [
17
            "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
18
        ]
19
    }
20
    "#;
21
    let response = client
22
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
23
        .headers(headers)
24
        .body(json_data)
25
        .send()
26
        .await?; 
27

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

31
    Ok(())
32
}

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

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

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getTokenAccountBalance",
16
        "params": [
17
            "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
18
        ]
19
    }
20
    "#;
21
    let response = client
22
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
23
        .headers(headers)
24
        .body(json_data)
25
        .send()
26
        .await?; 
27

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

31
    Ok(())
32
}

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getTokenAccountBalance',
7
  [
8
  "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
9
],
10
  undefined,
11
  'https://docs-demo.solana-mainnet.quiknode.pro/'
12
)
13

14
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getTokenAccountBalance',
7
  [
8
  "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
9
],
10
  undefined,
11
  'https://docs-demo.solana-mainnet.quiknode.pro/'
12
)
13

14
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getTokenAccountBalance",
8
        [
9
            "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
10
        ],
11
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
12
    )
13
    print(result)
14

15
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getTokenAccountBalance",
8
        [
9
            "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
10
        ],
11
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
12
    )
13
    print(result)
14

15
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getTokenAccountBalance",
7
  params: [
8
    "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
9
  ],
10
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
11
)
12

13
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getTokenAccountBalance",
7
  params: [
8
    "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
9
  ],
10
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
11
)
12

13
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getTokenAccountBalance",
10
            Some(serde_json::json!([
11
    "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
12
])),
13
            None,
14
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getTokenAccountBalance",
10
            Some(serde_json::json!([
11
    "DhzDoryP2a4rMK2bcWwJxrE2uW6ir81ES8ZwJJPPpxDN"
12
])),
13
            None,
14
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "context": {
5
      "apiVersion": "2.1.21",
6
      "slot": 335501823
7
    },
8
    "value": {
9
      "amount": "12",
10
      "decimals": 0,
11
      "uiAmount": 12,
12
      "uiAmountString": "12"
13
    }
14
  },
15
  "id": 1
16
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "context": {
5
      "apiVersion": "2.1.21",
6
      "slot": 335501823
7
    },
8
    "value": {
9
      "amount": "12",
10
      "decimals": 0,
11
      "uiAmount": 12,
12
      "uiAmountString": "12"
13
    }
14
  },
15
  "id": 1
16
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free