Skip to main content
GET
/
api
/
v1
/
customer
/
{chain}
/
token-balances
/
address
/
{address}
Get Token Balances
curl --request GET \
  --url https://api-gateway.sonarx.com/api/v1/customer/{chain}/token-balances/address/{address} \
  --header 'apikey: <api-key>'
{
  "offset": 0,
  "limit": 50,
  "result": [
    {
      "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "token_symbol": "USDC",
      "token_name": "USD Coin",
      "current_price": 1,
      "price_last_updated": "2025-12-16T16:29:51.223000",
      "balance": 17.545786,
      "datetime_last_updated": "2025-12-16T08:55:35",
      "block_number_last_updated": 24026500
    },
    {
      "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
      "token_symbol": "ETH",
      "token_name": "Ethereum",
      "current_price": 2951.94,
      "price_last_updated": "2025-12-16T16:29:31.464000",
      "balance": 0.002420673959646303,
      "datetime_last_updated": "2025-12-16T08:55:35",
      "block_number_last_updated": 24026500
    }
  ],
  "count": 2
}

Authorizations

​
apikey
string
header
required

API key for authentication

Path Parameters

​
chain
enum<string>
required

The blockchain network to query

Available options:
apechain,
arbitrum,
base,
berachain,
binance,
bittorrent,
blast,
celo,
cronos,
educhain,
ethereum,
fantom,
gnosis,
kaia,
mantle,
optimism,
polygon,
polygon_zkevm,
sonic,
story,
unichain
Example:

"ethereum"

​
address
string
required

The EVM wallet address (0x-prefixed, 42 characters)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xC288Cdb9785dbAd66a47A668A0B18E55466d3127"

Query Parameters

​
block_number
integer

Optional block number for point-in-time historical balance. If omitted, returns the latest known balance.

Required range: x >= 0
Example:

23525000

​
offset
integer
default:0

Number of results to skip for pagination (0-indexed)

Required range: x >= 0
​
limit
integer
default:50

Number of records per page (max 100)

Required range: 1 <= x <= 100

Response

Token balances for the wallet

​
offset
integer

Number of results skipped

​
limit
integer

Number of results per page

​
result
object[]
​
count
integer

Number of token balances returned