Uncover the simplest approach to get ERC-20 token balances utilizing RPC nodes. Moralis’ Prolonged RPC Strategies enable you to seamlessly fetch any pockets’s token balances with a single RPC-style request. Curious to see the way it works? Take a look at the eth_getTokenBalances endpoint in motion:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getTokenBalances",
"params": [
{
"address": "0xcB1C1FdE09f811B294172696404e88E658659905",
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
With one name, you’ll obtain the ERC-20 steadiness of the desired pockets. Right here’s a pattern response:
{
//...
consequence: [
{
token_address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
name: 'Wrapped Ether',
symbol: 'WETH',
decimals: 18,
logo: '
thumbnail: '
balance: '10000000000000000',
possible_spam: false,
verified_contract: true,
total_supply: '2746607222348759943423350',
total_supply_formatted: '2746607.22234875994342335',
percentage_relative_to_total_supply: 3.64085549569e-7
},
//...
]
}
That’s all it takes – fetching ERC-20 token balances with RPC nodes has by no means been simpler. For a deeper dive, be part of us on this detailed tutorial or take a look at our official Prolonged RPC Strategies documentation.
Prepared to get began? Join with Moralis, and also you’ll have the opportunity to get ERC-20 token balances with RPC nodes in a heartbeat!
Overview
Whether or not you’re constructing a portfolio tracker, cryptocurrency pockets, tax platform, or different Web3 tasks, you’ll doubtless want entry to ERC-20 token balances. Historically, fetching these balances utilizing RPC nodes has been cumbersome, requiring a number of requests and guide placing collectively knowledge. However there’s a greater approach: Moralis’ Prolonged RPC Strategies.
With our Prolonged RPC Strategies, you’ll be able to simply question decoded, human-readable knowledge by means of RPC-style requests. Immediately entry ERC-20 token balances, decoded transactions, token costs, and extra with minimal effort.
Curious the way it works? On this tutorial, we’ll present you ways to use Moralis to get ERC-20 token balances through RPC nodes. Let’s dive in!
What are ERC-20 Token Balances?
Put merely, ERC-20 token balances refer to the variety of tokens held by a selected pockets or handle. Since varied forms of ERC-20 tokens exist, a pockets can maintain a number of token balances concurrently. For instance, a person may need 5 Wrapped BTC, 100 USDC, and 1,000,000 Shiba Inu tokens.
Why are ERC-20 token balances necessary for builders?
ERC-20 token balances are important for a lot of Web3 purposes. Listed below are three key examples:
- Wallets: Cryptocurrency wallets want to retrieve and show ERC-20 token balances so customers can see which tokens they personal and in what quantities.
- Portfolio Trackers: Portfolio trackers depend on ERC-20 token balances to precisely monitor customers’ property, observe value modifications, and replace customers on their total portfolio efficiency.
- Tax Platforms: To generate exact tax studies, tax platforms should entry the ERC-20 token balances of their customers.
These are only a few examples; ERC-20 token balances are mandatory for many Web3 dapps!
Introducing Prolonged RPC Strategies – The Best Approach to Get ERC-20 Token Balances with RPC Nodes
Moralis’ Prolonged RPC Strategies streamline the method of querying decoded, human-readable knowledge utilizing RPC nodes, making dapp growth extra accessible.
Key knowledge you’ll be able to entry:
eth_getTokenBalances: Retrieve ERC-20 token balances by pockets.eth_getTransactions: Fetch native transactions by pockets handle.eth_getDecodedTransactions: Entry detailed pockets transaction historical past by handle.eth_getTokenPrice: Get costs by token addresses.eth_getTokenMetadata: Get hold of ERC-20 metadata by token handle.eth_getNFTBalances: Retrieve NFTs by pockets handle.eth_getNFTCollections: Entry NFT collections by pockets.
In essence, our Prolonged RPC Strategies make it simple for you to question and combine decoded, human-readable crypto knowledge into your dapps!
Why Do You Want Prolonged RPC Strategies?
Querying on-chain knowledge utilizing typical RPC strategies will be cumbersome. These strategies aren’t optimized for widespread queries like, “What ERC-20 tokens does wallet X hold?” To get this info, you sometimes want to make a number of requests and manually compile the information, which is time-consuming and resource-intensive. Luckily, that’s the place Moralis’ Prolonged RPC Strategies are available in.
Our Prolonged RPC Strategies allow you to simply get ERC-20 token balances, pockets historical past, NFT balances, and extra by means of easy RPC-style requests, making fetching crypto knowledge through nodes extra environment friendly than ever.
Need to see the way it works? Take a look at the tutorial under to find out how to use our Prolonged RPC Strategies to get ERC-20 token balances!
3-Step Tutorial: How to Get ERC-20 Token Balances with RPC Nodes
We’ll now present you ways to seamlessly get ERC-20 token balances utilizing RPC nodes. Thanks to the accessibility of our Prolonged RPC Strategies, you’ll be able to acquire this knowledge in three easy steps:
- Join with Moralis & create a node.
- Write a script calling the
eth_getTokenBalancesendpoint. - Run the code.
Nonetheless, earlier than you’ll be able to start, you want to handle a couple of stipulations.
Stipulations
Earlier than beginning the tutorial, guarantee you may have the next prepared:
Step 1: Signal Up with Moralis & Create a Node
Click on the “Start for Free” button on the high proper to arrange your Moralis account:
From there, log in, go to the “Nodes” tab, and click on “+ Create Node”:
Subsequent, choose “Ethereum,” adopted by “Mainnet,” and click on the “Create Node” button:
This can present you with two node URLs. Copy and save one of many URLs, as you’ll want it within the subsequent part:
Step 2: Write a Script Calling the eth_getTokenBalances Endpoint
Begin by opening Visible Studio Code or your most popular IDE, then arrange a brand new folder and initialize a undertaking utilizing the terminal command supplied:
npm init
After that, set up the mandatory dependencies utilizing the given command:
npm set up node-fetch --save npm set up moralis @moralisweb3/common-evm-utils
In your “package.json” file, make certain to add "type": ”module”:
Subsequent, create a brand new “index.js” file and insert the supplied code:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getTokenBalances",
"params": [
{
"address": "0xcB1C1FdE09f811B294172696404e88E658659905",
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Exchange YOUR_NODE_URL with the node URL you copied earlier, and regulate the handle parameter as wanted to suit your question:
That’s it. From right here, you simply want to run the code.
Step 3: Run the Code
Open a brand new terminal and run the supplied command in your undertaking’s root folder:
node index.js
In return, you’ll get the ERC-20 token balances of the desired pockets utilizing your RPC node. Right here’s an instance of what it would appear to be:
{
//...
consequence: [
{
token_address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
name: 'Wrapped Ether',
symbol: 'WETH',
decimals: 18,
logo: '
thumbnail: '
balance: '10000000000000000',
possible_spam: false,
verified_contract: true,
total_supply: '2746607222348759943423350',
total_supply_formatted: '2746607.22234875994342335',
percentage_relative_to_total_supply: 3.64085549569e-7
},
//...
]
}
And that’s it! It’s that simple to get ERC-20 token balances from RPC nodes utilizing Moralis!
To be taught extra about how this works, please take a look at the eth_getTokenBalances documentation web page.
Additionally, need to see how you should utilize this knowledge in follow? Take a look at the Moralis YouTube video under, the place certainly one of our builders reveals you ways to construct a portfolio app utilizing simply the eth_getTokenBalances endpoint:
Past How to Get ERC-20 Token Balances with RPC Nodes – Exploring Different Prolonged RPC Strategies
Fetching ERC-20 token balances with nodes is only one side of our Prolonged RPC Strategies. Within the following sections, we’ll discover 5 different strategies and spotlight the responses you get from them:
eth_getDecodedTransactionseth_getTokenPriceeth_getTokenMetadataeth_getNFTBalanceseth_getNFTCollections
So, with out additional ado, let’s take a more in-depth take a look at eth_getDecodedTransactions!
eth_getDecodedTransactions
With eth_getDecodedTransactions, you’ll be able to seamlessly fetch the transaction historical past of a selected pockets handle, enriched with decoded knowledge. Furthermore, this technique encompasses native transfers, ERC-20 transactions, NFT transfers, and extra.
Right here’s an instance of how to name this premier technique:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getDecodedTransactions",
"params": [
{
"address": "0xda74Ac6b69Ff4f1B6796cdDf61fBDd4A5f68525f",
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
In return for calling the script above, you’ll obtain the complete transaction historical past of the pockets. Moreover, every transaction is enriched with a human-readable occasion abstract, class tag, logos, addresses, and extra. Right here’s an instance of what it would appear to be:
{
//...
"result": [
{
"block_hash": "0x660274d577cd20b0b82c1bff5f3c5641ba6027544e005f9256d5add9c7447920",
"block_number": "19868695",
"block_timestamp": "2024-05-14T14:00:23.000Z",
"from_address": "0xda74ac6b69ff4f1b6796cddf61fbdd4a5f68525f",
"from_address_label": null,
"from_address_entity": null,
"from_address_entity_logo": null,
"to_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"to_address_label": "Tether USD (USDT)",
"to_address_entity": null,
"to_address_entity_logo": null,
"gas": "55331",
"gas_price": "13623172301",
"hash": "0xc565260238f59fc3f35b74f3011375c7d637db9b075f77d342c30d19f946272e",
"nonce": "14",
"receipt_cumulative_gas_used": "13917979",
"receipt_gas_used": "41309",
"receipt_status": "1",
"transaction_fee": "0.000562759624582009",
"transaction_index": "75",
"value": "0",
"receipt_contract_address": null,
"nft_transfers": [],
"erc20_transfers": [
{
"token_name": "Tether USD",
"token_symbol": "USDT",
"token_logo": "
"token_decimals": "6",
"from_address": "0xda74ac6b69ff4f1b6796cddf61fbdd4a5f68525f",
"from_address_entity": null,
"from_address_entity_logo": null,
"from_address_label": null,
"to_address": "0x28c6c06298d514db089934071355e5743bf21d60",
"to_address_label": "Binance 14",
"to_address_entity": "Binance",
"to_address_entity_logo": "
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"log_index": 338,
"value": "50000000000",
"possible_spam": false,
"verified_contract": true,
"direction": "send",
"value_formatted": "50000"
}
],
"method_label": "transfer",
"native_transfers": [],
"summary": "Sent 50,000 USDT to Binance 14",
"possible_spam": false,
"category": "token send"
},
//...
}
]
}
eth_getTokenPrice
With eth_getTokenPrice, now you can seamlessly fetch token costs primarily based on contract addresses utilizing RPC-style strategies. You possibly can retrieve costs for stablecoins like USDT, meme cash like Shiba Inu, and the whole lot in between.
Right here’s an instance of what it appears like when calling the endpoint:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getTokenPrice",
"params": [
{
"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"include": "percent_change"
}
]
})
};
fetch(YOUR_NODE_URL, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
In return for operating the script above, you obtain each the USD and native value of the desired token. Moreover, the response is enriched with value modifications over time, a token emblem, token decimals, and extra. Right here’s an instance of what the response appears like:
{
//...
consequence: {
tokenName: 'Tether USD',
tokenSymbol: 'USDT',
tokenLogo: '
tokenDecimals: '6',
nativePrice: {
worth: '375760131462618',
decimals: 18,
title: 'Ether',
image: 'ETH',
handle: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
},
usdPrice: 1.0000402502911871,
usdPriceFormatted: '1.000040250291187229',
'24hrPercentChange': '-0.04543241491797881',
exchangeName: 'Uniswap v3',
exchangeAddress: '0x1F98431c8aD98523631AE4a59f267346ea31F984',
tokenAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7',
priceLastChangedAtBlock: '20534105',
possibleSpam: false,
verifiedContract: true,
pairAddress: '0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b',
pairTotalLiquidityUsd: '7148031.13'
}
}
eth_getTokenMetadata
With eth_getTokenMetadata, you’ll be able to seamlessly fetch the metadata of an ERC-20 token. Furthermore, this endpoint covers the whole lot from meme cash like Shiba Inu to stablecoins like USDC.
Right here’s an instance of the endpoint in motion:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getTokenMetadata",
"params": [
{
"addresses": [
"0xdac17f958d2ee523a2206206994597c13d831ec7"
]
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
In return for calling the endpoint above, you get the metadata of the desired token. This can embrace the token title, image, decimals, logos, whole provide, and rather more. Right here’s a pattern response:
{
//...
consequence: [
{
address: '0xdac17f958d2ee523a2206206994597c13d831ec7',
address_label: 'Tether USD (USDT)',
name: 'Tether USD',
symbol: 'USDT',
decimals: '6',
logo: '
logo_hash: 'ee7aa2cdf100649a3521a082116258e862e6971261a39b5cd4e4354fcccbc54d',
thumbnail: '
total_supply: '51986637760874451',
total_supply_formatted: '51986637760.874451',
fully_diluted_valuation: '51930247101.87',
block_number: '20519335',
validated: 1,
created_at: '2017-11-28T00:41:21.000Z',
possible_spam: false,
verified_contract: true,
categories: [
'Asset-backed Tokens',
'Exchange-Issued Asset Tokens',
'Platform-Based Utility Tokens',
'Stablecoins'
],
hyperlinks: {
twitter: '
web site: '
fb: '
reddit: '
}
}
]
}
eth_getNFTBalances
Utilizing eth_geNFTBalances, you’ll be able to effortlessly retrieve an inventory of NFTs owned by a selected pockets handle.
Right here’s an instance script exhibiting how to name this endpoint:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getNFTBalances",
"params": [
{
"address": "0x3F22FC93143790a1bd11C37C65a0a0f7e7875eA2",
"limit": 10,
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response.consequence, null, 2))
.catch(err => console.error(err));
In return, you’ll get an inventory of all NFTs owned by the desired handle. Furthermore, every object is enriched with token addresses, in depth metadata, spam indicators, assortment logos, and extra. Right here’s an instance of what it would appear to be:
{
//...
consequence: [
{
amount: '1',
token_id: '8545',
token_address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8',
contract_type: 'ERC721',
owner_of: '0x3f22fc93143790a1bd11c37c65a0a0f7e7875ea2',
last_metadata_sync: '2024-08-14T19:47:37.128Z',
last_token_uri_sync: '2024-08-14T19:47:32.019Z',
metadata: '{"attributes":[{"trait_type":"Background","value":"Red"},{"trait_type":"Skin","value":"Normal"},{"trait_type":"Body","value":"Shirt Red"},{"trait_type":"Face","value":"Beard"},{"trait_type":"Head","value":"Mohawk Green"}],"description":"A collection 8888 Cute Chubby Pudgy Penquins sliding around on the freezing ETH blockchain.","image":"ipfs://QmNf1UsmdGaMbpatQ6toXSkzDpizaGmC9zfunCyoz1enD5/penguin/8545.png","name":"Pudgy Penguin #8545"}',
block_number: '18777311',
block_number_minted: null,
title: 'PudgyPenguins',
image: 'PPG',
token_hash: '5e8faae3c07cd3bdb8bfa817e5a14a1b',
token_uri: '
minter_address: null,
verified_collection: true,
possible_spam: false,
collection_logo: '
collection_banner_image: '
},
//...
]
}
}
eth_getNFTCollections
Get an inventory of all of the NFT collections owned by a selected pockets, together with assortment particulars and metadata.
Right here’s the endpoint in motion:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getNFTCollections",
"params": [
{
"address": "0x3F22FC93143790a1bd11C37C65a0a0f7e7875eA2",
"limit": 10
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Calling the endpoint above offers an array of all collections owned by the desired pockets. Every object is enriched with knowledge, together with a reputation, assortment emblem, assortment banner, spam indicators, and extra. Right here’s an instance of what it would appear to be:
{
//...
consequence: [
{
token_address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8',
possible_spam: false,
contract_type: 'ERC721',
name: 'PudgyPenguins',
symbol: 'PPG',
verified_collection: true,
collection_logo: '
collection_banner_image: '
},
//...
]
}
}
Moralis Overview – Exploring RPC Nodes & Web3 APIs
Moralis stands out because the trade’s #1 crypto knowledge supplier. Our suite of growth instruments contains top-tier RPC nodes and a number of other use case-specific APIs, such because the Pockets API, Token API, Streams API, and extra. With Moralis, you get all crypto knowledge in a single place.
What makes Moralis distinctive?
- One Name – All of the Information: Our APIs and Prolonged RPC Strategies are designed with the end result in thoughts, providing you with extra knowledge with fewer calls. Fetch ERC-20 token balances, a pockets’s full historical past, token costs, and extra with single requests.
- Multi-Chain Help: Our nodes and Web3 APIs help all main chains, together with Ethereum, Polygon, BSC, Optimism, Base, and others. Get pleasure from full function parity throughout our supported networks, so that you solely want one knowledge supplier for all chains.
- Enterprise-grade Safety: Moralis is SOC 2 Sort 2 licensed, demonstrating our dedication to safety and reliability.
Let’s dive deeper into our merchandise to spotlight the advantages of Moralis!
RPC Nodes
Moralis is a number one node supplier, supporting over 30 blockchains, together with Ethereum, Base, and Polygon. With our user-friendly interface, you’ll be able to effortlessly combine nodes into your tasks on the click on of some buttons.
What units our nodes aside?
- Pace: Business-leading response instances as little as 70 ms.
- Reliability: 99.9% uptime, guaranteeing fixed knowledge availability.
- Safety: SOC 2 Sort 2 licensed for enterprise-grade safety.
Uncover extra on our RPC nodes web page!
Web3 APIs
Moralis’ Web3 API suite consists of a number of distinguished interfaces. Listed below are 5 of them:
- Pockets API: A number one instrument for constructing wallets and integrating pockets performance into dapps. Retrieve any pockets’s historical past, token balances, web value, profitability, and extra with single traces of code.
- Token API: Entry ERC-20 knowledge with the Token API. Get balances, costs, metadata, and extra.
- NFT API: Best for constructing NFT marketplaces, Web3 video games, and different NFT-related platforms. Fetch NFT balances, metadata, costs, and extra with minimal code.
- Worth API: Get real-time ERC-20 costs, NFT flooring costs, OHLCV costs, and extra. Combine value knowledge seamlessly into your tasks.
- Streams API: Arrange Web3 knowledge pipelines for customized occasions with only a few clicks. Excellent for real-time alerts, populating databases with present occasions, and incorporating dwell insights into your tasks.
To be taught extra about our interfaces, go to our Web3 API web page!
Abstract: How to Get ERC-20 Token Balances with RPC Nodes
It doesn’t matter when you’re constructing a Web3 pockets, portfolio tracker, tax instrument, or different related platforms – chances are high, you want entry to the ERC-20 token balances of your customers. Nonetheless, querying ERC-20 token balances from RPC nodes has historically been a bothersome and time-consuming endeavor. Doing so requires many requests utilizing strategies like eth_getBalance and necessitates stitching collectively a whole lot of knowledge your self. Luckily, there’s now a extra streamlined various: Moralis’ Prolonged RPC Strategies.
Our Prolonged RPC Strategies make it potential to question decoded and enriched knowledge seamlessly utilizing RPC-style requests. With this function, you solely want a single name to get ERC-20 token balances, transaction histories, token costs, and extra utilizing RPC nodes.
To focus on the accessibility of our Prolonged RPC Strategies, right here’s the eth_getTokenBalances endpoint in motion:
import fetch from 'node-fetch';
const choices = {
technique: 'POST',
headers: {
settle for: 'utility/json',
'content-type': 'utility/json'
},
physique: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "eth_getTokenBalances",
"params": [
{
"address": "0xcB1C1FdE09f811B294172696404e88E658659905",
}
]
})
};
fetch('YOUR_NODE_URL', choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
In return for calling the script above, you’ll get the ERC-20 token balances of the desired handle, enriched with token logos, spam indicators, and rather more. Right here’s a pattern response:
{
//...
consequence: [
{
token_address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
name: 'Wrapped Ether',
symbol: 'WETH',
decimals: 18,
logo: '
thumbnail: '
balance: '10000000000000000',
possible_spam: false,
verified_contract: true,
total_supply: '2746607222348759943423350',
total_supply_formatted: '2746607.22234875994342335',
percentage_relative_to_total_supply: 3.64085549569e-7
},
//...
]
}
That’s it! Fetching ERC-20 token balances with RPC nodes doesn’t have to be tougher than this when utilizing Moralis.
In the event you appreciated this tutorial on how to get ERC-20 token balances with RPC nodes, think about trying out extra Moralis content material. As an illustration, find out how to get DeFi protocol knowledge or dive into our Alchemy Customized Webhooks information.
Lastly, if you need to get ERC-20 token balances with RPC nodes your self, don’t neglect to enroll with Moralis. You possibly can create an account freed from cost and get fast entry to all our premier growth instruments!
