API ReferenceWallets
Get Balances
Get token balances across all supported chains for a wallet.
Get Balances
Fetches live token balances from all supported blockchains for the specified wallet.
Authentication
Requires X-API-Key header.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Wallet UUID |
Request
curl http://localhost:4000/v1/wallets/WALLET_ID/balances \
-H "X-API-Key: ak_your_key"Response (200)
{
"wallet_id": "wallet-uuid",
"balances": [
{
"chain": "ethereum",
"token": "ETH",
"balance": "0.05",
"usd_value": "150.00"
},
{
"chain": "base",
"token": "USDC",
"balance": "100.00",
"usd_value": "100.00"
},
{
"chain": "solana",
"token": "SOL",
"balance": "1.50",
"usd_value": "225.00"
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
wallet_id | string | Wallet UUID |
balances | array | Per-chain balance entries |
balances[].chain | string | Chain name |
balances[].token | string | Token symbol |
balances[].balance | string | Balance as decimal string |
balances[].usd_value | string | USD equivalent (when available) |
Errors
| Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND | Wallet not found |
| 502 | BALANCE_FETCH_ERROR | Failed to fetch balances from blockchain |