Obtiene los balances de tokens en todas las chains soportadas.
Endpoint
GET https://api.pan.dev/v1/balances/:walletId
Autenticacion
API Key o X402
Parametros de URL
| Parametro | Tipo | Descripcion |
|---|
walletId | string | ID de la wallet (pan_wallet_...) |
Response
200 OK
{
"walletId": "pan_wallet_a1b2c3d4e5f6",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"chains": [
{
"chain": "arbitrum-sepolia",
"tokens": [
{
"asset": "USDC",
"balance": "500000000",
"balanceFormatted": "500.00",
"decimals": 6,
"valueUsd": 500.00
}
]
},
{
"chain": "base-sepolia",
"tokens": [
{
"asset": "USDC",
"balance": "200000000",
"balanceFormatted": "200.00",
"decimals": 6,
"valueUsd": 200.00
}
]
}
],
"totalValueUsd": 700.00
}
Cambio de estructura: La respuesta usa un array chains en lugar de un objeto balances. Cada chain contiene su propio array de tokens.
Campos de Respuesta
| Campo | Tipo | Descripcion |
|---|
walletId | string | ID de la wallet |
address | string | Direccion de la wallet |
chains | array | Lista de chains con balances |
totalValueUsd | number | Valor total en USD |
Campos de Token
| Campo | Tipo | Descripcion |
|---|
asset | string | Simbolo del token (USDC, WETH, etc.) |
balance | string | Balance en unidades minimas |
balanceFormatted | string | Balance con decimales |
decimals | number | Decimales del token |
valueUsd | number | Valor en USD (opcional) |
Errores
| Codigo | Error | Descripcion |
|---|
| 401 | UNAUTHORIZED | API key invalida |
| 404 | WALLET_NOT_FOUND | Wallet no existe |
Ejemplos
curl -X GET "https://api.pan.dev/v1/balances/pan_wallet_a1b2c3d4e5f6" \
-H "Authorization: Bearer $PAN_API_KEY"
Notas
- Los balances se consultan en tiempo real de cada blockchain
- El campo
totalValueUsd suma todos los tokens
- Las chains sin tokens retornan array vacio de
tokens: []
- Los precios USD se actualizan cada minuto
