GET
/
nft
/
items
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/nft/items
{
  "items": [
    {
      "address": "<string>",
      "collection": {
        "address": "<string>",
        "name": "<string>"
      },
      "index": 123,
      "owner": {
        "address": "<string>"
      },
      "metadata": {},
      "verified": true,
      "content_uri": "<string>",
      "raw_content_uri": "<string>"
    }
  ]
}

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 today

Start 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, v3

There’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

  • limit (integer, optional) — The maximum number of NFT items to return. Default: 128.
  • offset (integer, optional) — The number of NFT items to skip before starting to return results. Default: 0.

​
Response

  • items (array) — An array of NFT item objects, each containing:
    • address (string) — The address of the NFT item.
    • collection (object) — Information about the collection this item belongs to:
      • address (string) — The address of the collection.
      • name (string) — The name of the collection.
    • index (integer) — The index of the NFT item within its collection.
    • owner (object) — Information about the current owner of the NFT item:
      • address (string) — The address of the current owner.
    • metadata (object) — Additional metadata of the NFT item.
    • verified (boolean) — Whether the NFT item is verified.
    • content_uri (string) — The URI of the NFT item’s content.
    • raw_content_uri (string) — The raw URI of the NFT item’s content.

​
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

​
limit
integer
default:128

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
​
items
object[]