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

# nft/items | TON v3

> The nft/items endpoint retrieves a list of NFT (Non-Fungible Token) items from the TON blockchain. Use it on TON v3 via Chainstack.

The `nft/items` endpoint retrieves a list of NFT (Non-Fungible Token) items from the TON blockchain. This endpoint allows you to fetch information about individual NFT items and provides options for pagination.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## Parameters

* `address` (array of strings, optional) — NFT item address in any form. Max: 1000.
* `owner_address` (array of strings, optional) — Address of NFT item owner in any form. Max: 1000.
* `collection_address` (array of strings, optional) — Collection address in any form.
* `index` (array of strings, optional) — Index of item for given collection. Max: 1000.
* `sort_by_last_transaction_lt` (boolean, optional) — Sort NFT items by last transaction lt descending. **Warning:** results may be inconsistent during pagination with limit and offset.
* `limit` (integer, optional) — The maximum number of NFT items to return. Default: `10`.
* `offset` (integer, optional) — The number of NFT items to skip before starting to return results. Default: `0`.

## Response

* `nft_items` (array) — An array of NFT item objects, each containing:
  * `address` (string) — The address of the NFT item.
  * `auction_contract_address` (string) — The address of the auction contract, if applicable.
  * `code_hash` (string) — The code hash of the NFT item.
  * `collection` (object) — Information about the collection this item belongs to:
    * `address` (string) — The address of the collection.
    * `code_hash` (string) — The code hash of the collection.
    * `collection_content` (object) — The content/metadata of the collection.
    * `data_hash` (string) — The data hash of the collection.
    * `last_transaction_lt` (string) — The logical time of the last transaction.
    * `next_item_index` (string) — The index of the next item in the collection.
    * `owner_address` (string) — The address of the collection owner.
  * `collection_address` (string) — The address of the collection.
  * `content` (object) — The content of the NFT item.
  * `data_hash` (string) — The data hash of the NFT item.
  * `index` (string) — The index of the NFT item within its collection.
  * `init` (boolean) — Whether the NFT item is initialized.
  * `last_transaction_lt` (string) — The logical time of the last transaction.
  * `on_sale` (boolean) — Whether the NFT item is on sale.
  * `owner_address` (string) — The address of the current owner.
  * `real_owner` (string) — The address of the real owner (if different from owner\_address, e.g. when on sale).
  * `sale_contract_address` (string) — The address of the sale contract, if applicable.
* `address_book` (object) — Address book information.
* `metadata` (object) — Metadata information.

## Use case

The `nft/items` endpoint is useful for various applications that need to interact with or display information about individual NFT items on the TON blockchain:

1. NFT marketplaces can use this to list available NFTs for browsing or trading.
2. Wallet applications can display NFT items owned by a user or allow users to explore popular NFTs.
3. Analytics platforms can gather data on NFT items, such as ownership distribution, rarity, and metadata patterns.
4. Developers can use this endpoint to integrate NFT item information into their dApps or games.
5. Collectors can verify the on-chain status and details of their owned NFTs.
6. Artists and creators can check the current status and ownership of their minted NFTs.


## OpenAPI

````yaml openapi/ton_node_api/v3/getNFTItems.json GET /nft/items
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /nft/items:
    get:
      tags:
        - NFT
      summary: Get NFT Items
      description: Retrieves a list of NFT items from the TON blockchain
      operationId: getNFTItems
      parameters:
        - name: address
          in: query
          description: 'NFT item address in any form. Max: 1000.'
          required: false
          schema:
            type: array
            items:
              type: string
        - name: owner_address
          in: query
          description: 'Address of NFT item owner in any form. Max: 1000.'
          required: false
          schema:
            type: array
            items:
              type: string
        - name: collection_address
          in: query
          description: Collection address in any form
          required: false
          schema:
            type: array
            items:
              type: string
        - name: index
          in: query
          description: 'Index of item for given collection. Max: 1000.'
          required: false
          schema:
            type: array
            items:
              type: string
        - name: sort_by_last_transaction_lt
          in: query
          description: >-
            Sort NFT items by last transaction lt descending. Warning: results
            may be inconsistent during pagination with limit and offset.
          required: false
          schema:
            type: boolean
        - name: limit
          in: query
          description: The maximum number of NFT items to return
          required: false
          schema:
            type: integer
            default: 10
        - name: offset
          in: query
          description: The number of NFT items to skip before starting to return results
          required: false
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  nft_items:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                        auction_contract_address:
                          type: string
                        code_hash:
                          type: string
                        collection:
                          type: object
                          properties:
                            address:
                              type: string
                            code_hash:
                              type: string
                            collection_content:
                              type: object
                              additionalProperties: {}
                            data_hash:
                              type: string
                            last_transaction_lt:
                              type: string
                            next_item_index:
                              type: string
                            owner_address:
                              type: string
                        collection_address:
                          type: string
                        content:
                          type: object
                          additionalProperties: {}
                        data_hash:
                          type: string
                        index:
                          type: string
                        init:
                          type: boolean
                        last_transaction_lt:
                          type: string
                        on_sale:
                          type: boolean
                        owner_address:
                          type: string
                        real_owner:
                          type: string
                        sale_contract_address:
                          type: string
                  address_book:
                    type: object
                    additionalProperties: {}
                  metadata:
                    type: object
                    additionalProperties: {}

````