Telegram Mini Apps: how they work on TON (2026)

Telegram Mini Apps are a separate category of applications that run directly inside the messenger, and they became the key crypto onboarding channel in 2024–2026. This piece covers what they are technically, how they connect to TON, what their economic models look like, and why they took off at all.

What a mini-app is, plainly

A mini-app is a web page that Telegram opens inside a chat via a button. From outside it looks like a regular app with its own UI, buttons, animations. Inside it is a regular HTML/CSS/JavaScript site loaded into a WebView with extra Telegram API.

The key difference from old bots is that a mini-app has its own UI, free of chat constraints. You can build anything — a tap-to-earn clicker, a DEX aggregator, a messenger inside the messenger, a movie-search service.

In 2026 mini-apps mean:

• 500M+ users monthly across the TON ecosystem;
• 650+ dApps in the TON catalogue and thousands of non-blockchain mini-apps;
• built-in monetisation via Telegram Stars and TON payments;
• single sign-on via initData without logins or passwords.

How a mini-app works under the hood

When the user taps the launch button, Telegram:

1. Opens a WebView (WKWebView on iOS, WebView on Android, embedded Chromium on desktop).
2. Passes the mini-app a signed initData object with user info — id, name, language, Telegram theme.
3. Injects a window.Telegram.WebApp JS object with messenger API.

Through that API a mini-app can:

• read the user theme (light/dark) and adapt the UI;
• open primary and secondary buttons in the native bottom Telegram bar;
• request a Stars payment in one line of code;
• open invoices for TON payments via TON Connect;
• close and minimise the app, share results into chat.

initData is signed with an HMAC key derived from the bot token — meaning the mini-app server can verify the user’s identity without a separate login. In effect Telegram became an OAuth provider for thousands of apps.

The TON blockchain link

Technically a mini-app does not have to be on-chain — most apps live without a blockchain at all. But if a developer wants on-chain features (payments, NFTs, tokens, staking), they integrate TON Connect 2.0.

TON Connect is the protocol linking the mini-app to the user’s wallet. It works like this:

1. The mini-app shows a QR code or deep link describing the connection.
2. The user opens their wallet (Tonkeeper, MyTonWallet etc.) and confirms.
3. After that the mini-app can send transaction-signing requests; the user confirms each one manually.

Important: TON Connect does not pass the mini-app private keys. Every transaction is signed locally in the wallet. Drainers only work if the user signs a malicious transaction themselves — i.e. human error, not a protocol hole.

Timeline: how mini-apps took off

September 2022. Telegram announced Web Apps 2.0 — improved API for embedded apps. Before that, mini-apps existed but without full native integration.

December 2023. Launch of Notcoin — a basic clicker mini-app. By May 2024 it had 35M+ users and a Binance listing. The first time a tap clicker turned into a real token with a billion-dollar cap.

Summer 2024. The era of Hamster Kombat — peak audience around 300M users in a few months. Telegram for the first time felt like the world’s largest gaming platform by reach.

Late 2024 — early 2025. The hype collapsed. Many projects lost 90%+ of users and value after token events. Hamster Kombat fell from 300M to 12–13M MAU.

2025–2026. The “second generation” — Catizen, Blum, MRKT, serious DEX mini-apps (STON.fi, DeDust). Less tapping, more real products: NFT marketplaces, swaps, education services.

In 2025 Telegram mandated all crypto mini-apps to migrate to TON. That filtered out lower-quality projects and made the ecosystem more coherent.

Mini-app categories in 2026

Roughly five buckets.

Games. Tap-to-earn, idle clickers, arcades. After 2024 the niche shrank sharply, but Catizen, Blum, TapSwap, X Empire and DOGS remain notable. Details — in the tap games guide.

DeFi and wallets. Tonkeeper, MyTonWallet, STON.fi and DeDust have full mini-apps. You can swap tokens, stake, lend — all inside Telegram. The most “mature” segment compared to games.

NFT and collectibles. Telegram username auctions, MRKT for trading digital gifts, Goodies for collecting. After the 2025-2026 NFT-gifts launch the niche grew, volumes hit $34M+.

Messengers inside a messenger. Tribute, Notes, mini-Discord analogues. Use Telegram as auth platform on top of their own logic.

E-commerce and services. From food delivery to bookmakers. Telegram becomes a mobile OS, a WeChat analogue.

Monetisation

Developers earn via three channels.

1. Telegram Stars. Telegram’s internal currency. Bought via App Store / Google Play (~30% platform fee) or directly via Fragment (no fee). One Star is roughly $0.013–0.019 depending on purchase route. The developer accepts Stars in one API line, then converts to TON via Fragment with ~30% fee and 2–3% spread.

2. TON payments via TON Connect. Direct TON or USDT-jetton receipts to the project wallet. Fee — only the network fee (cents). Downside — the user needs an external wallet, not every user is ready to set one up.

3. Advertising. AdSense analogues (Adsgram, Onclicka), banners, video ads in exchange for in-game currency. Low eCPM due to audience specifics, but with millions of MAU it becomes a meaningful flow.

Real risks for users

Open tech, open to attackers. Things to know:

• Fake clones. Scam botnets mass-copy the UI of Notcoin, Hamster Kombat, DOGS and offer “extra airdrop” via wallet connect. In late 2024 Telegram logged a 2000% rise in such bots. Never connect the main wallet to an unfamiliar mini-app.
• Drain transactions. The most dangerous signature is transferOwnership or set_jetton_wallet. If an app asks you to sign something with an unclear description, cancel.
• Background keylogger. Not in regular mini-apps, but in installed “native” extensions distributed via scam channels — yes.

Basic hygiene:

1. One main wallet (e.g. Tonkeeper with Ledger) — never connect to mini-apps.
2. One hot wallet with $50–100 — for all mini-apps and dApps.
3. All links — only from official project channels or your wallet’s whitelisted catalogue (Tonkeeper and MyTonWallet maintain whitelists).

Full security guide — see the anti-scam piece.

What is next

The 2026–2027 outlook — mini-apps move from “hype toys” to full consumer services. Trends already visible:

• Payment hubs. Apple Pay and Google Pay integrate with Stars pipelines, removing the main barrier for mass audience.
• L2 for mini-apps. Catizen Chain and analogues move toward Layer 2 over TON with near-zero fees for microtransactions.
• AI inside apps. GPT-grade chatbots embed as assistants. That changes the UX of gaming, education and e-commerce.
• Regulatory pressure. EU and U.S. start scrutinising Telegram’s crypto features. Jurisdictional blocks are possible for individual mini-apps.

Telegram is the only mass platform with a default-on blockchain, and mini-apps are becoming the consumer-Web3 standard for many markets.

Sources

• docs.ton.org / Mini Apps — TON technical docs.
• Telegram Bot API — Web Apps — official Telegram spec.
• propellerads.com — mini-apps 2025 report — audience and monetisation stats.
• theblock.co — MRKT marketplace — example NFT mini-app.