Skip to main content
GET
/
wallets
/
{address}
/
tokens
Get token balances with prices by wallet address
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/wallets/{address}/tokens \
  --header 'X-API-Key: <api-key>'
{
  "result": [
    {
      "name": "<string>",
      "symbol": "<string>",
      "decimals": 123,
      "balance": "<string>",
      "possible_spam": true,
      "usd_price": "<string>",
      "usd_price_24hr_percent_change": "<string>",
      "usd_price_24hr_usd_change": "<string>",
      "usd_value": 123,
      "portfolio_percentage": 123,
      "balance_formatted": "<string>",
      "native_token": true,
      "token_address": "<string>",
      "logo": "<string>",
      "thumbnail": "<string>",
      "verified_contract": true,
      "usd_value_24hr_usd_change": "<string>",
      "total_supply": "<string>",
      "total_supply_formatted": "<string>",
      "percentage_relative_to_total_supply": 123
    }
  ],
  "page": "2",
  "page_size": "100",
  "block_number": "13680123",
  "cursor": "<string>"
}
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:false

Exclude spam tokens from the result

​
exclude_unverified_contracts
boolean
default:false

Exclude unverified contracts from the result

​
cursor
string

The cursor returned in the previous response (used for getting the next page).

​
limit
integer

The desired page size of the result.

Required range: x >= 0
​
exclude_native
boolean
default:false

Exclude native balance from the result

​
max_token_inactivity
number

Exclude tokens inactive for more than the given amount of days

​
min_pair_side_liquidity_usd
number

Exclude tokens with liquidity less than the specified amount in USD. This parameter refers to the liquidity on a single side of the pair.

Response

200 - application/json

Returns token balances with prices for a specific address

​
result
object[]
required
​
page
integer

The current page of the result

Example:

"2"

​
page_size
integer

The number of results per page

Example:

"100"

​
block_number
string

The block number of the transaction

Example:

"13680123"

​
cursor
string

The cursor to get to the next page