Skip to main content
GET
/
api
/
v3
/
nft
/
sales
Get NFT Sales and Auctions
curl --request GET \
  --url https://toncenter.com/api/v3/nft/sales
{
  "address_book": {},
  "metadata": {},
  "nft_sales": [
    {
      "address": "<string>",
      "code_hash": "<string>",
      "created_at": 123,
      "data_hash": "<string>",
      "details": "<unknown>",
      "last_transaction_lt": "0",
      "marketplace_address": "<string>",
      "nft_address": "<string>",
      "nft_item": {
        "address": "<string>",
        "auction_contract_address": "<string>",
        "code_hash": "<string>",
        "collection": {
          "address": "<string>",
          "code_hash": "<string>",
          "collection_content": {},
          "data_hash": "<string>",
          "last_transaction_lt": "0",
          "next_item_index": "<string>",
          "owner_address": "<string>"
        },
        "collection_address": "<string>",
        "content": {},
        "data_hash": "<string>",
        "index": "<string>",
        "init": true,
        "last_transaction_lt": "0",
        "on_sale": true,
        "owner_address": "<string>",
        "real_owner": "<string>",
        "sale_contract_address": "<string>"
      },
      "nft_owner_address": "<string>",
      "type": "<string>"
    }
  ]
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

ADDRESS = ["EQAMrsze7MaG_7P2ENd1eeT-S2VttJ1myT9sX5f-F1gY7xGx"]


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v3.nfts.get_nft_sales(
            address=ADDRESS,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

​
address
string[]
required

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

Response

OK

​
address_book
object
​
metadata
object
​
nft_sales
object[]