Skip to main content
GET
/
{address}
/
erc20
Get ERC20 token balances by wallet
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/{address}/erc20 \
  --header 'X-API-Key: <api-key>'
[
  {
    "token_address": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
    "name": "Kylin Network",
    "symbol": "KYL",
    "decimals": 18,
    "balance": "123456789",
    "possible_spam": "false",
    "logo": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    "thumbnail": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c_thumb.png",
    "verified_contract": "false"
  }
]
We recommended using the latest Token Balances endpoint.
Endpoint cost: CUs. Learn more about compute units.

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
address
string
required

The address from which token balances will be checked

Example:

"0xcB1C1FdE09f811B294172696404e88E658659905"

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

​
to_block
number

The block number up to which the balances will be checked.

​
token_addresses
string[]

The addresses to get balances for (optional)

Maximum array length: 10
​
exclude_spam
boolean
default:true

Exclude spam tokens from the result

Response

200 - application/json

Returns token balances for a specific address

​
token_address
string
required

The address of the token contract

Example:

"0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09"

​
name
string
required

The name of the token contract

Example:

"Kylin Network"

​
symbol
string
required

The symbol of the NFT contract

Example:

"KYL"

​
decimals
integer
required

The number of decimals on the token

Example:

18

​
balance
string
required

Timestamp of when the contract was last synced with the node

Example:

"123456789"

​
possible_spam
boolean
required

Indicates if a contract is possibly a spam contract

Example:

"false"

The logo of the token

Example:

"https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png"

​
thumbnail
string

The thumbnail of the logo

Example:

"https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c_thumb.png"

​
verified_contract
boolean

Indicates if a contract is verified

Example:

"false"