> ## 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" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.