Skip to main content
GET
/
nft
/
items
Get NFT Items
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/nft/items
{
  "nft_items": [
    {
      "address": "<string>",
      "auction_contract_address": "<string>",
      "code_hash": "<string>",
      "collection": {
        "address": "<string>",
        "code_hash": "<string>",
        "collection_content": {},
        "data_hash": "<string>",
        "last_transaction_lt": "<string>",
        "next_item_index": "<string>",
        "owner_address": "<string>"
      },
      "collection_address": "<string>",
      "content": {},
      "data_hash": "<string>",
      "index": "<string>",
      "init": true,
      "last_transaction_lt": "<string>",
      "on_sale": true,
      "owner_address": "<string>",
      "real_owner": "<string>",
      "sale_contract_address": "<string>"
    }
  ],
  "address_book": {},
  "metadata": {}
}
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.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
TON pricing is the same for full, archive, v2, v3There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
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.

Query Parameters

​
address
string[]

NFT item address in any form. Max: 1000.

​
owner_address
string[]

Address of NFT item owner in any form. Max: 1000.

​
collection_address
string[]

Collection address in any form

​
index
string[]

Index of item for given collection. Max: 1000.

​
sort_by_last_transaction_lt
boolean

Sort NFT items by last transaction lt descending. Warning: results may be inconsistent during pagination with limit and offset.

​
limit
integer
default:10

The maximum number of NFT items to return

​
offset
integer
default:0

The number of NFT items to skip before starting to return results

Response

200 - application/json

Successful response

​
nft_items
object[]
​
address_book
object
​
metadata
object