Username

Telegram username NFT (fragment.com): owner, NFT address, image and the current sale or auction.

Request. username — 4–128 characters, without the leading @. The NFT is found by the exact string, so send it in the case Telegram uses (lower case).

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)	`username` missing or out of range
`unavailable` (503)	the public TON liteservers could not serve the read — retry in a second or two

application/json

Bodyapplication/json

{
    "address": "UQCatvrMutiEdZwYJMilUX5CLNLCVQ-tbKRv63wEdVxPc31_",
    "image": "https://nft.fragment.com/username/beijing.webp",
    "owner_address": "UQDaRHTxT0W0Rgxpb2qbvZ8sJLjDXcZULWLgOC7LQTkuDOxz",
    "status": "available"
}

Request

Request Code Samples

Responses