qn_fetchNFTsByCollection (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

array

object

collection

string

tokens

string

page

integer

perPage

integer

omitFields

array

Returns

object

collection

tokens

collectionName

collectionAddress

chain

network

collectionTokenId

name

description

traits

value

trait_type

imageUrl

totalPages

pageNumber

totalItems

Request

curl https://docs-demo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_fetchNFTsByCollection",
    "params": [{
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
      "omitFields": [
        "imageUrl",
        "traits"
      ],
      "page": 1,
      "perPage": 10
    }]
  }'

require 'eth'

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

payload = {
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_fetchNFTsByCollection",
    "params": [{
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
      "omitFields": [
        "imageUrl",
        "traits"
      ],
      "page": 1,
      "perPage": 10
    }]
 }

response = client.send(payload.to_json)
puts response

import { ethers } from "ethers";
(async () => {
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
  const heads = await provider.send("qn_fetchNFTsByCollection", [
    {
      collection: "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
      omitFields: ["imageUrl", "traits"],
      page: 1,
      perPage: 10,
    },
  ]);
  console.log(heads);
})();

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

var raw = JSON.stringify({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_fetchNFTsByCollection",
  "params": [{
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
    "omitFields": [
      "imageUrl",
      "traits"
    ],
    "page": 1,
    "perPage": 10
  }]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

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

import requests
import json

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

payload = json.dumps({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_fetchNFTsByCollection",
  "params": [{
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
    "omitFields": [
      "imageUrl",
      "traits"
    ],
    "page": 1,
    "perPage": 10
  }]
})
headers = {
  'Content-Type': 'application/json'
}

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

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_fetchNFTsByCollection",
  "params": [{
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
    "omitFields": [
      "imageUrl",
      "traits"
    ],
    "page": 1,
    "perPage": 10
  }]
})

response = https.request(request)
puts response.read_body

from web3 import Web3, HTTPProvider

w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/'))
resp = w3.provider.make_request('qn_fetchNFTsByCollection', [{
  "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
  "omitFields": [
    "imageUrl",
    "traits"
  ],
  "page": 1,
  "perPage": 10
}])
print(resp)

import { Core } from '@quicknode/sdk'

const core = new Core({
  endpointUrl: "https://docs-demo.quiknode.pro/",
  config: {
    addOns: {
      nftTokenV2: true,
    },
  },
})

core.client
    .qn_fetchNFTsByCollection({
      collection: "0x2106C00Ac7dA0A3430aE667879139E832307AeAa",
    })
    .then(res => console.log(res))

Response

{
  "jsonrpc": "2.0",
  "id": 67,
  "result": {
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
    "tokens": [
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "0",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "1",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "2",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "3",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "4",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "5",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "6",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "7",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "8",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      },
      {
        "collectionName": "MutantApeYachtClub",
        "collectionAddress": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
        "collectionTokenId": "9",
        "description": "",
        "name": "",
        "chain": "ETH",
        "network": "MAINNET"
      }
    ],
    "totalPages": 1956,
    "pageNumber": 1,
    "totalItems": 19551
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

qn_fetchNFTsByCollection (v2) RPC Method - Token and NFT API

Loading...

Parameters

Returns