I need to check the balance for multiple addresses (i.e. 100) a eth_getbalance seems to accept only one address.


As far as I know, retrieving balances for multiple addresses is not supported yet by the RPC standard.

However, what I've came up with so far is this: I pack all balance calls into promises and do Promise.all by chunks of 50 requests for instance. It waits for the first 50 balances, then queries next 50 and so on. Code:

async function getAllAddressBalances (addresses, batch = 50) {
    const map = new Map();
    let processed = 0;
    process.stdout.write(`Processed: ${ processed }/${ addresses.length }`);
    for (const batch of splitArray(addresses, batch)) {
        let retry = true,
            pss = processed;
        while (retry) {
            try {
                await Promise.all(batch.map(address => (async function () {
                    let balance = 0;
                    balance = await web3.eth.getBalance(address);
                    process.stdout.write(`\rProcessed: ${ ++processed }/${ addresses.length }`);
                    if (balance === 0)
                    map.set(address, balance);
            } catch (e) { // Sometimes rate limit may apply, this tries over and over again
                console.log(`Exceptions caught (possibly node rate limit), retrying in 5 seconds...`);
                retry = true;
                await delay(5);
                processed = pss;
            retry = false;
    return map;

function splitArray (array, len) {
    const arr = [];
    for (let i = 0; i < array.length; i += len) {
        arr.push(array.slice(i, Math.min(i + len, array.length)));
    return arr;

Alternatively, you can rely on third-party APIs like Etherscan, there are a plenty of those. As for Etherscan, they have an endpoint that enables you to get Ether Balance for multiple Addresses in a single call.


geth is using jsonrpc which is an open specification.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.