Skip to main content
GET
/
wallets
/
balances
Get balances for caller wallet
curl --request GET \
  --url https://api.afkcrypto.com/v1/wallets/balances \
  --header 'x-api-key: <api-key>'
{
  "balances": [
    {"chainType":"ethereum","chainId":8453,"address":"0xabc","asset":"native","token":null,"raw":"1000000000000000000","decimals":18,"symbol":"ETH","updatedAt":"2025-09-08T00:00:00.000Z"},
    {"chainType":"ethereum","chainId":8453,"address":"0xabc","asset":"erc20","token":"0xUSDC","raw":"1000000","decimals":6,"symbol":"USDC","updatedAt":"2025-09-08T00:00:00.000Z"}
  ]
}
Native balances cached ~15s; tokens ~45s. tokens limited to 50 per request. If address provided, must be owned wallet.
{
  "balances": [
    {"chainType":"ethereum","chainId":8453,"address":"0xabc","asset":"native","token":null,"raw":"1000000000000000000","decimals":18,"symbol":"ETH","updatedAt":"2025-09-08T00:00:00.000Z"},
    {"chainType":"ethereum","chainId":8453,"address":"0xabc","asset":"erc20","token":"0xUSDC","raw":"1000000","decimals":6,"symbol":"USDC","updatedAt":"2025-09-08T00:00:00.000Z"}
  ]
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
chain
string
required

Chain slug (e.g., base, base-sepolia, solana, solana-devnet)

​
address
string

Optional wallet address; defaults to caller's default wallet for the chain

​
tokens
string

CSV of token addresses (EVM) or mints (Solana) to include (max 50)

​
includeZero
boolean

Include zero balances (default false)

​
fresh
boolean

Bypass short-lived cache (default false)

Response

Balances response

​
balances
object[]
required