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

200Returns ERC20 token balance, details, and additional financial information for a specific address, including pagination details.

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL
Node.js
Python
Go
PHP

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/tokens?chain=eth&limit=25' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/tokens?chain=eth&limit=25', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/tokens?chain=eth&limit=25"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/tokens?chain=eth&limit=25"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/tokens?chain=eth&limit=25', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

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
    }
  ]
}

Don't have an API key yet?

Get Native & ERC20 Token Balances by Wallet