getTokenAccountBalance

On Solana — the Proof-of-History chain whose native token is SOL — getTokenAccountBalance reads the balance held in one specific SPL token (or Token-2022) account. Unlike getBalance, which reports lamports of SOL, this method targets the data account a program owns for a given token holder. Send a JSON-RPC 2.0 request with positional params to https://solana.therpc.io/YOUR_API_KEY and you get back the token balance of that single account: the raw amount, the mint's decimals, and a ready-to-display uiAmountString.

Use cases

• Read a single token account balance to populate a wallet view (for example, a Phantom-style holdings row) without scanning every account.
• Confirm a recipient's associated token account holds the expected amount after an SPL transfer settles at confirmed or finalized commitment.
• Render a human-readable figure straight from uiAmountString, which already applies the mint's decimals.

Parameters

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getTokenAccountBalance",
8  "params": [
9    "GfVPzUxMDvhFJ1Xs6C9i47XQRSapTd8LHw5grGuTquyQ",
10    {}
11  ]
12}'

Errors & troubleshooting

Common pitfalls

• Pass the token account address (the SPL/Token-2022 data account), not the owner wallet or the mint — those return an error or the wrong figure. To resolve a wallet's accounts first, use getTokenAccountsByOwner.
• Read uiAmountString rather than the uiAmount float; the float can lose precision on large balances, while the string preserves the exact value scaled by decimals.

Supported networks

• Mainnet
• Devnet

See also

• getTokenAccountsByOwner
• getTokenSupply
• getBalance