getTokenAccountBalance

getTokenAccountBalance returns the balance held by one SPL Token account: the raw integer amount, the token's decimals, and the human-readable uiAmount / uiAmountString already scaled by those decimals.

The pubkey you pass must be the address of a token account — not the wallet that owns it, and not the token mint. A token account is the per-mint holding account derived for an owner (commonly the associated token account). Passing a wallet or a mint address yields an invalid-params error rather than a balance. To go from a wallet to its token accounts, resolve them first with getTokenAccountsByOwner, then call this method on the resulting account addresses.

The balance is reported relative to a particular slot, returned in the context object. Use the optional commitment config to control how finalized that slot must be, and minContextSlot to require the node has reached at least a given slot before serving the request.

JSON-RPC params is a positional array: [pubkey, config?].

The example above reads a token account holding 9864 base units of a 2-decimal token, i.e. 98.64 tokens.

Errors are returned in the standard JSON-RPC error envelope. See the shared errors reference for the full envelope shape and shared codes.

JavaScript (fetch)

const res = await fetch("https://api.triport.io/v1/sol", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "getTokenAccountBalance",
    params: ["7fUAJdStEuGbc3sM84cKRL6yYaaSstyLSU4ve5oovLS7"],
  }),
});


const { result } = await res.json();
console.log(`Balance: ${result.value.uiAmountString} (slot ${result.context.slot})`);

TypeScript SDK (@triport/sdk)

import { TriportClient } from "@triport/sdk";


const client = new TriportClient({ apiKey: process.env.TRIPORT_API_KEY });


const { context, value } = await client.solana.getTokenAccountBalance(
  "7fUAJdStEuGbc3sM84cKRL6yYaaSstyLSU4ve5oovLS7",
  { commitment: "finalized" }
);


console.log(`Balance: ${value.uiAmountString} (slot ${context.slot})`);

Python (triport-sdk)

import os
from triport import TriportClient


client = TriportClient(api_key=os.environ["TRIPORT_API_KEY"])


result = client.solana.get_token_account_balance(
    "7fUAJdStEuGbc3sM84cKRL6yYaaSstyLSU4ve5oovLS7",
    commitment="finalized",
)


value = result["value"]
print(f"Balance: {value['uiAmountString']} (slot {result['context']['slot']})")

• Token account, not wallet or mint: the most common mistake is passing a wallet address. Resolve a wallet's holdings with getTokenAccountsByOwner first, then query each returned account here.
• Use amount for math, uiAmountString for display: amount is the exact u64 base-unit count (string to avoid precision loss); uiAmountString applies decimals safely. Avoid the floating-point uiAmount for accounting.
• Closed or non-existent accounts: querying an address that is not a live token account returns an invalid-params error rather than a zero balance.
• Commitment defaults: when commitment is omitted, the node's default commitment applies. Pass finalized for the strongest consistency guarantee.
• Related methods: getTokenAccountsByOwner and getTokenAccountsByDelegate enumerate token accounts; getAccountInfo returns the full parsed account data.