Query Parameters

address

array

REQUIRED

Sale or auction contract address in any form. Max: 1000.

Returns

nft_sales

array

The array of NFT sales and auctions

address

string

The blockchain address of the sale or auction contract

type

string

The type of sale (e.g., getgems_sale)

nft_address

string

The blockchain address of the NFT being sold

nft_owner_address

string

The blockchain address of the NFT owner

marketplace_address

string

The blockchain address of the marketplace contract

created_at

integer

The Unix timestamp when the sale was created

last_transaction_lt

string

The logical time of the last transaction involving this sale

code_hash

string

The hash of the sale contract's smart contract code

data_hash

string

The hash of the sale contract's data in the blockchain

details

object

The sale details including pricing and fee information

is_complete

boolean

The indicator if the sale has been completed

full_price

string

The full price of the NFT in nanotons

marketplace_fee_address

string

The blockchain address to receive the marketplace fee

marketplace_fee

string

The marketplace fee amount in nanotons

royalty_address

string

The blockchain address to receive royalty payments

royalty_amount

string

The royalty amount in nanotons

nft_item

object

The detailed information about the NFT item being sold

address

string

The blockchain address of the NFT item

init

boolean

The indicator if the item has been initialized

index

string

The index of the item within its collection

collection_address

string

The blockchain address of the NFT collection contract

owner_address

string

The blockchain address of the NFT item owner

content

object

The content metadata of the NFT item

uri

string

The URI pointing to the item metadata

last_transaction_lt

string

The logical time of the last transaction involving this item

code_hash

string

The hash of the item's smart contract code

data_hash

string

The hash of the item's data in the blockchain

collection

object

The detailed information about the collection this NFT belongs to

address

string

The blockchain address of the collection contract

owner_address

string

The blockchain address of the collection owner

last_transaction_lt

string

The logical time of the last transaction involving this collection

next_item_index

string

The index value for the next item to be minted in the collection

collection_content

object

The content metadata of the collection

uri

string

The URI pointing to the collection metadata

data_hash

string

The hash of the collection's data in the blockchain

code_hash

string

The hash of the collection's smart contract code

on_sale

boolean

The indicator if the NFT item is currently on sale

address_book

object

The mapping of blockchain addresses to their human-readable forms

<dynamic_key>

object

The blockchain address as a key

user_friendly

string

The human-readable form of the blockchain address

domain

string

The domain name associated with the address

interfaces

array

The list of interfaces implemented by the address

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>

object

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

nft_index

string

The index of the NFT item within its collection

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/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl' \
2
--header 'accept: application/json'
3

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl' \
2
--header 'accept: application/json'
3

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/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl", requestOptions)
11

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/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl", requestOptions)
11

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl"
4

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

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

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl"
4

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

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

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

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl")
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)
11

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

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/nft/sales?address=EQA2glKDbvezR0KZstAqNmHLEpkOHId1RYAGwza06XLCOLTl")
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)
11

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free