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

array

Loading...

object

Loading...

wallet

string

Loading...

contracts

string

Loading...

blockNumber

integer

Loading...

page

integer

Loading...

perPage

integer

Loading...

Returns

object

Loading...

address

string

Loading...

ensName

string

Loading...

result

Loading...

quantityIn

Loading...

quantityOut

Loading...

address

Loading...

name

Loading...

decimals

Loading...

symbol

Loading...

totalBalance

Loading...

nativeTokenBalance

Loading...

totalPages

Loading...

pageNumber

Loading...

totalItems

Loading...

Request

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

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

1
require 'eth'
2

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

5
payload = {
6
    "id":67,
7
    "jsonrpc":"2.0",
8
    "method":"qn_getWalletTokenBalance",
9
    "params": [{
10
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
11
    }]
12
 }
13

14
response = client.send(payload.to_json)
15
puts response
16

1
require 'eth'
2

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

5
payload = {
6
    "id":67,
7
    "jsonrpc":"2.0",
8
    "method":"qn_getWalletTokenBalance",
9
    "params": [{
10
      "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
11
    }]
12
 }
13

14
response = client.send(payload.to_json)
15
puts response
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
    },
8
  ]);
9
  console.log(heads);
10
})();
11

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
    },
8
  ]);
9
  console.log(heads);
10
})();
11

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

4
var raw = JSON.stringify({
5
  "id": 67,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getWalletTokenBalance",
8
  "params": [{
9
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
10
  }]
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

20
fetch("https://docs-demo.quiknode.pro/", requestOptions)
21
  .then(response => response.text())
22
  .then(result => console.log(result))
23
  .catch(error => console.log('error', error));
24

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

4
var raw = JSON.stringify({
5
  "id": 67,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getWalletTokenBalance",
8
  "params": [{
9
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
10
  }]
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

20
fetch("https://docs-demo.quiknode.pro/", requestOptions)
21
  .then(response => response.text())
22
  .then(result => console.log(result))
23
  .catch(error => console.log('error', error));
24

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 67,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getWalletTokenBalance",
10
  "params": [{
11
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
12
  }]
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

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

20
print(response.text)
21

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 67,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getWalletTokenBalance",
10
  "params": [{
11
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
12
  }]
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

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

20
print(response.text)
21

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": 67,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getWalletTokenBalance",
16
  "params": [{
17
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
18
  }]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

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": 67,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getWalletTokenBalance",
16
  "params": [{
17
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
18
  }]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

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
}])
6
print(resp)
7

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
}])
6
print(resp)
7

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
      perPage: 2,
16
    })
17
    .then(res => console.log(res))
18

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
      perPage: 2,
16
    })
17
    .then(res => console.log(res))
18

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
    "ensName": "vitalik.eth",
7
    "result": [
8
      {
9
        "name": "Holy Trinity",
10
        "symbol": "HOLY",
11
        "decimals": "18",
12
        "address": "0x000000000000e63d2c9c29d3edf6efb99071f92c",
13
        "quantityIn": "500000000000000000000",
14
        "quantityOut": "0",
15
        "totalBalance": "500000000000000000000"
16
      },
17
      {
18
        "name": "Anonymous AI",
19
        "symbol": "ANON",
20
        "decimals": "18",
21
        "address": "0x00000000002514bf58ae82408e1e217f16a1dfa0",
22
        "quantityIn": "200000000000000000000000",
23
        "quantityOut": "0",
24
        "totalBalance": "200000000000000000000000"
25
      },
26
      {
27
        "name": "Lyra",
28
        "symbol": "LYRA",
29
        "decimals": "18",
30
        "address": "0x000000000072cd55f05d07ec75f33390fb0eaa97",
31
        "quantityIn": "100000000000000000000000",
32
        "quantityOut": "0",
33
        "totalBalance": "100000000000000000000000"
34
      },
35
      {
36
        "name": "Namefi Service Credit",
37
        "symbol": "NFSC",
38
        "decimals": "18",
39
        "address": "0x0000000000c39a0f674c12a5e63eb8031b550b6f",
40
        "quantityIn": "100000000000000000000",
41
        "quantityOut": "20000000000000000000",
42
        "totalBalance": "80000000000000000000"
43
      },
44
      {
45
        "name": "Milady Cult Coin",
46
        "symbol": "CULT",
47
        "decimals": "18",
48
        "address": "0x0000000000c5dc95539589fbd24be07c6c14eca4",
49
        "quantityIn": "1150000000000000000000000",
50
        "quantityOut": "0",
51
        "totalBalance": "1150000000000000000000000"
52
      },
53
      {
54
        "name": "01",
55
        "symbol": "01",
56
        "decimals": "18",
57
        "address": "0x0000000000dec1295e1663e7e1916d0e80905d9d",
58
        "quantityIn": "2500000000000000000000",
59
        "quantityOut": "0",
60
        "totalBalance": "2500000000000000000000"
61
      },
62
      {
63
        "name": "Anonymous AI",
64
        "symbol": "ANON",
65
        "decimals": "18",
66
        "address": "0x0000000000f593134dcf221a84c2fa0fc5c75bfc",
67
        "quantityIn": "100000000000000000000000",
68
        "quantityOut": "0",
69
        "totalBalance": "100000000000000000000000"
70
      },
71
      {
72
        "name": "iPhone 15",
73
        "symbol": "iPhone15",
74
        "decimals": "9",
75
        "address": "0x00000000366b8a1ec86d6c8e00c861bf2245d946",
76
        "quantityIn": "3000000000000000",
77
        "quantityOut": "0",
78
        "totalBalance": "3000000000000000"
79
      },
80
      {
81
        "name": "MUSHY",
82
        "symbol": "MUSHY",
83
        "decimals": "18",
84
        "address": "0x000000004bb4e57ca59cf7cfea73d57a34bf0776",
85
        "quantityIn": "100000000000000000000000",
86
        "quantityOut": "0",
87
        "totalBalance": "100000000000000000000000"
88
      },
89
      {
90
        "name": "Polygon Token",
91
        "symbol": "POL",
92
        "decimals": "18",
93
        "address": "0x00000000f9fd50c832d79facfe6f4e8ce90a5efb",
94
        "quantityIn": "800000000000000000000000000",
95
        "quantityOut": "400000000000000000000000000",
96
        "totalBalance": "400000000000000000000000000"
97
      },
98
      {
99
        "name": "Cultel",
100
        "symbol": "CULTEL",
101
        "decimals": "9",
102
        "address": "0x0000003ceede5c40e5187784d3e8dd5b43dc85f6",
103
        "quantityIn": "8898135489179102683",
104
        "quantityOut": "0",
105
        "totalBalance": "8898135489179102683"
106
      },
107
      {
108
        "name": "ETH GUY",
109
        "symbol": "ETHGUY",
110
        "decimals": "18",
111
        "address": "0x000000980d0be42ce4354a67458805f50578fa00",
112
        "quantityIn": "30000000000000000000000000",
113
        "quantityOut": "0",
114
        "totalBalance": "30000000000000000000000000"
115
      },
116
      {
117
        "name": "OG",
118
        "symbol": "OG",
119
        "decimals": "18",
120
        "address": "0x000000a1a6cb569ee64e1f8c3529390113e34cf8",
121
        "quantityIn": "37354520541552663319914900246",
122
        "quantityOut": "0",
123
        "totalBalance": "37354520541552663319914900246"
124
      },
125
      {
126
        "name": "ETHEREUM IS DEAD",
127
        "symbol": "DETH",
128
        "decimals": "9",
129
        "address": "0x000000add4658d83e7994e3ff7b4641d0e473e84",
130
        "quantityIn": "0",
131
        "quantityOut": "100000000000000000",
132
        "totalBalance": "0"
133
      },
134
      {
135
        "name": "The Protocol",
136
        "symbol": "THE",
137
        "decimals": "9",
138
        "address": "0x000000ddaab05b16aaab8d73e402f936d7dbaf73",
139
        "quantityIn": "5062498292885700000",
140
        "quantityOut": "0",
141
        "totalBalance": "5062498292885700000"
142
      },
143
      {
144
        "name": "Vit Guy",
145
        "symbol": "VITGUY",
146
        "decimals": "9",
147
        "address": "0x00000cc55035a11eec4ce5549d4aeb6c89f6c2a6",
148
        "quantityIn": "4206900000000000000",
149
        "quantityOut": "0",
150
        "totalBalance": "4206900000000000000"
151
      },
152
      {
153
        "name": "Wally2.0",
154
        "symbol": "WALLY2.0",
155
        "decimals": "9",
156
        "address": "0x00004963714f66aae8d08a744dcbd1f027cdc4de",
157
        "quantityIn": "400000000000000000",
158
        "quantityOut": "0",
159
        "totalBalance": "400000000000000000"
160
      },
161
      {
162
        "name": "Brainlet",
163
        "symbol": "BRAINLET",
164
        "decimals": "18",
165
        "address": "0x0000bdaa645097ef80f9d475f341d0d107a45b3a",
166
        "quantityIn": "15000000000000000000000000",
167
        "quantityOut": "0",
168
        "totalBalance": "15000000000000000000000000"
169
      },
170
      {
171
        "name": "Act I:The AI Prophecy",
172
        "symbol": "ACT",
173
        "decimals": "9",
174
        "address": "0x0000cdb43f47fe3fac3979594443d058be6fcde0",
175
        "quantityIn": "21034500000000000000",
176
        "quantityOut": "0",
177
        "totalBalance": "21034500000000000000"
178
      },
179
      {
180
        "name": "燃烧的豚林",
181
        "symbol": "豚林",
182
        "decimals": "18",
183
        "address": "0x0005cf3a3b053e0f63f5781072298af5e2dfd77a",
184
        "quantityIn": "210345000000000000000000000000",
185
        "quantityOut": "0",
186
        "totalBalance": "210345000000000000000000000000"
187
      }
188
    ],
189
    "nativeTokenBalance": "237.568608344516640858",
190
    "totalItems": 7751,
191
    "totalPages": 388,
192
    "pageNumber": 1
193
  }
194
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
    "ensName": "vitalik.eth",
7
    "result": [
8
      {
9
        "name": "Holy Trinity",
10
        "symbol": "HOLY",
11
        "decimals": "18",
12
        "address": "0x000000000000e63d2c9c29d3edf6efb99071f92c",
13
        "quantityIn": "500000000000000000000",
14
        "quantityOut": "0",
15
        "totalBalance": "500000000000000000000"
16
      },
17
      {
18
        "name": "Anonymous AI",
19
        "symbol": "ANON",
20
        "decimals": "18",
21
        "address": "0x00000000002514bf58ae82408e1e217f16a1dfa0",
22
        "quantityIn": "200000000000000000000000",
23
        "quantityOut": "0",
24
        "totalBalance": "200000000000000000000000"
25
      },
26
      {
27
        "name": "Lyra",
28
        "symbol": "LYRA",
29
        "decimals": "18",
30
        "address": "0x000000000072cd55f05d07ec75f33390fb0eaa97",
31
        "quantityIn": "100000000000000000000000",
32
        "quantityOut": "0",
33
        "totalBalance": "100000000000000000000000"
34
      },
35
      {
36
        "name": "Namefi Service Credit",
37
        "symbol": "NFSC",
38
        "decimals": "18",
39
        "address": "0x0000000000c39a0f674c12a5e63eb8031b550b6f",
40
        "quantityIn": "100000000000000000000",
41
        "quantityOut": "20000000000000000000",
42
        "totalBalance": "80000000000000000000"
43
      },
44
      {
45
        "name": "Milady Cult Coin",
46
        "symbol": "CULT",
47
        "decimals": "18",
48
        "address": "0x0000000000c5dc95539589fbd24be07c6c14eca4",
49
        "quantityIn": "1150000000000000000000000",
50
        "quantityOut": "0",
51
        "totalBalance": "1150000000000000000000000"
52
      },
53
      {
54
        "name": "01",
55
        "symbol": "01",
56
        "decimals": "18",
57
        "address": "0x0000000000dec1295e1663e7e1916d0e80905d9d",
58
        "quantityIn": "2500000000000000000000",
59
        "quantityOut": "0",
60
        "totalBalance": "2500000000000000000000"
61
      },
62
      {
63
        "name": "Anonymous AI",
64
        "symbol": "ANON",
65
        "decimals": "18",
66
        "address": "0x0000000000f593134dcf221a84c2fa0fc5c75bfc",
67
        "quantityIn": "100000000000000000000000",
68
        "quantityOut": "0",
69
        "totalBalance": "100000000000000000000000"
70
      },
71
      {
72
        "name": "iPhone 15",
73
        "symbol": "iPhone15",
74
        "decimals": "9",
75
        "address": "0x00000000366b8a1ec86d6c8e00c861bf2245d946",
76
        "quantityIn": "3000000000000000",
77
        "quantityOut": "0",
78
        "totalBalance": "3000000000000000"
79
      },
80
      {
81
        "name": "MUSHY",
82
        "symbol": "MUSHY",
83
        "decimals": "18",
84
        "address": "0x000000004bb4e57ca59cf7cfea73d57a34bf0776",
85
        "quantityIn": "100000000000000000000000",
86
        "quantityOut": "0",
87
        "totalBalance": "100000000000000000000000"
88
      },
89
      {
90
        "name": "Polygon Token",
91
        "symbol": "POL",
92
        "decimals": "18",
93
        "address": "0x00000000f9fd50c832d79facfe6f4e8ce90a5efb",
94
        "quantityIn": "800000000000000000000000000",
95
        "quantityOut": "400000000000000000000000000",
96
        "totalBalance": "400000000000000000000000000"
97
      },
98
      {
99
        "name": "Cultel",
100
        "symbol": "CULTEL",
101
        "decimals": "9",
102
        "address": "0x0000003ceede5c40e5187784d3e8dd5b43dc85f6",
103
        "quantityIn": "8898135489179102683",
104
        "quantityOut": "0",
105
        "totalBalance": "8898135489179102683"
106
      },
107
      {
108
        "name": "ETH GUY",
109
        "symbol": "ETHGUY",
110
        "decimals": "18",
111
        "address": "0x000000980d0be42ce4354a67458805f50578fa00",
112
        "quantityIn": "30000000000000000000000000",
113
        "quantityOut": "0",
114
        "totalBalance": "30000000000000000000000000"
115
      },
116
      {
117
        "name": "OG",
118
        "symbol": "OG",
119
        "decimals": "18",
120
        "address": "0x000000a1a6cb569ee64e1f8c3529390113e34cf8",
121
        "quantityIn": "37354520541552663319914900246",
122
        "quantityOut": "0",
123
        "totalBalance": "37354520541552663319914900246"
124
      },
125
      {
126
        "name": "ETHEREUM IS DEAD",
127
        "symbol": "DETH",
128
        "decimals": "9",
129
        "address": "0x000000add4658d83e7994e3ff7b4641d0e473e84",
130
        "quantityIn": "0",
131
        "quantityOut": "100000000000000000",
132
        "totalBalance": "0"
133
      },
134
      {
135
        "name": "The Protocol",
136
        "symbol": "THE",
137
        "decimals": "9",
138
        "address": "0x000000ddaab05b16aaab8d73e402f936d7dbaf73",
139
        "quantityIn": "5062498292885700000",
140
        "quantityOut": "0",
141
        "totalBalance": "5062498292885700000"
142
      },
143
      {
144
        "name": "Vit Guy",
145
        "symbol": "VITGUY",
146
        "decimals": "9",
147
        "address": "0x00000cc55035a11eec4ce5549d4aeb6c89f6c2a6",
148
        "quantityIn": "4206900000000000000",
149
        "quantityOut": "0",
150
        "totalBalance": "4206900000000000000"
151
      },
152
      {
153
        "name": "Wally2.0",
154
        "symbol": "WALLY2.0",
155
        "decimals": "9",
156
        "address": "0x00004963714f66aae8d08a744dcbd1f027cdc4de",
157
        "quantityIn": "400000000000000000",
158
        "quantityOut": "0",
159
        "totalBalance": "400000000000000000"
160
      },
161
      {
162
        "name": "Brainlet",
163
        "symbol": "BRAINLET",
164
        "decimals": "18",
165
        "address": "0x0000bdaa645097ef80f9d475f341d0d107a45b3a",
166
        "quantityIn": "15000000000000000000000000",
167
        "quantityOut": "0",
168
        "totalBalance": "15000000000000000000000000"
169
      },
170
      {
171
        "name": "Act I:The AI Prophecy",
172
        "symbol": "ACT",
173
        "decimals": "9",
174
        "address": "0x0000cdb43f47fe3fac3979594443d058be6fcde0",
175
        "quantityIn": "21034500000000000000",
176
        "quantityOut": "0",
177
        "totalBalance": "21034500000000000000"
178
      },
179
      {
180
        "name": "燃烧的豚林",
181
        "symbol": "豚林",
182
        "decimals": "18",
183
        "address": "0x0005cf3a3b053e0f63f5781072298af5e2dfd77a",
184
        "quantityIn": "210345000000000000000000000000",
185
        "quantityOut": "0",
186
        "totalBalance": "210345000000000000000000000000"
187
      }
188
    ],
189
    "nativeTokenBalance": "237.568608344516640858",
190
    "totalItems": 7751,
191
    "totalPages": 388,
192
    "pageNumber": 1
193
  }
194
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free