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

wallet

string

REQUIRED

Loading...

contracts

array

Loading...

blockNumber

integer

Loading...

page

integer

Loading...

perPage

integer

Loading...

Returns

object

Loading...

address

string

Loading...

ensName

string

Loading...

result

array

Loading...

quantityIn

string

Loading...

quantityOut

string

Loading...

address

string

Loading...

name

string

Loading...

decimals

string

Loading...

symbol

string

Loading...

totalBalance

string

Loading...

nativeTokenBalance

string

Loading...

totalPages

integer

Loading...

pageNumber

integer

Loading...

totalItems

integer

Loading...

Request

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "id": 1,
6
    "jsonrpc": "2.0",
7
    "method": "qn_getWalletTokenBalance",
8
    "params": [{
9
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
      "contracts": [
11
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
12
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
13
      ],
14
      "page": 1,
15
      "perPage": 10
16
    }]
17
  }'

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "id": 1,
6
    "jsonrpc": "2.0",
7
    "method": "qn_getWalletTokenBalance",
8
    "params": [{
9
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
      "contracts": [
11
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
12
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
13
      ],
14
      "page": 1,
15
      "perPage": 10
16
    }]
17
  }'

1
require 'eth'
2

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

5
payload = {
6
    "id": 1,
7
    "jsonrpc": "2.0",
8
    "method": "qn_getWalletTokenBalance",
9
    "params": [{
10
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
11
      "contracts": [
12
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
13
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
14
      ],
15
      "page": 1,
16
      "perPage": 10
17
    }]
18
 }
19

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

1
require 'eth'
2

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

5
payload = {
6
    "id": 1,
7
    "jsonrpc": "2.0",
8
    "method": "qn_getWalletTokenBalance",
9
    "params": [{
10
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
11
      "contracts": [
12
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
13
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
14
      ],
15
      "page": 1,
16
      "perPage": 10
17
    }]
18
 }
19

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

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
4
  const heads = await provider.send("qn_getWalletTokenBalance", [
5
    {
6
      wallet: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
7
      contracts: [
8
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
9
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
10
      ],
11
      page: 1,
12
      perPage: 10
13
    },
14
  ]);
15
  console.log(heads);
16
})();

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
4
  const heads = await provider.send("qn_getWalletTokenBalance", [
5
    {
6
      wallet: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
7
      contracts: [
8
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
9
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
10
      ],
11
      page: 1,
12
      perPage: 10
13
    },
14
  ]);
15
  console.log(heads);
16
})();

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

4
var raw = JSON.stringify({
5
  "id": 1,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getWalletTokenBalance",
8
  "params": [{
9
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
    "contracts": [
11
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
12
      "0xdAC17F958D2ee523a2206206994597C13D831ec7"
13
    ],
14
    "page": 1,
15
    "perPage": 10
16
  }]
17
});
18

19
var requestOptions = {
20
  method: 'POST',
21
  headers: myHeaders,
22
  body: raw,
23
  redirect: 'follow'
24
};
25

26
fetch("https://docs-demo.quiknode.pro/", requestOptions)
27
  .then(response => response.text())
28
  .then(result => console.log(result))
29
  .catch(error => console.log('error', error));

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

4
var raw = JSON.stringify({
5
  "id": 1,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getWalletTokenBalance",
8
  "params": [{
9
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
    "contracts": [
11
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
12
      "0xdAC17F958D2ee523a2206206994597C13D831ec7"
13
    ],
14
    "page": 1,
15
    "perPage": 10
16
  }]
17
});
18

19
var requestOptions = {
20
  method: 'POST',
21
  headers: myHeaders,
22
  body: raw,
23
  redirect: 'follow'
24
};
25

26
fetch("https://docs-demo.quiknode.pro/", requestOptions)
27
  .then(response => response.text())
28
  .then(result => console.log(result))
29
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 1,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getWalletTokenBalance",
10
  "params": [{
11
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
12
    "contracts": [
13
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
14
      "0xdAC17F958D2ee523a2206206994597C13D831ec7"
15
    ],
16
    "page": 1,
17
    "perPage": 10
18
  }]
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

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

26
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 1,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getWalletTokenBalance",
10
  "params": [{
11
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
12
    "contracts": [
13
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
14
      "0xdAC17F958D2ee523a2206206994597C13D831ec7"
15
    ],
16
    "page": 1,
17
    "perPage": 10
18
  }]
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

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

26
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "id": 1,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getWalletTokenBalance",
16
  "params": [{
17
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
18
    "contracts": [
19
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
20
      "0xdAC17F958D2ee523a2206206994597C13D831ec7"
21
    ],
22
    "page": 1,
23
    "perPage": 10
24
  }]
25
})
26

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

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "id": 1,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getWalletTokenBalance",
16
  "params": [{
17
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
18
    "contracts": [
19
      "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
20
      "0xdAC17F958D2ee523a2206206994597C13D831ec7"
21
    ],
22
    "page": 1,
23
    "perPage": 10
24
  }]
25
})
26

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

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/'))
3
resp = w3.provider.make_request('qn_getWalletTokenBalance', [{
4
  "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
5
  "contracts": [
6
    "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
7
    "0xdAC17F958D2ee523a2206206994597C13D831ec7"
8
  ],
9
  "page": 1,
10
  "perPage": 10
11
}])
12
print(resp)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/'))
3
resp = w3.provider.make_request('qn_getWalletTokenBalance', [{
4
  "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
5
  "contracts": [
6
    "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
7
    "0xdAC17F958D2ee523a2206206994597C13D831ec7"
8
  ],
9
  "page": 1,
10
  "perPage": 10
11
}])
12
print(resp)

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.quiknode.pro/",
5
  config: {
6
    addOns: {
7
      nftTokenV2: true,
8
    },
9
  },
10
})
11

12
core.client
13
    .qn_getWalletTokenBalance({
14
      wallet: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
15
      contracts: [
16
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
17
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
18
      ],
19
      page: 1,
20
      perPage: 2,
21
    })
22
    .then(res => console.log(res))

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.quiknode.pro/",
5
  config: {
6
    addOns: {
7
      nftTokenV2: true,
8
    },
9
  },
10
})
11

12
core.client
13
    .qn_getWalletTokenBalance({
14
      wallet: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
15
      contracts: [
16
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
17
        "0xdAC17F958D2ee523a2206206994597C13D831ec7"
18
      ],
19
      page: 1,
20
      perPage: 2,
21
    })
22
    .then(res => console.log(res))

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
    "ensName": "vitalik.eth",
7
    "result": [
8
      {
9
        "name": "USD Coin",
10
        "symbol": "USDC",
11
        "decimals": "6",
12
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
13
        "quantityIn": "3196941437801",
14
        "quantityOut": "3192810447159",
15
        "totalBalance": "4130990642"
16
      },
17
      {
18
        "name": "Tether USD",
19
        "symbol": "USDT",
20
        "decimals": "6",
21
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
22
        "quantityIn": "101379287975",
23
        "quantityOut": "101110107635",
24
        "totalBalance": "269180340"
25
      }
26
    ],
27
    "nativeTokenBalance": "33.111612880018143614",
28
    "totalItems": 2,
29
    "totalPages": 1,
30
    "pageNumber": 1
31
  }
32
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
    "ensName": "vitalik.eth",
7
    "result": [
8
      {
9
        "name": "USD Coin",
10
        "symbol": "USDC",
11
        "decimals": "6",
12
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
13
        "quantityIn": "3196941437801",
14
        "quantityOut": "3192810447159",
15
        "totalBalance": "4130990642"
16
      },
17
      {
18
        "name": "Tether USD",
19
        "symbol": "USDT",
20
        "decimals": "6",
21
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
22
        "quantityIn": "101379287975",
23
        "quantityOut": "101110107635",
24
        "totalBalance": "269180340"
25
      }
26
    ],
27
    "nativeTokenBalance": "33.111612880018143614",
28
    "totalItems": 2,
29
    "totalPages": 1,
30
    "pageNumber": 1
31
  }
32
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free