GET
/
api
/
v1
/
smart-accounts
/
{smart_account_address}
/
balances
Get smart account token balances
curl --request GET \
  --url https://developer-api.squads.so/api/v1/smart-accounts/{smart_account_address}/balances \
  --header 'Authorization: Bearer <token>' \
  --header 'x-squads-network: <x-squads-network>'
{
  "balances": [
    {
      "token_address": "<string>",
      "amount": "<string>",
      "amount_decimal": "<string>",
      "decimals": 123,
      "symbol": "<string>",
      "name": "<string>",
      "logo_url": "<string>"
    }
  ]
}
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

200
application/json

Token balances retrieved successfully

The response is of type object.