Gift

Telegram collectible gift by its public name: NFT, owner, collection, sale or auction, and Fragment's display name and attributes.

Request. name in any of these forms: lootbag-6207 (canonical), Loot Bag #6207, LootBag-6207, https://t.me/nft/LootBag-6207, nft.fragment.com/gift/lootbag-6207.webp.

Response. name (Loot Bag #6207), collection_name, number and attributes (Model, Backdrop, Symbol) come from Fragment's metadata and are empty when Fragment does not answer; the chain part is unaffected. Fragment publishes no rarity.

Status and price. status is available (exists, not listed), sale (fixed price — sale object), auction (auction object) or unavailable (no such item, or taken down — HTTP 200, every other field empty). Prices are in whole TON unless sale.currency names a jetton. While the NFT sits in a sale or auction contract, owner_address is the real owner (the seller), not the contract. A contract that can no longer sell (sale complete, never initialised, auction ended without a bid) is not a listing: the item is available.

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

Code	When
`failed_precondition` (412)	`name` missing or out of range
`unavailable` (503)	the public TON liteservers could not serve the read — retry in a second or two

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "address": "UQB1eXCOorUJHTbCaOdLRJf2Ab5aGx5QlttF6Lxz9U5nDo4N",
    "attributes": [
        {
            "trait_type": "Model",
            "value": "Jaune Poussin"
        },
        {
            "trait_type": "Backdrop",
            "value": "Dark Lilac"
        },
        {
            "trait_type": "Symbol",
            "value": "Worker Ant"
        }
    ],
    "collection_address": "UQCE80Aln8YfldnQLwWMvOfloLGgmPY0eGDJz9ufG3gRunAG",
    "collection_name": "Loot Bags",
    "image": "https://nft.fragment.com/gift/lootbag-6207.webp",
    "name": "Loot Bag #6207",
    "number": 6207,
    "owner_address": "UQCrcBPFat5RdyfwkqoPKOJ5eoW38fLPcK_FUb0VVpJJuDTQ",
    "sale": {
        "price": 208
    },
    "status": "sale",
    "uri": "https://nft.fragment.com/gift/lootbag-6207.json"
}

Request

Request Code Samples

Responses