Skip to main content
GET
/
v1
/
wallets
/
{walletAddressOrPublicKey}
/
tokens
Get token balances from multiple chains for a specific wallet address.
curl --request GET \
  --url https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens \
  --header 'X-Api-Key: <api-key>'
{
  "meta": {
    "syncedAt": {
      "0x1": 1710000000,
      "solana-mainnet": "latest"
    },
    "unsupportedChains": [
      "0x89"
    ],
    "failedChains": [
      "0x89"
    ]
  },
  "address": "0xcb1c1fde09f811b294172696404e88e658659905",
  "addressType": "evm",
  "cursor": "eyJhbGciOi...VCaaw",
  "result": [
    {
      "tokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "balanceRaw": "8541786218567066193031597821",
      "chainId": "0x1",
      "name": "Tether USD",
      "symbol": "USDT",
      "decimals": 6,
      "logo": "https://logo.moralis.io/0x1_0xdac17f958d2ee523a2206206994597c13d831ec7_3b83ef2ba0dba0e3385a845032e48304.webp",
      "possibleSpam": false,
      "verifiedContract": true,
      "balance": "8541786218567066193031.597821",
      "securityScore": 99,
      "portfolioPercentage": 100,
      "usdPrice": 1,
      "usdPrice24hrUsdChange": 0,
      "usdPrice24hrPercentChange": 0,
      "usdValue": 1,
      "usdValue24hrUsdChange": 0,
      "nativeToken": false,
      "derivedAddress": "1EfgV2Hr5CDjXPavHDpDMjmU33BA2veHy6",
      "derivedPath": "m/44'/0'/0'/0/0"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.moralis.com/llms.txt

Use this file to discover all available pages before exploring further.

This is the multi-chain successor to the legacy Deep Index Token Balances endpoint. The same filters - spam exclusion, unverified contracts, liquidity thresholds, USD pricing - are preserved. The headline change is that a single request now returns balances across multiple chains.Currently EVM. Bitcoin and Solana support is on the roadmap.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
walletAddressOrPublicKey
string
required

The address or public key of the account

Query Parameters

​
chains
enum<string>[]

Chains to query

Available options:
0x1,
ethereum,
0x171,
pulse,
0x2105,
base,
0x38,
binance,
0x530,
sei-testnet,
0x531,
sei,
0x89,
polygon,
0x8f,
monad,
0xa,
optimism,
0xa86a,
avalanche,
all,
mainnets,
testnets
​
cursor
string

The cursor to the next page

​
limit
number
default:100

The limit per page

Required range: 1 <= x <= 1000
​
tokenAddresses
string[]

The token addresses to be filtered in

Example:
[
  "0xdac17f958d2ee523a2206206994597c13d831ec7"
]
​
excludeSpam
boolean
default:false

Should exclude spam contract

Example:

true

​
excludeUnverifiedContracts
boolean
default:false

Should exclude unverified contract

Example:

true

​
excludeNative
boolean
default:false

Should exclude native contract

Example:

true

​
maxTokenInactivity
number

Should filter out contract exceeding max token inactivity

Example:

1

​
liquidityThreshold
number

Should filter out contract under liquidity threshold

Example:

0

Response

200 - application/json
​
meta
object
required

Metadata about the multi-chain request

​
address
string
required

The wallet address

Example:

"0xcb1c1fde09f811b294172696404e88e658659905"

​
addressType
enum<string>
required

The wallet address type

Available options:
evm,
solana,
bitcoin
Example:

"evm"

​
cursor
string | null
required

The cursor to be used for getting the next page of results

Example:

"eyJhbGciOi...VCaaw"

​
result
object[]
required

The list of items