> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dune.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ton.nft_events

> TON NFT events — transfers, sales, and ownership changes.

export const TableSample = ({tableName, tableSchema}) => <>
    <div className="hidden dark:block">
      <iframe src={`https://dune.com/embeds/3419983/5785629?table_schema_t6f0df=${tableSchema}&table_name_t6f0df=${tableName}&darkMode=true`} style={{
  width: '100%',
  height: '500px',
  border: 'none',
  marginTop: '10px'
}} />
    </div>
    <div className="dark:hidden">
      <iframe src={`https://dune.com/embeds/3419983/5785629?table_schema_t6f0df=${tableSchema}&table_name_t6f0df=${tableName}`} style={{
  width: '100%',
  height: '500px',
  border: 'none',
  marginTop: '10px'
}} />
    </div>
  </>;

## Table Description

The `ton.nft_events` table records of all NFT-related events on the TON blockchain, including mints, transfers, and sales. This table is partitioned by block\_date.

## Column Descriptions

| **Column**                    | **Type**      | **Description**                                              |
| ----------------------------- | ------------- | ------------------------------------------------------------ |
| **block\_time**               | timestamp     | Timestamp of when the block containing the event was created |
| **block\_date**               | date          | Date of when the block containing the event was created      |
| **type**                      | string        | Type of NFT event (mint, transfer, sale, etc.)               |
| **nft\_item\_address**        | string        | Address of the NFT item                                      |
| **is\_init**                  | boolean       | Whether the NFT is initialized                               |
| **nft\_item\_index**          | int           | Index of the NFT within its collection                       |
| **collection\_address**       | string        | Address of the NFT collection (nullable)                     |
| **owner\_address**            | string        | Address of the NFT owner                                     |
| **content\_onchain**          | string        | NFT metadata extracted from on-chain data                    |
| **timestamp**                 | int           | Timestamp of NFT state update or action                      |
| **lt**                        | bigint        | Logical time of NFT state update or action                   |
| **tx\_hash**                  | string        | Transaction hash if applicable                               |
| **trace\_id**                 | string        | Trace identifier if applicable                               |
| **prev\_owner**               | string        | Previous owner address if applicable                         |
| **query\_id**                 | decimal(20,0) | Query identifier if exists                                   |
| **forward\_amount**           | decimal(38,0) | Amount of forward message from transfer if related           |
| **forward\_payload**          | binary        | Payload of forward message from transfer if related          |
| **comment**                   | string        | Text comment from forward\_payload                           |
| **custom\_payload**           | string        | Custom payload from transfer message if related              |
| **sale\_contract**            | string        | Address of sale contract if related                          |
| **sale\_type**                | string        | Type of sale (sale or auction)                               |
| **sale\_end\_time**           | int           | End time of sale if applicable (unixtime)                    |
| **marketplace\_address**      | string        | Address of the marketplace                                   |
| **marketplace\_fee\_address** | string        | Address receiving marketplace fee                            |
| **marketplace\_fee**          | decimal(38,0) | Amount of marketplace fee                                    |
| **sale\_price**               | decimal(38,0) | Price of the NFT                                             |
| **payment\_asset**            | string        | Asset type of payment (only TON supported)                   |
| **royalty\_address**          | string        | Address receiving royalty                                    |
| **royalty\_amount**           | decimal(38,0) | Amount of royalty                                            |
| **auction\_max\_bid**         | decimal(38,0) | Maximum bid for auction                                      |
| **auction\_min\_bid**         | decimal(38,0) | Minimum bid for auction                                      |
| **auction\_min\_step**        | decimal(38,0) | Minimum bid step for auction                                 |
| **updated\_at**               | timestamp     | Last time the record was updated                             |
| **ingested\_at**              | timestamp     | Time when the record was ingested                            |

Supported event types:

| Type          | prev\_owner      | Comments                                                                                                  |
| ------------- | ---------------- | --------------------------------------------------------------------------------------------------------- |
| mint          | deployer address | Tx related to the NFT deployment                                                                          |
| put\_on\_sale | null             | NFT is put on sale via sale contract                                                                      |
| cancel\_sale  | null             | Sale is cancelled and NFT is returned to the owner                                                        |
| sale          | seller           | NFT is sold via sale contract, see sale related fields for details                                        |
| transfer      | previous owner   | Direct NFT transfer between addresses. Also includes automatic transfers of TON DNS in case of expiration |
| bid           | bidder           | New bid for an auction                                                                                    |

## Table Sample

<TableSample tableSchema="ton" tableName="nft_events" />