Skip to main content
GET
Get smart account token balances
Get the current token balances held by a Smart Account, including SOL and SPL tokens.

Key Concepts

  • Token Balances: View all token balances in both raw and decimal formats
  • Token Information: Includes mint addresses, token decimals, symbols, names, and logos
  • UI Formatting: Human-readable amounts and token metadata provided for easy display

Important Notes

  • SOL balance is represented by the native SOL mint address
  • Token amounts are provided in both raw and decimal formats
  • Zero balances may be omitted from the response
  • Some token metadata (symbol, name, logo_url) may be null if not available

Authorizations

Authorization
string
header
required

UUID-based API key provided by Squads

Headers

x-squads-network
enum<string>
required

Specifies the network for the API request

Available options:
mainnet,
devnet

Path Parameters

smart_account_address
string
required

The address of the smart account

Response

Token balances retrieved successfully

balances
object[]