getTokenAccountsByOwner RPC Method

Please note that, in addition to the plan-level rate limits, the getTokenAccountsByOwner method has a specific rate limit of 200 requests per second. This limit may change without notice to ensure system stability. For high-demand use cases, please reach out to discuss potential solutions.

Parameters

pubkey

string

REQUIRED

object

REQUIRED

mint

string

programId

string

object

commitment

string

encoding

string

dataSlice

string

minContextSlot

integer

Returns

result

context

apiVersion

slot

value

account

data

parsed

info

isNative

mint

owner

state

tokenAmount

amount

decimals

uiAmount

uiAmountString

type

program

space

executable

lamports

owner

rentEpoch

space

pubkey

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc": "2.0","id": 1,"method": "getTokenAccountsByOwner","params": ["GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa",{"mint": "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE"},{"encoding": "jsonParsed"}]}'

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": "getTokenAccountsByOwner",
  "params": [
    "GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa",
    {
      "mint": "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE"
    },
    {
      "encoding": "jsonParsed"
    }
  ]
})

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

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

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

  const ownerPublicKey = address("GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa");
  const mintAccount = address("1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE");

  try {
    const tokenAccounts = await solanaRpc.getTokenAccountsByOwner(
      ownerPublicKey,
      { mint: mintAccount },
      { encoding: "jsonParsed" }
    ).send();

    console.log(tokenAccounts);
  } catch (error) {
    console.error("Error fetching token accounts by owner:", error);
  }
})();

const web3 = require("@solana/web3.js");
(async () => {
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
  const accountPublicKey = new web3.PublicKey(
    "GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa"
  );
  const mintAccount = new web3.PublicKey(
    "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE"
  );
  console.log(
    await solana.getTokenAccountsByOwner(accountPublicKey, {
      mint: mintAccount,
    })
  );
})();

from solana.rpc.api import Client
from solana.publickey import PublicKey
from solana.rpc.types import TokenAccountOpts
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
pub_key = PublicKey("GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa")
mint_account = "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE"
print(solana_client.get_token_accounts_by_owner(pub_key,TokenAccountOpts(mint=mint_account)))

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": "getTokenAccountsByOwner",
        "params": [
            "GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa",
            {
                "mint": "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE"
            },
            {
                "encoding": "jsonParsed"
            }
        ]
    }
    "#;
    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": 335501753
    },
    "value": [
      {
        "account": {
          "data": {
            "parsed": {
              "info": {
                "isNative": false,
                "mint": "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE",
                "owner": "GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa",
                "state": "initialized",
                "tokenAmount": {
                  "amount": "5",
                  "decimals": 0,
                  "uiAmount": 5,
                  "uiAmountString": "5"
                }
              },
              "type": "account"
            },
            "program": "spl-token",
            "space": 165
          },
          "executable": false,
          "lamports": 2039280,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "rentEpoch": 18446744073709552000,
          "space": 165
        },
        "pubkey": "9duBrvbQPiNng7ggy58pVhV8RieLZnyD6TuKCMhcqzjp"
      }
    ]
  },
  "id": 1
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

getTokenAccountsByOwner RPC Method

Loading...

Parameters

Returns