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

A custom object with the following fields:

collection

string

REQUIRED

The contract address of the NFT Collection

tokens

array

An array of strings that optionally limit the results to specific tokens within a collection. You may submit up to 20 token IDs in this parameter. If you do not want to limit results to specific tokens, please omit this parameter from your request

page

integer

The page number you would like returned. 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 assets 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 NFT tokens to return on each page. You can request up to 100 items per page. If omitted, defaults to 40 items per page

omitFields

array

Optionally omit specific properties of objects from the assets array of the response. Any property of the asset object can be omitted. If omitFields is not included in the request, response will return all available fields by default

Returns

object

object | null

The custom response object, or null if no NFTs are found:

collection

string

The contract address we checked for NFTs

tokens

array

An array of objects representing NFTs with the following shape:

collectionName

string

The name of this NFT's collection

collectionAddress

string

The contract address that this NFT lives in

chain

string

It states on which chain this aggregation happened on

network

string

It states on which network this aggregation happened on

collectionTokenId

string

The token id of this NFT in its collection

name

string

The name of this specific NFT

description

string

The description of this specific NFT

traits

The traits refer to the different attributes of NFTs

value

The specific value associated with each trait of the NFT which can be present in the form of text, numbers, or even images, depending on the type of NFT

trait_type

The type of trait associated with each NFT. It includes attributes like the color, rarity, or any other defining characteristic that sets the NFT apart from others in its collection

imageUrl

The URL where the image for this NFT can be seen

totalPages

number

The total number of results pages available

pageNumber

number

The page number of results that were returned with this response

totalItems

number

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_fetchNFTsByCollection",
6
  "params": [
7
    {
8
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
9
      "page": 1,
10
      "perPage": 10,
11
      "omitFields": [
12
        "imageUrl",
13
        "traits"
14
      ]
15
    }
16
  ],
17
  "id": 1
18
}'

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_fetchNFTsByCollection',
4
    params: [{"collection":"0x60E4d786628Fea6478F785A6d7e704777c86a7c6","page":1,"perPage":10,"omitFields":["imageUrl","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_fetchNFTsByCollection',
4
    params: [{"collection":"0x60E4d786628Fea6478F785A6d7e704777c86a7c6","page":1,"perPage":10,"omitFields":["imageUrl","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_fetchNFTsByCollection",
9
  "params": [
10
    {
11
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
12
      "page": 1,
13
      "perPage": 10,
14
      "omitFields": [
15
        "imageUrl",
16
        "traits"
17
      ]
18
    }
19
  ],
20
  "id": 1
21
})
22
headers = {
23
  'Content-Type': 'application/json'
24
}
25

26
response = requests.request("POST", url, headers=headers, data=payload)
27

28
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_fetchNFTsByCollection",
9
  "params": [
10
    {
11
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
12
      "page": 1,
13
      "perPage": 10,
14
      "omitFields": [
15
        "imageUrl",
16
        "traits"
17
      ]
18
    }
19
  ],
20
  "id": 1
21
})
22
headers = {
23
  'Content-Type': 'application/json'
24
}
25

26
response = requests.request("POST", url, headers=headers, data=payload)
27

28
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_fetchNFTsByCollection",
11
  params: [{"collection":"0x60E4d786628Fea6478F785A6d7e704777c86a7c6","page":1,"perPage":10,"omitFields":["imageUrl","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_fetchNFTsByCollection",
11
  params: [{"collection":"0x60E4d786628Fea6478F785A6d7e704777c86a7c6","page":1,"perPage":10,"omitFields":["imageUrl","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
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
6
    "tokens": [
7
      {
8
        "collectionName": "MutantApeYachtClub",
9
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
10
        "collectionTokenId": "0",
11
        "description": "",
12
        "name": "",
13
        "chain": "ETH",
14
        "network": "MAINNET"
15
      },
16
      {
17
        "collectionName": "MutantApeYachtClub",
18
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
19
        "collectionTokenId": "1",
20
        "description": "",
21
        "name": "",
22
        "chain": "ETH",
23
        "network": "MAINNET"
24
      },
25
      {
26
        "collectionName": "MutantApeYachtClub",
27
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
28
        "collectionTokenId": "2",
29
        "description": "",
30
        "name": "",
31
        "chain": "ETH",
32
        "network": "MAINNET"
33
      },
34
      {
35
        "collectionName": "MutantApeYachtClub",
36
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
37
        "collectionTokenId": "3",
38
        "description": "",
39
        "name": "",
40
        "chain": "ETH",
41
        "network": "MAINNET"
42
      },
43
      {
44
        "collectionName": "MutantApeYachtClub",
45
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
46
        "collectionTokenId": "4",
47
        "description": "",
48
        "name": "",
49
        "chain": "ETH",
50
        "network": "MAINNET"
51
      },
52
      {
53
        "collectionName": "MutantApeYachtClub",
54
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
55
        "collectionTokenId": "5",
56
        "description": "",
57
        "name": "",
58
        "chain": "ETH",
59
        "network": "MAINNET"
60
      },
61
      {
62
        "collectionName": "MutantApeYachtClub",
63
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
64
        "collectionTokenId": "6",
65
        "description": "",
66
        "name": "",
67
        "chain": "ETH",
68
        "network": "MAINNET"
69
      },
70
      {
71
        "collectionName": "MutantApeYachtClub",
72
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
73
        "collectionTokenId": "7",
74
        "description": "",
75
        "name": "",
76
        "chain": "ETH",
77
        "network": "MAINNET"
78
      },
79
      {
80
        "collectionName": "MutantApeYachtClub",
81
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
82
        "collectionTokenId": "8",
83
        "description": "",
84
        "name": "",
85
        "chain": "ETH",
86
        "network": "MAINNET"
87
      },
88
      {
89
        "collectionName": "MutantApeYachtClub",
90
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
91
        "collectionTokenId": "9",
92
        "description": "",
93
        "name": "",
94
        "chain": "ETH",
95
        "network": "MAINNET"
96
      }
97
    ],
98
    "totalPages": 1956,
99
    "pageNumber": 1,
100
    "totalItems": 19551
101
  }
102
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
6
    "tokens": [
7
      {
8
        "collectionName": "MutantApeYachtClub",
9
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
10
        "collectionTokenId": "0",
11
        "description": "",
12
        "name": "",
13
        "chain": "ETH",
14
        "network": "MAINNET"
15
      },
16
      {
17
        "collectionName": "MutantApeYachtClub",
18
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
19
        "collectionTokenId": "1",
20
        "description": "",
21
        "name": "",
22
        "chain": "ETH",
23
        "network": "MAINNET"
24
      },
25
      {
26
        "collectionName": "MutantApeYachtClub",
27
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
28
        "collectionTokenId": "2",
29
        "description": "",
30
        "name": "",
31
        "chain": "ETH",
32
        "network": "MAINNET"
33
      },
34
      {
35
        "collectionName": "MutantApeYachtClub",
36
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
37
        "collectionTokenId": "3",
38
        "description": "",
39
        "name": "",
40
        "chain": "ETH",
41
        "network": "MAINNET"
42
      },
43
      {
44
        "collectionName": "MutantApeYachtClub",
45
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
46
        "collectionTokenId": "4",
47
        "description": "",
48
        "name": "",
49
        "chain": "ETH",
50
        "network": "MAINNET"
51
      },
52
      {
53
        "collectionName": "MutantApeYachtClub",
54
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
55
        "collectionTokenId": "5",
56
        "description": "",
57
        "name": "",
58
        "chain": "ETH",
59
        "network": "MAINNET"
60
      },
61
      {
62
        "collectionName": "MutantApeYachtClub",
63
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
64
        "collectionTokenId": "6",
65
        "description": "",
66
        "name": "",
67
        "chain": "ETH",
68
        "network": "MAINNET"
69
      },
70
      {
71
        "collectionName": "MutantApeYachtClub",
72
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
73
        "collectionTokenId": "7",
74
        "description": "",
75
        "name": "",
76
        "chain": "ETH",
77
        "network": "MAINNET"
78
      },
79
      {
80
        "collectionName": "MutantApeYachtClub",
81
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
82
        "collectionTokenId": "8",
83
        "description": "",
84
        "name": "",
85
        "chain": "ETH",
86
        "network": "MAINNET"
87
      },
88
      {
89
        "collectionName": "MutantApeYachtClub",
90
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
91
        "collectionTokenId": "9",
92
        "description": "",
93
        "name": "",
94
        "chain": "ETH",
95
        "network": "MAINNET"
96
      }
97
    ],
98
    "totalPages": 1956,
99
    "pageNumber": 1,
100
    "totalItems": 19551
101
  }
102
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free