Join AWS, Dust Labs & OrangeDAO at QuickPitch. Win $80k — Apply Today.


qn_getWalletTokenBalance RPC Method

The API credit value for this method is 4 . To learn more about API credits and each method's value, visit the API Credits page.

Please note that this RPC method requires the Token API add-on enabled on your QuickNode endpoint. Also, it supports ERC-20 compliant contracts (on Ethereum mainnet).


  1. object - The custom object with the following fields:

    wallet - string - The wallet address to check for ERC-20 tokens.

    contracts - string - An array with the list of ERC-20 contract addresses to filter wallet balance results on. You may include up to 100 contract addresses per request


  1. object - The custom response object, or null if no tokens are found:

    assets - An array of objects representing tokens with the following shape:

    address - The address of the ERC-20 token contract

    name - The name of the token

    decimals - The number of decimal places supported by the token contract

    symbol - The symbol of the token

    logoURl - The URL address of the token

    chain - The chain where the contract was deployed

    network - The network where the contract was deployed

    amount - The balance of the token within the owner's wallet

    owner - The wallet address we checked for tokens

    totalPages - The total number of results pages available

    pageNumber - The page number of results that was returned with this response

    totalItems - The total number of results

Code Examples:

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("x-qn-api-version", "1");

var raw = JSON.stringify({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getWalletTokenBalance",
  "params": {
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'

fetch("", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
Ready to get started? Create a free account