apiton brings all of this together. It is a web explorer, a Telegram bot and a public API, and all three run on exactly the same data. This article walks through what each part can do.

For the story of how it is built (a site with no database access, unreliable public liteservers, and why .ton domains can't be listed straight from the chain), read the author's deep dive: "I built a TON explorer where every page is a public API call" on Telegraph (in Russian). An English version is on dev.to.

1. The explorer: what is listed, on auction or expired

apiton.org shows every Telegram-related asset on TON with its status (not listed, for sale, on auction, expired), its price and its history. At the time of writing it tracks:

Useful views include:

• Usernames filtered by length (4, 5 or 6 characters), plus "for sale" and "auctions" lists.
• +888 numbers grouped by series (+888 00…, +888 01… and so on).
• .ton domains that are for sale, on auction, expired, expiring soon or numeric. Expired names are interesting if you want to pick up a domain someone let go.
• Telegram gifts by collection, with the lots currently for sale.
• Market activity: a feed of recent events such as Listed, Delisted, Price changed, Auction started, New bid and Expired.
• Live TON Sites: .ton domains that serve an actual website, with screenshots, ranking and the date each one first went live.

The TON Sites catalogue deserves a closer look. A .ton domain can point to a site through its site DNS record, either an ADNL address or a TON Storage bag. apiton reads that record for every domain, checks the site over RLDP-HTTP or TON Storage, separates placeholders from real pages and takes screenshots. The explorer is itself a TON Site, apiton.ton, which you can open without a TON proxy through the gateway at site.apiton.org/apiton.ton/.

Prices are shown for information only. apiton does not sell any of these items, and nothing on the site is an offer or advice.

2. @apitonBot: cards, watches and alerts in Telegram

@apitonBot is a second client of the same API. You can send it any of these and get back a card:

• a wallet address;
• an @username;
• a +888 number;
• a name.ton domain;
• a link to a gift.

The bot also:

• watches lots and wallets and messages you when something is listed, sold, receives a new bid, or when a wallet gets an incoming transaction;
• sends price alerts and shows a wallet portfolio;
• issues your API key with /get_api;
• replies in Russian to users from CIS countries and in English to everyone else.

Premium speeds up alerts to every 30 seconds and raises the limit to 30 watched items, for 150 Telegram Stars or 1 TON per month.

3. The API: try it with one curl, no key needed

The website has no direct database access. It is a separate Go program that renders every page from the same public API you can call yourself. So every feature you see on the site is also an API method.

The basics:

• The API uses the Connect protocol. Each call is a POST with a JSON body to https://app.apiton.org/v2.<Service>/<Method>. Generated gRPC and gRPC-Web clients work as well.
• Anonymous calls are allowed: 1 request per second and 10,000 per month per IP.
• With a key from the bot (Authorization: Bearer <tg_id>:<secret>) you get your own quota instead of sharing your IP's. The free tier is 1 req/s and 10k/month, builder is 10 req/s and 300k/month, and pro is 100 req/s and 3M/month. Paid tiers are bought in the bot with Telegram Stars or TON.
• Full reference and a playground: docs.apiton.org.

v2.Catalog: search the whole catalogue

Catalog/List filters by kind (username, number, domain, gift), statuses, name_len, digits_only, prefix and an expiry window. It sorts by name, price_asc, price_desc, expires_asc or changed.

# the cheapest .ton domains for sale
curl -s -X POST https://app.apiton.org/v2.Catalog/List \
  -H 'Content-Type: application/json' \
  -d '{"kind":"domain","statuses":["sale"],"sort":"price_asc","limit":2}'

# 4-letter usernames on auction
curl -s -X POST https://app.apiton.org/v2.Catalog/List \
  -H 'Content-Type: application/json' \
  -d '{"kind":"username","statuses":["auction"],"name_len":4}'

# what just sold
curl -s -X POST https://app.apiton.org/v2.Catalog/Events \
  -H 'Content-Type: application/json' \
  -d '{"types":["sold"],"limit":3}'

Catalog/Summary returns the totals by status. Catalog/Events called with a kind and name returns the full history of a single lot: listed, delisted, price changes, sold, bids, expiry and renewal. Each item includes a price_source field that tells you whether the price came from an on-chain sale contract or from a Fragment listing.

v2.Nft: the live state of one item

The catalogue refreshes in the background. To see an item's state right now, the v2.Nft methods read the blockchain, through a 45-second cache.

Every lookup normalises the state to available, sale, auction or unavailable. While an NFT sits in a sale or auction contract, owner_address is the actual seller, not the contract. A dead contract (sale already completed, or an auction that ended without bids) is reported as available, not as a live listing.

curl -s -X POST https://app.apiton.org/v2.Nft/Domain \
  -H 'Content-Type: application/json' \
  -d '{"domain":"apiton.ton"}'

v2.Address: wallets and history

• Transactions returns an address's transactions with decoded operations, comments, and jetton and NFT transfers. It is backed by a historical archive, so it reaches further back than the roughly one month public liteservers keep.
• Details returns the balance, status, detected contract interfaces and decoded on-chain content for jettons, NFTs and DNS items.
• Jettons, NFTs and Collections return what an address holds or administers, with metadata already resolved.
• Wallets takes a public key and lists every deployed wallet version (V1R1 through V5) with its balance. This is handy for finding funds left in an old wallet contract.

v2.Rate: TON and jetton prices

• Fiat and Crypto return the price of 1 TON. TON/USD is the median of exchange quotes that agree within 3%, cross-checked against the on-chain USD₮/TON pool.
• Exchanges returns prices on individual exchanges, refreshed every 15 seconds.
• Jetton prices returns USD prices taken from the deepest STON.fi or DeDust pool.

Custodial wallets, sending and minting

With a key and a wallet token, the API also covers write operations:

• v2.Auth manages up to five custodial wallets per key: create, import from a mnemonic, back up, delete. Its Do method issues a 24-hour JWT for one wallet.
• v2.Wallet sends TON, jettons or NFTs.
• v2.NftContract mints collections and NFTs with fully on-chain content.
• v2.JettonContract mints a jetton and handles burn, change owner and close mint.

A note on security: custodial means apiton holds the keys. That is convenient for bots, payouts and testing. Keep balances small, and think twice before importing the mnemonic of a wallet that holds real funds.

Good to know about the JSON

Responses are proto3 JSON, which can surprise anyone used to hand-written REST APIs:

• int64 values arrive as strings, for example "total": "28734".
• Zero values are omitted. An empty result is {}.
• Errors come in a Connect envelope with a real HTTP status. invalid_argument is HTTP 400. resource_exhausted is HTTP 429, meaning you hit the rate limit. unavailable means TON liteservers are lagging, so retry in a second or two.
• Every response carries the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.

For AI assistants

apiton.org/llms.txt is a Markdown map of the site, the API and the bot, written for language models. Give it to your assistant or agent. Then a question like "what's the cheapest 5-letter username for sale right now?" gets answered with a real API call instead of a guess.

What you can build with it

• Name snipers. Poll Catalog/List for expired .ton domains or newly listed usernames, or let the bot watch them for you.
• Market analytics on gift collections, +888 series or username lengths, using Catalog/Events.
• Portfolio dashboards that combine Address holdings with Rate prices.
• Telegram bots and Mini Apps that accept TON, pay rewards or mint NFTs without running your own node. apiton also publishes a fullscreen Mini App game template on GitHub.
• Wallet recovery helpers that scan every wallet version for a public key.

Getting started

1. Browse the explorer at apiton.org.
2. Run one of the curl commands above. No key is needed.
3. Open @apitonBot to watch items and get an API key with /get_api.
4. Read the reference at docs.apiton.org and the deep dive on Telegraph or dev.to.
5. Follow news on @apiton.

Missing a method? Send /feedback to the bot.

Statistics are as of October 2026. Prices and listings are informational and not financial advice.