qn_getWalletTokenBalance (v2) RPC Method - Token and NFT API

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

Parameters

array

object

wallet

string

contracts

string

blockNumber

integer

page

integer

perPage

integer

Returns

object

address

string

ensName

string

result

quantityIn

quantityOut

address

name

decimals

symbol

totalBalance

nativeTokenBalance

totalPages

pageNumber

totalItems

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))

Response

{
  "jsonrpc": "2.0",
  "id": 67,
  "result": {
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "ensName": "vitalik.eth",
    "result": [
      {
        "name": "Holy Trinity",
        "symbol": "HOLY",
        "decimals": "18",
        "address": "0x000000000000e63d2c9c29d3edf6efb99071f92c",
        "quantityIn": "500000000000000000000",
        "quantityOut": "0",
        "totalBalance": "500000000000000000000"
      },
      {
        "name": "Anonymous AI",
        "symbol": "ANON",
        "decimals": "18",
        "address": "0x00000000002514bf58ae82408e1e217f16a1dfa0",
        "quantityIn": "200000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "200000000000000000000000"
      },
      {
        "name": "Lyra",
        "symbol": "LYRA",
        "decimals": "18",
        "address": "0x000000000072cd55f05d07ec75f33390fb0eaa97",
        "quantityIn": "100000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "100000000000000000000000"
      },
      {
        "name": "Namefi Service Credit",
        "symbol": "NFSC",
        "decimals": "18",
        "address": "0x0000000000c39a0f674c12a5e63eb8031b550b6f",
        "quantityIn": "100000000000000000000",
        "quantityOut": "20000000000000000000",
        "totalBalance": "80000000000000000000"
      },
      {
        "name": "Milady Cult Coin",
        "symbol": "CULT",
        "decimals": "18",
        "address": "0x0000000000c5dc95539589fbd24be07c6c14eca4",
        "quantityIn": "1150000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "1150000000000000000000000"
      },
      {
        "name": "01",
        "symbol": "01",
        "decimals": "18",
        "address": "0x0000000000dec1295e1663e7e1916d0e80905d9d",
        "quantityIn": "2500000000000000000000",
        "quantityOut": "0",
        "totalBalance": "2500000000000000000000"
      },
      {
        "name": "Anonymous AI",
        "symbol": "ANON",
        "decimals": "18",
        "address": "0x0000000000f593134dcf221a84c2fa0fc5c75bfc",
        "quantityIn": "100000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "100000000000000000000000"
      },
      {
        "name": "iPhone 15",
        "symbol": "iPhone15",
        "decimals": "9",
        "address": "0x00000000366b8a1ec86d6c8e00c861bf2245d946",
        "quantityIn": "3000000000000000",
        "quantityOut": "0",
        "totalBalance": "3000000000000000"
      },
      {
        "name": "MUSHY",
        "symbol": "MUSHY",
        "decimals": "18",
        "address": "0x000000004bb4e57ca59cf7cfea73d57a34bf0776",
        "quantityIn": "100000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "100000000000000000000000"
      },
      {
        "name": "Polygon Token",
        "symbol": "POL",
        "decimals": "18",
        "address": "0x00000000f9fd50c832d79facfe6f4e8ce90a5efb",
        "quantityIn": "800000000000000000000000000",
        "quantityOut": "400000000000000000000000000",
        "totalBalance": "400000000000000000000000000"
      },
      {
        "name": "Cultel",
        "symbol": "CULTEL",
        "decimals": "9",
        "address": "0x0000003ceede5c40e5187784d3e8dd5b43dc85f6",
        "quantityIn": "8898135489179102683",
        "quantityOut": "0",
        "totalBalance": "8898135489179102683"
      },
      {
        "name": "ETH GUY",
        "symbol": "ETHGUY",
        "decimals": "18",
        "address": "0x000000980d0be42ce4354a67458805f50578fa00",
        "quantityIn": "30000000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "30000000000000000000000000"
      },
      {
        "name": "OG",
        "symbol": "OG",
        "decimals": "18",
        "address": "0x000000a1a6cb569ee64e1f8c3529390113e34cf8",
        "quantityIn": "37354520541552663319914900246",
        "quantityOut": "0",
        "totalBalance": "37354520541552663319914900246"
      },
      {
        "name": "ETHEREUM IS DEAD",
        "symbol": "DETH",
        "decimals": "9",
        "address": "0x000000add4658d83e7994e3ff7b4641d0e473e84",
        "quantityIn": "0",
        "quantityOut": "100000000000000000",
        "totalBalance": "0"
      },
      {
        "name": "The Protocol",
        "symbol": "THE",
        "decimals": "9",
        "address": "0x000000ddaab05b16aaab8d73e402f936d7dbaf73",
        "quantityIn": "5062498292885700000",
        "quantityOut": "0",
        "totalBalance": "5062498292885700000"
      },
      {
        "name": "Vit Guy",
        "symbol": "VITGUY",
        "decimals": "9",
        "address": "0x00000cc55035a11eec4ce5549d4aeb6c89f6c2a6",
        "quantityIn": "4206900000000000000",
        "quantityOut": "0",
        "totalBalance": "4206900000000000000"
      },
      {
        "name": "Wally2.0",
        "symbol": "WALLY2.0",
        "decimals": "9",
        "address": "0x00004963714f66aae8d08a744dcbd1f027cdc4de",
        "quantityIn": "400000000000000000",
        "quantityOut": "0",
        "totalBalance": "400000000000000000"
      },
      {
        "name": "Brainlet",
        "symbol": "BRAINLET",
        "decimals": "18",
        "address": "0x0000bdaa645097ef80f9d475f341d0d107a45b3a",
        "quantityIn": "15000000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "15000000000000000000000000"
      },
      {
        "name": "Act I:The AI Prophecy",
        "symbol": "ACT",
        "decimals": "9",
        "address": "0x0000cdb43f47fe3fac3979594443d058be6fcde0",
        "quantityIn": "21034500000000000000",
        "quantityOut": "0",
        "totalBalance": "21034500000000000000"
      },
      {
        "name": "燃烧的豚林",
        "symbol": "豚林",
        "decimals": "18",
        "address": "0x0005cf3a3b053e0f63f5781072298af5e2dfd77a",
        "quantityIn": "210345000000000000000000000000",
        "quantityOut": "0",
        "totalBalance": "210345000000000000000000000000"
      }
    ],
    "nativeTokenBalance": "237.568608344516640858",
    "totalItems": 7751,
    "totalPages": 388,
    "pageNumber": 1
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

qn_getWalletTokenBalance (v2) RPC Method - Token and NFT API

Loading...

Parameters

Returns