Get aggregated balances and allowances
Returns aggregated token balances and allowances for multiple wallets by spender
Supported on: Ethereum Base Solana BNB Chain Linea Sonic Unichain Arbitrum Avalanche ZKsync Gnosis Optimism Polygon
Parameters
chain
* number path wallets
* array queryList of wallet addresses
filterEmpty
boolean queryFilter out empty balances and allowances
spender
* string pathSpender address
Request Body
This request doesn’t have any request body.
JavaScript
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
const axios = require('axios');
async function httpCall() {
const url =
'https://api.1inch.com/balance/v1.2/{chain}/aggregatedBalancesAndAllowances/{spender}';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {},
paramsSerializer: {
indexes: null,
},
};
const body = {};
try {
const response = await axios.get(url, body, config);
console.log(response.data);
} catch (error) {
console.error(error);
}
}
Returns
200
items
AggregatedBalancesAndAllowancesResponse object Aggregated token balances and allowances across multiple wallets
decimals
* number Number of decimals for the token
symbol
* string Token symbol
tags
* array Token tags for categorization
items
string address
* string Token contract address
name
* string Token name
logoURI
* string Token logo URL
isCustom
* boolean Whether the token is a custom (user-provided) token
wallets
* object Map of wallet addresses to their balance and allowance info
additionalProperties
object balance
string allowance
string type
* string Token type
tracked
boolean Whether the token is being tracked
JSON
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[
{
"decimals": 18,
"symbol": "USDT",
"tags": ["stablecoin", "tokens"],
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"logoURI": "https://tokens.1inch.io/0xdac17f958d2ee523a2206206994597c13d831ec7.png",
"isCustom": false,
"wallets": null,
"type": "erc20",
"tracked": true
}
]