Please note that this RPC method requires the Token and NFT API v2 bundle add-on enabled on your Quicknode endpoint.

Parameters

object

object

REQUIRED

The custom object with the following fields:

collection

string

REQUIRED

The contract address of the NFT collection

collectionTokenId

string

REQUIRED

The Token ID of this NFT under this collection

page

integer

The page number you would like returned. The 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 transfers 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

object | null

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

collection

string

The contract address we checked for NFTs

transfers

array

An array of transfers representing NFTs with the following shape:

date

string

The date when this transaction was mined

from

string

The address for the sender of this transaction

to

string

The address for the receiver of this transaction

blockNumber

number

The block number this transaction was included in

txHash

string

The token transfer transaction hash

totalPages

number

The total number of results pages available

pageNumber

number

The page number of results that was 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_getTransfersByNFT",
6
  "params": [
7
    {
8
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
9
      "collectionTokenId": "1",
10
      "page": 1,
11
      "perPage": 10
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_getTransfersByNFT",
6
  "params": [
7
    {
8
      "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
9
      "collectionTokenId": "1",
10
      "page": 1,
11
      "perPage": 10
12
    }
13
  ],
14
  "id": 1
15
}'

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

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

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

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

25
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_getTransfersByNFT",
11
  params: [{"collection":"0x60E4d786628Fea6478F785A6d7e704777c86a7c6","collectionTokenId":"1","page":1,"perPage":10}]
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_getTransfersByNFT",
11
  params: [{"collection":"0x60E4d786628Fea6478F785A6d7e704777c86a7c6","collectionTokenId":"1","page":1,"perPage":10}]
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
    "transfers": [
7
      {
8
        "blockNumber": 13117220,
9
        "date": "2021-08-29T00:42:17.000Z",
10
        "from": "0x0000000000000000000000000000000000000000",
11
        "to": "0x791bf322bc5e20360d27a2d27e4cc5a0790d329f",
12
        "txHash": "0x33ca60f747363e7f85a2d35c3ca8ab0bf05185de16b5fee12b62996f51066fe4"
13
      },
14
      {
15
        "blockNumber": 13149960,
16
        "date": "2021-09-03T02:03:48.000Z",
17
        "from": "0x791bf322bc5e20360d27a2d27e4cc5a0790d329f",
18
        "to": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
19
        "txHash": "0x46250b9b4c55d88ba057f26262c206ebb3f21feb17f2811a15d16bfd9017cfd7"
20
      },
21
      {
22
        "blockNumber": 13248857,
23
        "date": "2021-09-18T09:31:05.000Z",
24
        "from": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
25
        "to": "0xfdbfcee097fb7fe8ffb2fcad88bd3cb0498b1da5",
26
        "txHash": "0xf24b2a526b22295a82f2a34b38a036eccb940e6b4908a035a5cc93439e7e80ac"
27
      },
28
      {
29
        "blockNumber": 13786941,
30
        "date": "2021-12-11T23:49:56.000Z",
31
        "from": "0xfdbfcee097fb7fe8ffb2fcad88bd3cb0498b1da5",
32
        "to": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
33
        "txHash": "0x468de64812001b53423d15d21366305de94089bac7681e1044a7296e7fd126af"
34
      },
35
      {
36
        "blockNumber": 14926083,
37
        "date": "2022-06-08T09:59:28.000Z",
38
        "from": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
39
        "to": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
40
        "txHash": "0xaab28d27b845c4eb7f9e0a95e18521e47e96b3823edb47b24c9b04c0edf803b0"
41
      },
42
      {
43
        "blockNumber": 14941505,
44
        "date": "2022-06-11T01:03:40.000Z",
45
        "from": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
46
        "to": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
47
        "txHash": "0xe0bea9da688c56127423cddc1c49b706c3c392a7dd246ccbad2ca012a5f6a6d1"
48
      },
49
      {
50
        "blockNumber": 15967660,
51
        "date": "2022-11-14T10:25:11.000Z",
52
        "from": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
53
        "to": "0xaa87190076675da8d3496da24b0c3bbfa1e56396",
54
        "txHash": "0xfe7a0a805233b0d6a873caf1c4de215cb7d97cab3725269095229c1ad6763720"
55
      }
56
    ],
57
    "totalPages": 1,
58
    "pageNumber": 1,
59
    "totalItems": 7
60
  }
61
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "collection": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
6
    "transfers": [
7
      {
8
        "blockNumber": 13117220,
9
        "date": "2021-08-29T00:42:17.000Z",
10
        "from": "0x0000000000000000000000000000000000000000",
11
        "to": "0x791bf322bc5e20360d27a2d27e4cc5a0790d329f",
12
        "txHash": "0x33ca60f747363e7f85a2d35c3ca8ab0bf05185de16b5fee12b62996f51066fe4"
13
      },
14
      {
15
        "blockNumber": 13149960,
16
        "date": "2021-09-03T02:03:48.000Z",
17
        "from": "0x791bf322bc5e20360d27a2d27e4cc5a0790d329f",
18
        "to": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
19
        "txHash": "0x46250b9b4c55d88ba057f26262c206ebb3f21feb17f2811a15d16bfd9017cfd7"
20
      },
21
      {
22
        "blockNumber": 13248857,
23
        "date": "2021-09-18T09:31:05.000Z",
24
        "from": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
25
        "to": "0xfdbfcee097fb7fe8ffb2fcad88bd3cb0498b1da5",
26
        "txHash": "0xf24b2a526b22295a82f2a34b38a036eccb940e6b4908a035a5cc93439e7e80ac"
27
      },
28
      {
29
        "blockNumber": 13786941,
30
        "date": "2021-12-11T23:49:56.000Z",
31
        "from": "0xfdbfcee097fb7fe8ffb2fcad88bd3cb0498b1da5",
32
        "to": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
33
        "txHash": "0x468de64812001b53423d15d21366305de94089bac7681e1044a7296e7fd126af"
34
      },
35
      {
36
        "blockNumber": 14926083,
37
        "date": "2022-06-08T09:59:28.000Z",
38
        "from": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
39
        "to": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
40
        "txHash": "0xaab28d27b845c4eb7f9e0a95e18521e47e96b3823edb47b24c9b04c0edf803b0"
41
      },
42
      {
43
        "blockNumber": 14941505,
44
        "date": "2022-06-11T01:03:40.000Z",
45
        "from": "0x194cc2541ea8696957acdcf1dc3dd5a687bb5ca5",
46
        "to": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
47
        "txHash": "0xe0bea9da688c56127423cddc1c49b706c3c392a7dd246ccbad2ca012a5f6a6d1"
48
      },
49
      {
50
        "blockNumber": 15967660,
51
        "date": "2022-11-14T10:25:11.000Z",
52
        "from": "0x465092bbe4ca9675c1cf9c7bf2620b2eefc77e25",
53
        "to": "0xaa87190076675da8d3496da24b0c3bbfa1e56396",
54
        "txHash": "0xfe7a0a805233b0d6a873caf1c4de215cb7d97cab3725269095229c1ad6763720"
55
      }
56
    ],
57
    "totalPages": 1,
58
    "pageNumber": 1,
59
    "totalItems": 7
60
  }
61
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free