跳转到主要内容
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":"0xYourAddress","asset":"native","token":null,"raw":"1000000000000000000","decimals":18,"symbol":"ETH","updatedAt":"2025-09-08T00:00:00.000Z"},
    {"chainType":"ethereum","chainId":8453,"address":"0xYourAddress","asset":"erc20","token":"0xUSDC","raw":"1000000","decimals":6,"symbol":"USDC","updatedAt":"2025-09-08T00:00:00.000Z"}
  ]
}
原生余额缓存 ~15秒；代币 ~45秒。tokens 每次请求限制 50 个。如提供 address，必须是所属钱包。
{
  "balances": [
    {"chainType":"ethereum","chainId":8453,"address":"0xYourAddress","asset":"native","token":null,"raw":"1000000000000000000","decimals":18,"symbol":"ETH","updatedAt":"2025-09-08T00:00:00.000Z"},
    {"chainType":"ethereum","chainId":8453,"address":"0xYourAddress","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