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>'import requests
url = "https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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",
"sparkline": {},
"pnl": {}
}
]
}Wallets API
Cross-Chain Token Balances
Get token balances from multiple chains for a specific wallet address. For Bitcoin wallets, filter parameters (excludeNative, excludeSpam, etc.) are ignored — only the native BTC balance is returned.
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>'import requests
url = "https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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",
"sparkline": {},
"pnl": {}
}
]
}Seeing spam tokens or inflated USD values? Set
excludeSpam, liquidityThreshold and maxTokenInactivity. See Accurate Net Worth & Token Balances for recommended values.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.Covers EVM chains and Bitcoin (pass
bitcoin in chains, with an address or xpub as the path parameter). Solana balances are available today through the dedicated Solana Wallet API; bringing them into this endpoint is on the roadmap. Set includeSparklines or includePnl to enrich each token with a 7-day price sparkline or a PnL summary.How to Fetch Cross-Chain Token Balances
Query Parameters
Chains to query
Available options:
0x1, ethereum, 0x13882, polygon amoy, 0x14a34, base sepolia, 0x15b38, chiliz, 0x171, pulse, 0x19, cro, 0x2105, base, 0x221, flow testnet, 0x2eb, flow, 0x38, binance, 0x46f, lisk, 0x504, moon beam, 0x505, moon river, 0x530, sei-testnet, 0x531, sei, 0x61, binance smart chain testnet, 0x64, gnosis, 0x7e4, ronin, 0x7e5, ronin testnet, 0x89, polygon, 0x8f, monad, 0xa, optimism, 0xa4b1, arbitrum, 0xa86a, avalanche, 0xaa36a7, sepolia, 0xe708, linea, bitcoin-mainnet, bitcoin, all, mainnets, testnets Response
200 - application/json

