v1

latestOpenAPI 3.0.12026-07-2699111970.1 KB

Get Wallet Balance

Get the balance of a wallet for a given chain and currency

API scope required: wallets:balance.read

get/2025-06-09/wallets/{walletLocator}/balances

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

<walletAddress>
email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
chainType[:<walletType>]:alias:<alias>

Query parameters

chainsstring

The blockchain(s) to query. Comma-separated list of chains

tokensstring required

The tokens to query. Comma-separated list of either tokens or token locator strings

Headers

X-API-KEYstring required

API key required for authentication

Response

Returns the balance of the wallet for the given chain and currency

symbolstring

namestring

The name of the token

decimalsnumber required

The number of decimals of the token

amountstring required

The amount of the token after placing the decimal point

rawAmountstring required

The raw amount of the token

chainsobject required

Balance information per chain

Example response

[
  {
    "name": "USDC Token",
    "decimals": 18,
    "amount": "18.8343253454",
    "rawAmount": "18834161225104097789",
    "chains": {
      "base": {
        "contractAddress": "0x123",
        "locator": "base:0x123",
        "amount": "18.833423432423",
        "rawAmount": "18834161225104097789"
      },
      "solana": {
        "mintHash": "123123",
        "locator": "solana:132",
        "amount": "0",
        "rawAmount": "00000000000000000"
      }
    }
  }
]