getTokenAccountsByOwner RPC Method

Description

Returns all SPL Token accounts by token owner.

Parameters

1. pubkey (string) - The Pubkey of account delegate to query encoded as base-58 string
2. object (array) - The JSON object with the following fields: (Either 'mint' or 'programId' can be used at a time)
   • mint (string) - The Pubkey of the specific token Mint to limit accounts to, as base-58 encoded string
   • programId (string) - The Pubkey of the Token program ID that owns the accounts, as base-58 encoded string
3. object (array) - The JSON object with the following fields:
   • commitment (string, optional) - The level of commitment required for the query. The options include:
     • finalized - 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 - The node will query the most recent block that has been voted on by the supermajority of the cluster
     • processed - The node will query its most recent block. Note that the block may not be complete
   • encoding (string) - The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed
   • dataSlice (string, optional) - The returned account data using the provided offset: 'usize' and length: 'usize' fields; only available for base58, base64, or base64+zstd encodings
   • minContextSlot (integer, optional) - The minimum slot at which the request can be evaluated

Returns

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:
  • account - An address on the Solana blockchain that is used to store assets
    • data - A string containing the encoded data to be passed to the instruction
      • parsed - An array of parsed instructions that were executed in the block's transactions
        • info - An array of information objects that provide additional details about the transactions in the block
          • isNative - A boolean value indicating whether the token is a native token of the Solana blockchain
          • mint - Provides information about the creation of new tokens
          • owner - The base-58 encoded Pubkey of the program this account has been assigned to
          • state - The current state of the token account
          • tokenAmount - The balance of the token in the token account
            • 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
      • program - The program that manages the token
      • space - The amount of storage space required to store the token account
    • executable - A boolean indicating if the account contains a program (and is strictly read-only)
    • lamports - The number of lamports assigned to this account as u64 (64-bit unsigned integer)
    • owner - The base-58 encoded Pubkey of the program this account has been assigned to
    • rentEpoch - The epoch at which the token account's storage will be subject to rent
    • space - The amount of storage space required to store the token account
  • pubkey - The public key associated with the token account

Code Examples

curl "https://rpc-mainnet.solanatracker.io/?api_key=YOUR_API_KEY_HERE" \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc": "2.0","id": 1,"method": "getTokenAccountsByOwner","params": ["GgPpTKg78vmzgDtP1DNn72CHAYjRdKY7AV6zgszoHCSa",{"mint": "1YDQ35V8g68FGvcT85haHwAXv1U7XMzuc4mZeEXfrjE"},{"encoding": "jsonParsed"}]}'