​
getTokenLargestAccounts RPC Method

Returns the 20 largest accounts of a particular SPL Token type.

Parameters

string required
Pubkey of the token Mint to query

  • Base-58 encoded string

object optional
Configuration object containing the following fields:

commitment string optional
The level of commitment desired when querying state

Code Sample

curl https://rpc.testnet.soo.network/rpc \
-X POST \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTokenLargestAccounts",
  "params": [
    "BESTc6u4kKPDrdAXHTKPgCm9bwBzDn2Nq9g4gk1Ld3P4",
    {
      "commitment": "finalized"
    }
  ]
}'

Response

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 369624
    },
    "value": [
      {
        "address": "5ThJTCxpdn54bk3gBAWKZS4K9ogHEX56WooYbXQDnm3Q",
        "amount": "1000000",
        "decimals": 6,
        "uiAmount": 1.0,
        "uiAmountString": "1.0"
      }
    ]
  },
  "id": 1
}

​
Result Details

The result is an RpcResponse JSON object with value containing an array of largest token accounts:

  • address: <string>

    • The address of the token account
    • Base-58 encoded Pubkey

  • amount: <string>

    • Raw token account balance without decimals
    • String representation of u64 integer

  • decimals: <u8>

    • Number of decimal places for the token
    • Determines how the raw amount should be displayed

  • uiAmount: <number|null> DEPRECATED

    • Token account balance using mint-prescribed decimals
    • Will be removed in future versions

  • uiAmountString: <string>

    • Token account balance as a string
    • Formatted using mint-prescribed decimal places

​
Important Notes

  • Returns the top 20 largest token accounts for a specific token Mint
  • Provides both raw and user-friendly token balance representations
  • Decimals help in correct token amount interpretation
GetTokenAccountsByOwnerGetTokenSupply