Query Parameters

owner_address

array

Address of NFT owner in any form. Max 1000.

item_address

array

Address of NFT item in any form. Max: 1000.

collection_address

string

Collection address in any form.

direction

string

Direction of transfer.

start_utime

integer

Query transactions with generation UTC timestamp after given timestamp.

end_utime

integer

Query transactions with generation UTC timestamp before given timestamp.

start_lt

integer

Query transactions with lt >= start_lt.

end_lt

integer

Query transactions with lt <= end_lt.

limit

integer

Limit number of queried rows. Use with offset to batch read.

offset

integer

Skip first N rows. Use with limit to batch read.

sort

string

Sort transactions by lt.

Returns

nft_transfers

array

The array of NFT transfer transactions

query_id

string

The unique identifier for the transfer operation

nft_address

string

The blockchain address of the NFT item being transferred

nft_collection

string

The blockchain address of the collection this NFT belongs to

transaction_hash

string

The hash of the transfer transaction

transaction_lt

string

The logical time of the transfer transaction

transaction_now

integer

The unix timestamp when the transfer transaction was processed

transaction_aborted

boolean

The indicator if the transfer transaction was aborted

old_owner

string

The blockchain address of the previous owner of the NFT

new_owner

string

The blockchain address of the new owner of the NFT

response_destination

string

The address where the transfer confirmation should be sent

custom_payload

string | null

The additional data attached to the transfer operation

forward_amount

string

The amount of TON forwarded with the transfer

forward_payload

string | null

The payload data forwarded with the transfer

trace_id

string

The unique identifier for tracking this transaction across systems

address_book

object

(Optional) The mapping of addresses to their human-readable information

<dynamic_key>

object

The blockchain address as a key

user_friendly

string

The human-readable representation of the blockchain address

domain

string | null

The domain name associated with the address if available

metadata

object

(Optional) The metadata information about the addresses

<dynamic_field>

object

The mapping to address metadata object with dynamic keys

is_indexed

boolean

The indicator if the address is indexed in the system

token_info

array

The collection of token information associated with this address

description

string

The detailed description of the token

extra

object

The additional custom token metadata fields

<dynamic_field>

string | number | array | object | null

The custom property with dynamic key for additional token information

image

string

The URL pointing to the token image or icon

name

string

The full name of the token

symbol

string

The short ticker symbol of the token

type

string

The classification or standard of the token

Request

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk' \
2
--header 'accept: application/json'

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk' \
2
--header 'accept: application/json'

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk", requestOptions)

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk", requestOptions)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

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

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

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

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/transfers?owner_address=0QCaUVddISJFAbWe9mFX8I6wVN-8K0RFH5dSeF4z5Fj3DMnk")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free