Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key
Version: 2.2

Get Native & ERC20 Token Balances by Wallet

GEThttps://deep-index.moralis.io/api/v2.2/wallets/:address/tokens

Get token balances for a specific wallet address and their token prices in USD.

PATH PARAMS
addressstringrequired
The address from which token balances will be checked
QUERY PARAMS
chainstring
The chain to query
to_blocknumber
The block number up to which the balances will be checked.
token_addressesarray
The addresses to get balances for (optional)
No items in the array
exclude_spamboolean
Exclude spam tokens from the result
exclude_unverified_contractsboolean
Exclude unverified contracts from the result
cursorstring
The cursor returned in the previous response (used for getting the next page).
limitnumber
The desired page size of the result.
exclude_nativeboolean
Exclude native balance from the result
max_token_inactivitynumber
Exclude tokens inactive for more than the given amount of days
min_pair_side_liquidity_usdnumber
Exclude tokens with liquidity less than the specified amount in USD. This parameter refers to the liquidity on a single side of the pair.
Responses
API KEY
import Moralis from 'moralis';

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

const response = await Moralis.EvmApi.wallets.getWalletTokenBalancesPrice({
"chain": "0x1",
"address": "0xcB1C1FdE09f811B294172696404e88E658659905"
});

console.log(response.raw);
} catch (e) {
console.error(e);
}
Response Example
{
"cursor": "",
"page": 2,
"page_size": 100,
"result": [
{
"token_address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"symbol": "ETH",
"name": "Ether",
"logo": "https://cdn.moralis.io/eth/0x.png",
"thumbnail": "https://cdn.moralis.io/eth/0x_thumb.png",
"decimals": "",
"balance": "360659174684349604",
"possible_spam": "",
"verified_contract": true,
"balance_formatted": "0.360659174684349604",
"usd_price": 3725.2775921204284,
"usd_price_24hr_percent_change": 1.2028612707326054,
"usd_price_24hr_usd_change": 44.80992138289679,
"usd_value": 1343.5555418442548,
"usd_value_24hr_usd_change": 16.161109263626145,
"native_token": true,
"portfolio_percentage": 55.7292
}
]
}