Skip to main content

qn_fetchNFTsByCollection RPC Method

Returns aggregated data on NFTs within a given collection. The API credit value for this method is 4.

Updated on
Jun 9, 2023

qn_fetchNFTsByCollection RPC Method

Please note that this RPC method supports ERC-721 compliant contracts (on Ethereum mainnet). We are in the process of deprecating V1 and strongly encourage all developers to migrate to our NFT and Token API v2 bundle for improved functionalities and broader chain compatibility.

Parameters

object
object
The custom object with the following fields:
collection
string
The contract address of the NFT Collection
tokens
string
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

Returns

object
The custom response object, or null if no NFTs are found:
collection
The contract address we checked for NFTs
tokens
An array of objects representing NFTs with the following shape:
collectionName
The name of this NFT's collection
collectionAddress
The contract address that this NFT lives in
chain
It states on which chain this aggregation happened on
network
It states on which network this aggregation happened on
collectionTokenId
The token id of this NFT in its collection
name
The name of this specific NFT
description
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
totalPages
The total number of results pages available
pageNumber
The page number of results that were returned with this response
totalItems
The total number of results
Request
1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  -H "x-qn-api-version: 1" \
5
  --data '{
6
    "id":67,
7
    "jsonrpc":"2.0",
8
    "method":"qn_fetchNFTsByCollection",
9
    "params":{
10
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
11
      "omitFields": [
12
        "imageUrl",
13
        "traits"
14
      ],
15
      "page": 1,
16
      "perPage": 10
17
    }
18
  }'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free