Check Token Balances

Learn how to check SOL and SPL token balances for any wallet

Check SOL or SPL token balances for any wallet address. The toolkit provides two main methods:

• getBalance: Check balances for your own wallet

• getBalanceOther: Check balances for other wallets

Copy

// Check your SOL balance
const solBalance = await agent.methods.getBalance();

// Check your SPL token balance
const tokenBalance = await agent.methods.getBalance(
  new PublicKey("token-mint-address")
);

// Check another wallet's SOL balance
const otherSolBalance = await agent.methods.getBalanceOther(
  new PublicKey("wallet-address")
);

// Check another wallet's token balance
const otherTokenBalance = await agent.methods.getBalanceOther(
  new PublicKey("wallet-address"),
  new PublicKey("token-mint-address")
);

Parameter	Type	Required	Description
tokenAddress	PublicKey	No	Token mint address (omit for SOL)

Parameter	Type	Required	Description
walletAddress	PublicKey	Yes	Wallet to check balance for
tokenAddress	PublicKey	No	Token mint address (omit for SOL)

Copy

"What's my SOL balance?"

"Check my USDC balance"

"Show the balance of wallet GDEkQF7UMr7RLv1KQKMtm8E2w3iafxJLtyXu3HVQZnME"

"Get BONK token balance for wallet 8x2dR8Mpzuz2YqyZyZjUbYWKSWesBo5jMx2Q9Y86udVk"

For checking your own balance:

Copy

// Check SOL balance
{}

// Check USDC balance
{
  "tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
}

For checking other wallets:

Copy

// Check other wallet's SOL balance
{
  "walletAddress": "GDEkQF7UMr7RLv1KQKMtm8E2w3iafxJLtyXu3HVQZnME"
}

// Check other wallet's token balance
{
  "walletAddress": "GDEkQF7UMr7RLv1KQKMtm8E2w3iafxJLtyXu3HVQZnME",
  "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}

Copy

import { PingAgentKit } from "ping-agent-kit";
import { PublicKey } from "@ping/web3.js";

async function checkBalances(agent: PingAgentKit) {
  // Check own balances
  const mySolBalance = await agent.methods.getBalance();
  console.log("My SOL balance:", mySolBalance);

  const myUsdcBalance = await agent.methods.getBalance(
    new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
  );
  console.log("My USDC balance:", myUsdcBalance);

  // Check other wallet's balances
  const otherWallet = new PublicKey("GDEkQF7UMr7RLv1KQKMtm8E2w3iafxJLtyXu3HVQZnME");
  
  const otherSolBalance = await agent.methods.getBalanceOther(otherWallet);
  console.log("Other wallet SOL balance:", otherSolBalance);

  const otherUsdcBalance = await agent.methods.getBalanceOther(
    otherWallet,
    new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
  );
  console.log("Other wallet USDC balance:", otherUsdcBalance);
}

• Returns balances in UI units (e.g., SOL instead of lamports)

• Handles non-existent token accounts gracefully

• Supports all SPL tokens

• Returns 0 for non-existent accounts

Copy

try {
  const balance = await agent.methods.getBalance(tokenMint);
} catch (error) {
  if (error.message.includes("invalid account")) {
    // Handle invalid addresses
  } else if (error.message.includes("not found")) {
    // Handle non-existent accounts
  }
}

1. Error Handling

   • Handle non-existent accounts gracefully

   • Validate addresses before querying

   • Consider caching for frequent checks

2. Performance

   • Batch balance checks when possible

   • Consider using getMultipleAccounts

   • Cache results for short periods

3. UI Display

   • Format numbers appropriately

   • Show proper decimal places

   • Include token symbols

• USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

• USDT: Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB

• BONK: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

• RAY: 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R

• SRM: `SRMuApVNdxXokk5GT7XD5cUUgXMBCoAz2LHeuAoKWR