Items - apiTON

Items of one NFT collection — a page of the collection, with display metadata resolved by apiton (the same NftItem as Address/Nfts).

Request. collection_address (any form), limit (≤ 100, default 10), offset (≤ 100 000).

Response. result — items with name, description, image, image_medium (resized https preview), lottie (Telegram gifts), domain, collection_name. No status / price here — use Nft/Item for one item.

Paging. total (int64 as a string) is set only when the page reached the end of the list; keep paging by offset until it appears. Items taken down by apiton are left out, so a page can hold fewer than limit items.

Errors (Connect JSON envelope {"code":…,"message":…})

Code	When
`invalid_argument` (400)	the collection address cannot be parsed
`unavailable` (503)	the TON index failed — retry later

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "result": [
        {
            "address": "UQAcoW_B0vxbiLxdZGoz500BoFqjmNi5jA6w2nxwuqD8qJAW",
            "collection_address": "UQBG-g6ahkAUGWpefWbx-D_9sQ8oWbvy6puuq78U2c4NUGyX",
            "collection_name": "Plush Pepes",
            "content": {
                "uri": "https://nft.fragment.com/gift/plushpepe-1330.json"
            },
            "description": "An exclusive Plush Pepe with the appearance Barcelona on a Lemongrass background with Cap icons.",
            "image": "https://nft.fragment.com/gift/plushpepe-1330.webp",
            "image_medium": "https://proxy.toncenter.com/1fxzGj61je2NxEid_KvqGd6ld71KyohLVm0vgk7JDTw/pr:medium/bG9jYWw6Ly8vNWUvYmMvNWViYzE3NjAzYzg0YmMwZTdmYWNkOWU1NjJkZGQ5YmJlZDRiZmMxMGNlZDg4NDA4ZjA2MTYwNzMzZTQ5MGFlYw",
            "index": "33964871158210753738765339842812630335676533977884913060641486274123822381",
            "lottie": "https://nft.fragment.com/gift/plushpepe-1330.lottie.json",
            "name": "Plush Pepe #1330"
        },
        {
            "address": "UQDxdi2yZC-UA1jdlh7zwLEmOhMfTog_9jZMz2gM4cOGiyd2",
            "collection_address": "UQBG-g6ahkAUGWpefWbx-D_9sQ8oWbvy6puuq78U2c4NUGyX",
            "collection_name": "Plush Pepes",
            "content": {
                "uri": "https://nft.fragment.com/gift/plushpepe-2267.json"
            },
            "description": "An exclusive Plush Pepe with the appearance Frozen on a Pure Gold background with Romantic Cake icons. Gifted to Kallen T on 1 December 2024.",
            "image": "https://nft.fragment.com/gift/plushpepe-2267.webp",
            "image_medium": "https://proxy.toncenter.com/tMqdryWMs_GrPaq0qd-Lgb473cf4vWS96KjALZP2RNY/pr:medium/bG9jYWw6Ly8vNjgvNTcvNjg1NzdmYzQ0OGU4NWM3MGIwMWI2MDI1MTU3ZTlhNmI2N2JhYjJjM2RjMTk0MzJkNGNjZWZlZGFmYjIwZmNiMQ",
            "index": "201872238154662634750075446754676218347145577845290182092840306392510928411",
            "lottie": "https://nft.fragment.com/gift/plushpepe-2267.lottie.json",
            "name": "Plush Pepe #2267"
        }
    ]
}

🔴500Server Error