Item - apiTON

Any NFT item by its address — gifts, usernames, numbers, domains and ordinary NFTs.

Request. address — the NFT item address, user-friendly or raw (no .ton names).

Response. collection_address, owner_address, uri (off-chain metadata), content, status with sale / auction, and the resolved address, index, name, image — taken from the metadata, else derived for Telegram numbers, usernames, gifts and .ton domains; empty when unknown.

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
`not_found` (404)	the address is not an NFT item, or the account does not exist
`unavailable` (503)	the public TON liteservers could not serve the read — retry in a second or two

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "address": "UQBSUQMVeBwcOXpq_FuTO13Y6KcmEOp3XODV4vsDNwhd6Sw8",
    "collection_address": "UQAo92DYMokxghKcq-CkCGSk_MgXY5Fo1SPW20gkvZl75n1I",
    "index": "198",
    "owner_address": "UQDgBYEMgv4cCqs9pe_oYONhnGA00cY2TNQFWIG3Wyy80NVt",
    "status": "available",
    "uri": "ipfs://bafybeibhklflai76uc2obpcp2wkqoilzntx4hpb6vxl3eqdb4w5jk4yog4/198.json"
}

🔴500Server Error