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

Parameters

object

object

REQUIRED

The wallet token balance request object with the following fields:

wallet

string

REQUIRED

The wallet address or ENS name to check for ERC-20 tokens.

contracts

array

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.

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

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

array

An array of objects representing tokens with the following shape:

quantityIn

string

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

quantity_in

string

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

quantityOut

string

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

quantity_out

string

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

address

string

The address of the ERC-20 token contract.

name

string

The name of the token.

decimals

string

The number of decimal places supported by the token contract.

symbol

string

The symbol of the token.

totalBalance

string

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

total_balance

string

The token balance within the owner's wallet.

nativeTokenBalance

string

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

totalPages

integer

The total number of results pages available.

pageNumber

integer

The page number of results that was returned with this response.

totalItems

integer

The total number of results.

Request

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

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getWalletTokenBalance',
4
    params: [{"wallet":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getWalletTokenBalance',
4
    params: [{"wallet":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

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

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

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

22
print(response.text)

1
import requests
2
import json
3

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

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

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

22
print(response.text)

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

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

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

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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

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

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

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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
        "quantity_in": "3196941437801",
17
        "quantity_out": "3192810447159",
18
        "total_balance": "4130990642"
19
      },
20
      {
21
        "name": "Tether USD",
22
        "symbol": "USDT",
23
        "decimals": "6",
24
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
25
        "quantityIn": "101379287975",
26
        "quantityOut": "101110107635",
27
        "totalBalance": "269180340",
28
        "quantity_in": "101379287975",
29
        "quantity_out": "101110107635",
30
        "total_balance": "269180340"
31
      }
32
    ],
33
    "nativeTokenBalance": "33.111612880018143614",
34
    "totalItems": 2,
35
    "totalPages": 1,
36
    "pageNumber": 1
37
  }
38
}

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
        "quantity_in": "3196941437801",
17
        "quantity_out": "3192810447159",
18
        "total_balance": "4130990642"
19
      },
20
      {
21
        "name": "Tether USD",
22
        "symbol": "USDT",
23
        "decimals": "6",
24
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
25
        "quantityIn": "101379287975",
26
        "quantityOut": "101110107635",
27
        "totalBalance": "269180340",
28
        "quantity_in": "101379287975",
29
        "quantity_out": "101110107635",
30
        "total_balance": "269180340"
31
      }
32
    ],
33
    "nativeTokenBalance": "33.111612880018143614",
34
    "totalItems": 2,
35
    "totalPages": 1,
36
    "pageNumber": 1
37
  }
38
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free