Skip to main content
Version: 2.2

Get ERC20 token balance by wallet

Don't have an API key yet?

Start using this API for your project today.

Get your free API key
GEThttps://deep-index.moralis.io/api/v2.2/:address/erc20

Get token balances for a specific wallet address.

💡Thumbnail ONLY for ETH

Currently, the thumbnail field is only available for ERC20 token that exist on the Ethereum chain (eth or 0x1 chain input). Otherwise, the thumbnail will be returned as null.

PATH PARAMS
addressstringrequired
The address from which token balances will be checked
QUERY PARAMS
chainstring
The chain to query
to_blocknumber
The block number from which the balances should be checked
token_addressesarray
The addresses to get balances for (optional)
No items in the array
exclude_spamboolean
Exclude spam tokens from the result
Responses
API KEY
import Moralis from 'moralis';

try {
await Moralis.start({
apiKey: "YOUR_API_KEY"
});

const response = await Moralis.EvmApi.token.getWalletTokenBalances({
"chain": "0x1",
"address": "0x1f9090aaE28b8a3dCeaDf281B0F12828e676c326"
});

console.log(response.raw);
} catch (e) {
console.error(e);
}
Response Example
{
"token_address": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
"name": "Kylin Network",
"symbol": "KYL",
"logo": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
"thumbnail": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c_thumb.png",
"decimals": "",
"balance": "123456789",
"possible_spam": "",
"verified_collection": ""
}