qn_getWalletTokenBalance (v2) RPC Method

Please note that this RPC method requires the Token and NFT API v2 bundle add-on enabled on your QuickNode endpoint.

Parameters

array

array

An array with the first element being:

object

The custom object with the following fields:

wallet

string

The wallet address or ENS name 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

blockNumber

integer

The block number you would like to get wallet balances from. If omitted, defaults to latest block

page

integer

The page number you would like returned. The page numbers start at 1 and end at totalPages. If omitted, defaults to the first page (page 1). If the page number requested is higher than totalPages, an empty transfers array will be returned. If the page number requested is less than 1, an invalid params response will be returned

perPage

integer

The maximum amount of tokens to return on each page. You can request up to 100 items per page. If omitted, defaults to 20 items per page

Returns

object

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

address

string

The address we checked for ERC-20 tokens

ensName

string

The ENS name associated with the address we checked

result

An array of objects representing tokens with the following shape:

quantityIn

The total amount of tokens that have been transferred into the wallet

quantityOut

The total amount of tokens that have been transferred out of the wallet

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

totalBalance

The balance of the token within the owner's wallet

nativeTokenBalance

The balance of the native token within the owner's wallet

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

Request

curl https://docs-demo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_getWalletTokenBalance",
    "params": [{
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
    }]
  }'

require 'eth'

client = Eth::Client.create 'https://docs-demo.quiknode.pro/'

payload = {
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_getWalletTokenBalance",
    "params": [{
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
    }]
 }

response = client.send(payload.to_json)
puts response

import { ethers } from "ethers";
(async () => {
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
  const heads = await provider.send("qn_getWalletTokenBalance", [
    {
      wallet: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    },
  ]);
  console.log(heads);
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

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("https://docs-demo.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.quiknode.pro/"

payload = json.dumps({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getWalletTokenBalance",
  "params": [{
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
  }]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getWalletTokenBalance",
  "params": [{
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
  }]
})

response = https.request(request)
puts response.read_body

from web3 import Web3, HTTPProvider
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/'))
resp = w3.provider.make_request('qn_getWalletTokenBalance', [{
  "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}])
print(resp)

import { Core } from '@quicknode/sdk'

const core = new Core({
  endpointUrl: "https://docs-demo.quiknode.pro/",
  config: {
    addOns: {
      nftTokenV2: true,
    },
  },
})

core.client
    .qn_getWalletTokenBalance({
      wallet: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
      perPage: 2,
    })
    .then(res => console.log(res))

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free