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:

contracts

array

REQUIRED

An array with the list of NFT contract addresses you'd like to get collection details data from. You may include up to 10 contract addresses per request

Returns

object

object | null

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

name

object

The name of this collection

address

object

The checked contract address

description

object

The description of this NFT collection

erc721

object

Boolean (true,false)

erc1155

object

Boolean (true,false)

genesisBlock

object

The block in which this contract was deployed

genesisTransaction

object

The hash of the transaction in which this contract was deployed

totalSupply

object

The total supply of the collection

circulatingSupply

object

The circulating supply of the collection

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_fetchNFTCollectionDetails",
6
  "params": [
7
    {
8
      "contracts": [
9
        "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
10
        "0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7"
11
      ]
12
    }
13
  ],
14
  "id": 1
15
}'

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_fetchNFTCollectionDetails',
4
    params: [{"contracts":["0x60E4d786628Fea6478F785A6d7e704777c86a7c6","0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7"]}],
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_fetchNFTCollectionDetails',
4
    params: [{"contracts":["0x60E4d786628Fea6478F785A6d7e704777c86a7c6","0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7"]}],
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(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"qn_fetchNFTCollectionDetails\",\"params\":[{\"contracts\":[\"0x60E4d786628Fea6478F785A6d7e704777c86a7c6\",\"0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7\"]}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

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

13
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"qn_fetchNFTCollectionDetails\",\"params\":[{\"contracts\":[\"0x60E4d786628Fea6478F785A6d7e704777c86a7c6\",\"0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7\"]}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

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

13
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_fetchNFTCollectionDetails",
11
  params: [{"contracts":["0x60E4d786628Fea6478F785A6d7e704777c86a7c6","0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7"]}]
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_fetchNFTCollectionDetails",
11
  params: [{"contracts":["0x60E4d786628Fea6478F785A6d7e704777c86a7c6","0x7Bd29408f11D2bFC23c34f18275bBf23bB716Bc7"]}]
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
    {
6
      "name": "Meebits",
7
      "address": "0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7",
8
      "description": "Meebits",
9
      "erc1155": false,
10
      "erc721": true,
11
      "totalSupply": 20000,
12
      "circulatingSupply": 19948,
13
      "genesisBlock": 12358080,
14
      "genesisTransaction": "0xf2040b9b67193fe8c861a18cff864b9f35c1f69cc8734c724c388c449a1116c4"
15
    },
16
    {
17
      "name": "MutantApeYachtClub",
18
      "address": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
19
      "description": "MutantApeYachtClub",
20
      "erc1155": false,
21
      "erc721": true,
22
      "totalSupply": 19486,
23
      "circulatingSupply": 19384,
24
      "genesisBlock": 13117018,
25
      "genesisTransaction": "0x025f185262da3c52bf9b87f09a1fea815a27fd8c32a363da72cac0c9cae27436"
26
    }
27
  ]
28
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": [
5
    {
6
      "name": "Meebits",
7
      "address": "0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7",
8
      "description": "Meebits",
9
      "erc1155": false,
10
      "erc721": true,
11
      "totalSupply": 20000,
12
      "circulatingSupply": 19948,
13
      "genesisBlock": 12358080,
14
      "genesisTransaction": "0xf2040b9b67193fe8c861a18cff864b9f35c1f69cc8734c724c388c449a1116c4"
15
    },
16
    {
17
      "name": "MutantApeYachtClub",
18
      "address": "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
19
      "description": "MutantApeYachtClub",
20
      "erc1155": false,
21
      "erc721": true,
22
      "totalSupply": 19486,
23
      "circulatingSupply": 19384,
24
      "genesisBlock": 13117018,
25
      "genesisTransaction": "0x025f185262da3c52bf9b87f09a1fea815a27fd8c32a363da72cac0c9cae27436"
26
    }
27
  ]
28
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free