https://github.com/chainstacklabs/ethereum-token-balances-javascript
Code samples to retrieve multiple Ethereum token balances from addresses using GraphQL, ethers.js, and web3.js libraries
https://github.com/chainstacklabs/ethereum-token-balances-javascript
balance erc20 ethereum retrieve-data token
Last synced: 10 months ago
JSON representation
Code samples to retrieve multiple Ethereum token balances from addresses using GraphQL, ethers.js, and web3.js libraries
- Host: GitHub
- URL: https://github.com/chainstacklabs/ethereum-token-balances-javascript
- Owner: chainstacklabs
- License: mit
- Created: 2021-01-11T06:22:37.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-11T20:56:50.000Z (almost 3 years ago)
- Last Synced: 2025-03-27T06:11:59.721Z (11 months ago)
- Topics: balance, erc20, ethereum, retrieve-data, token
- Language: JavaScript
- Homepage: https://chainstack.com/the-ultimate-guide-to-getting-multiple-token-balances-on-ethereum/
- Size: 60.5 KB
- Stars: 22
- Watchers: 12
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Chainstack is the leading suite of services connecting developers with Web3 infrastructure
• Homepage •
Supported protocols •
Chainstack blog •
Chainstack docs •
Blockchain API reference •
• Start for free •
# Retrieve multiple token balances on Ethereum
This repository contains code examples on how you can retrieve Ethereum tokens in bulk using:
- GraphQL
- Etherplex
- web3.js BatchRequest
## Quick start
Clone the repository:
```sh
git clone https://github.com/chainstack/ethereum-token-balances.git
```
Install dependencies:
```sh
npm ci
```
> Use `npm ci` to launch a `clean install` of the dependencies, this will install the same version as in the `package.json` file.
Replace the following values in the `constant.js` file to suit your use case:
- `username` — your Ethereum node RPC username.
- `password` — your Ethereum node RPC password.
- `rpcEndpoint` — your Ethereum node RPC endpoint.
- `bathEndpoint` — your Ethereum node RPC endpoint with authentication credentials.
- `walletAddress` — the account address you want to query.
- `ABI (Application Binary Interface)` - contract ABI with only the `balanceOf` function, remember to add the function calls you're planning to execute to the ABI constant.
Then:
## GraphQL
GraphQL is a runtime natively supported by [Go Ethereum client](https://geth.ethereum.org). See also [GraphQL on Ethereum](https://chainstack.com/graphql-on-ethereum-availability-on-chainstack-and-a-quick-rundown/).
Run:
```bash
node graph
```
Sample results:
```json
{
"GameCredits":"1600000000000000000000 GAME",
"Swarm Fund":"0 SWM",
"Augur":"250684955559177177971383 REP",
"Tether":"52057527540802 USDT",
"DigixDAO":"122062000003 DGD",
"SingularDTV":"1809462 SNGLS",
"Veros":"0 VRS",
"Golem":"83169802320824576633066602 GLM",
"Circuits of Value":"0 COVAL",
"chrono tech":"0 TIME",
"Melon":"0 MLN",
"WeTrust":"0 TRST",
"iExec RLC":"1633118384742405 RLC",
...
}
```
## Etherplex
[Etherplex](https://github.com/pooltogether/etherplex) is a JavaScript library that makes use of the [multicall](https://github.com/makerdao/multicall) smart contract to aggregate function calls and execute them in batches.
Run:
```bash
node etherplex
```
Sample results:
```json
{
"GameCredits":"1600000000000000000000 GAME",
"Swarm Fund":"0 SWM",
"Augur":"250684955559177177971383 REP",
"Tether":"52057527540802 USDT",
"DigixDAO":"122062000003 DGD",
"SingularDTV":"1809462 SNGLS",
"Veros":"0 VRS",
"Golem":"83169802320824576633066602 GLM",
"Circuits of Value":"0 COVAL",
"chrono tech":"0 TIME",
"Melon":"0 MLN",
"WeTrust":"0 TRST",
"iExec RLC":"1633118384742405 RLC",
...
}
```
## web3.js BatchRequest
[web3.js](https://github.com/ethereum/web3.js/) is a JavaScript library that makes use of the [generic JSON-RPC methods](https://eth.wiki/json-rpc/API).
The web3.js `BatchRequest` method aggregates the list of contract function calls and converts them into an array of JSON-RPC calls before sending it to the Ethereum node in one XMLHttpRequest.
Run:
```bash
node batch
```
Sample results:
```json
{
"GameCredits":"1600000000000000000000 GAME",
"Swarm Fund":"0 SWM",
"Augur":"250684955559177177971383 REP",
"Tether":"52057527540802 USDT",
"DigixDAO":"122062000003 DGD",
"SingularDTV":"1809462 SNGLS",
"Veros":"0 VRS",
"Golem":"83169802320824576633066602 GLM",
"Circuits of Value":"0 COVAL",
"chrono tech":"0 TIME",
"Melon":"0 MLN",
"WeTrust":"0 TRST",
"iExec RLC":"1633118384742405 RLC",
...
}
```
## Prerequisites
* Node.js: ^16.17.0— [install Node](https://nodejs.org/en/download/)
* A node RPC endpoint.
Deploy a node with Chainstack:
1. [Sign up with Chainstack](https://console.chainstack.com/user/account/create).
1. [Deploy a node](https://docs.chainstack.com/platform/join-a-public-network).
1. [View node access and credentials](https://docs.chainstack.com/platform/view-node-access-and-credentials).