qn_fetchNFTs (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. Additionally, for a contract to be fully indexed, it must be verified on Etherscan.

Parameters

object

object

REQUIRED

Loading...

wallet

string

REQUIRED

Loading...

contracts

array

Loading...

page

integer

Loading...

perPage

integer

Loading...

omitFields

array

Loading...

Returns

object

object

Loading...

owner

string

Loading...

ensName

string

Loading...

assets

array

Loading...

name

string

Loading...

collectionTokenId

string

Loading...

collectionName

string

Loading...

traits

array

Loading...

value

string

Loading...

trait_type

string

Loading...

imageUrl

string

Loading...

collectionAddress

string

Loading...

chain

string

Loading...

network

string

Loading...

description

string

Loading...

totalItems

integer

Loading...

totalPages

integer

Loading...

pageNumber

integer

Loading...

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_fetchNFTs",
6
  "params": [
7
    {
8
      "wallet": "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
9
      "contracts": [
10
        "0x2106c00ac7da0a3430ae667879139e832307aeaa",
11
        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
12
      ],
13
      "page": 1,
14
      "perPage": 10,
15
      "omitFields": [
16
        "traits"
17
      ]
18
    }
19
  ],
20
  "id": 1
21
}'

1
curl -X POST "https://docs-demo.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "qn_fetchNFTs",
6
  "params": [
7
    {
8
      "wallet": "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
9
      "contracts": [
10
        "0x2106c00ac7da0a3430ae667879139e832307aeaa",
11
        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
12
      ],
13
      "page": 1,
14
      "perPage": 10,
15
      "omitFields": [
16
        "traits"
17
      ]
18
    }
19
  ],
20
  "id": 1
21
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_fetchNFTs',
4
    params: [{"wallet":"0x91b51c173a4bdaa1a60e234fc3f705a16d228740","contracts":["0x2106c00ac7da0a3430ae667879139e832307aeaa","0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"],"page":1,"perPage":10,"omitFields":["traits"]}],
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_fetchNFTs',
4
    params: [{"wallet":"0x91b51c173a4bdaa1a60e234fc3f705a16d228740","contracts":["0x2106c00ac7da0a3430ae667879139e832307aeaa","0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"],"page":1,"perPage":10,"omitFields":["traits"]}],
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_fetchNFTs",
9
  "params": [
10
    {
11
      "wallet": "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
12
      "contracts": [
13
        "0x2106c00ac7da0a3430ae667879139e832307aeaa",
14
        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
15
      ],
16
      "page": 1,
17
      "perPage": 10,
18
      "omitFields": [
19
        "traits"
20
      ]
21
    }
22
  ],
23
  "id": 1
24
})
25
headers = {
26
  'Content-Type': 'application/json'
27
}
28

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

31
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_fetchNFTs",
9
  "params": [
10
    {
11
      "wallet": "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
12
      "contracts": [
13
        "0x2106c00ac7da0a3430ae667879139e832307aeaa",
14
        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
15
      ],
16
      "page": 1,
17
      "perPage": 10,
18
      "omitFields": [
19
        "traits"
20
      ]
21
    }
22
  ],
23
  "id": 1
24
})
25
headers = {
26
  'Content-Type': 'application/json'
27
}
28

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

31
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_fetchNFTs",
11
  params: [{"wallet":"0x91b51c173a4bdaa1a60e234fc3f705a16d228740","contracts":["0x2106c00ac7da0a3430ae667879139e832307aeaa","0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"],"page":1,"perPage":10,"omitFields":["traits"]}]
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_fetchNFTs",
11
  params: [{"wallet":"0x91b51c173a4bdaa1a60e234fc3f705a16d228740","contracts":["0x2106c00ac7da0a3430ae667879139e832307aeaa","0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"],"page":1,"perPage":10,"omitFields":["traits"]}]
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
    "owner": "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
6
    "ensName": null,
7
    "assets": [
8
      {
9
        "collectionName": "Loopy Donuts",
10
        "collectionTokenId": "1747",
11
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
12
        "name": "Loopy Donut #1747",
13
        "description": "",
14
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/1747.png",
15
        "chain": "ETH",
16
        "network": "MAINNET"
17
      },
18
      {
19
        "collectionName": "Loopy Donuts",
20
        "collectionTokenId": "1971",
21
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
22
        "name": "Loopy Donut #1971",
23
        "description": "",
24
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/1971.png",
25
        "chain": "ETH",
26
        "network": "MAINNET"
27
      },
28
      {
29
        "collectionName": "Loopy Donuts",
30
        "collectionTokenId": "2979",
31
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
32
        "name": "Loopy Donut #2979",
33
        "description": "",
34
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/2979.png",
35
        "chain": "ETH",
36
        "network": "MAINNET"
37
      },
38
      {
39
        "collectionName": "Loopy Donuts",
40
        "collectionTokenId": "3432",
41
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
42
        "name": "Loopy Donut #3432",
43
        "description": "",
44
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/3432.png",
45
        "chain": "ETH",
46
        "network": "MAINNET"
47
      },
48
      {
49
        "collectionName": "Loopy Donuts",
50
        "collectionTokenId": "3643",
51
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
52
        "name": "Loopy Donut #3643",
53
        "description": "",
54
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/3643.png",
55
        "chain": "ETH",
56
        "network": "MAINNET"
57
      },
58
      {
59
        "collectionName": "Loopy Donuts",
60
        "collectionTokenId": "3854",
61
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
62
        "name": "Loopy Donut #3854",
63
        "description": "",
64
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/3854.png",
65
        "chain": "ETH",
66
        "network": "MAINNET"
67
      },
68
      {
69
        "collectionName": "Loopy Donuts",
70
        "collectionTokenId": "4592",
71
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
72
        "name": "Loopy Donut #4592",
73
        "description": "",
74
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/4592.png",
75
        "chain": "ETH",
76
        "network": "MAINNET"
77
      },
78
      {
79
        "collectionName": "Loopy Donuts",
80
        "collectionTokenId": "4878",
81
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
82
        "name": "Loopy Donut #4878",
83
        "description": "",
84
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/4878.png",
85
        "chain": "ETH",
86
        "network": "MAINNET"
87
      },
88
      {
89
        "collectionName": "Loopy Donuts",
90
        "collectionTokenId": "5585",
91
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
92
        "name": "Loopy Donut #5585",
93
        "description": "",
94
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/5585.png",
95
        "chain": "ETH",
96
        "network": "MAINNET"
97
      },
98
      {
99
        "collectionName": "Loopy Donuts",
100
        "collectionTokenId": "6652",
101
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
102
        "name": "Loopy Donut #6652",
103
        "description": "",
104
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/6652.png",
105
        "chain": "ETH",
106
        "network": "MAINNET"
107
      }
108
    ],
109
    "totalPages": 2,
110
    "totalItems": 18,
111
    "pageNumber": 1
112
  }
113
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "owner": "0x91b51c173a4bdaa1a60e234fc3f705a16d228740",
6
    "ensName": null,
7
    "assets": [
8
      {
9
        "collectionName": "Loopy Donuts",
10
        "collectionTokenId": "1747",
11
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
12
        "name": "Loopy Donut #1747",
13
        "description": "",
14
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/1747.png",
15
        "chain": "ETH",
16
        "network": "MAINNET"
17
      },
18
      {
19
        "collectionName": "Loopy Donuts",
20
        "collectionTokenId": "1971",
21
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
22
        "name": "Loopy Donut #1971",
23
        "description": "",
24
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/1971.png",
25
        "chain": "ETH",
26
        "network": "MAINNET"
27
      },
28
      {
29
        "collectionName": "Loopy Donuts",
30
        "collectionTokenId": "2979",
31
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
32
        "name": "Loopy Donut #2979",
33
        "description": "",
34
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/2979.png",
35
        "chain": "ETH",
36
        "network": "MAINNET"
37
      },
38
      {
39
        "collectionName": "Loopy Donuts",
40
        "collectionTokenId": "3432",
41
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
42
        "name": "Loopy Donut #3432",
43
        "description": "",
44
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/3432.png",
45
        "chain": "ETH",
46
        "network": "MAINNET"
47
      },
48
      {
49
        "collectionName": "Loopy Donuts",
50
        "collectionTokenId": "3643",
51
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
52
        "name": "Loopy Donut #3643",
53
        "description": "",
54
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/3643.png",
55
        "chain": "ETH",
56
        "network": "MAINNET"
57
      },
58
      {
59
        "collectionName": "Loopy Donuts",
60
        "collectionTokenId": "3854",
61
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
62
        "name": "Loopy Donut #3854",
63
        "description": "",
64
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/3854.png",
65
        "chain": "ETH",
66
        "network": "MAINNET"
67
      },
68
      {
69
        "collectionName": "Loopy Donuts",
70
        "collectionTokenId": "4592",
71
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
72
        "name": "Loopy Donut #4592",
73
        "description": "",
74
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/4592.png",
75
        "chain": "ETH",
76
        "network": "MAINNET"
77
      },
78
      {
79
        "collectionName": "Loopy Donuts",
80
        "collectionTokenId": "4878",
81
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
82
        "name": "Loopy Donut #4878",
83
        "description": "",
84
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/4878.png",
85
        "chain": "ETH",
86
        "network": "MAINNET"
87
      },
88
      {
89
        "collectionName": "Loopy Donuts",
90
        "collectionTokenId": "5585",
91
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
92
        "name": "Loopy Donut #5585",
93
        "description": "",
94
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/5585.png",
95
        "chain": "ETH",
96
        "network": "MAINNET"
97
      },
98
      {
99
        "collectionName": "Loopy Donuts",
100
        "collectionTokenId": "6652",
101
        "collectionAddress": "0x2106c00ac7da0a3430ae667879139e832307aeaa",
102
        "name": "Loopy Donut #6652",
103
        "description": "",
104
        "imageUrl": "https://quicknode-content.quicknode-ipfs.com/ipfs/QmSNmVFTJv6cG9M8ZRU8T9F4Kz9HHxmV85ssGP5W8ZsTPa/6652.png",
105
        "chain": "ETH",
106
        "network": "MAINNET"
107
      }
108
    ],
109
    "totalPages": 2,
110
    "totalItems": 18,
111
    "pageNumber": 1
112
  }
113
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free