Setup Guide

How It Works

From adding the bot to announcing your first winner — the full setup takes under 5 minutes.

Add the Bot to Your Group

Search for @tonlott_bot in Telegram and add it to your project's group or channel as an administrator. Admin rights are required so the bot can send messages.

The bot needs at least Send Messages permission to announce transactions and winners in the group.

Configure the Token

Use the /settoken command followed by the TON token's jetton master contract address. You can find this on tonviewer.com or tonscan.org.

EXAMPLE
/settoken EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sds

Set Game Rules

Configure the minimum purchase amount, choose your game mode, and set the session parameters. All settings can be changed between sessions.

SETUP SEQUENCE
/setmin 5
/setmode lastbuyer
/setduration 10
/setextension 3

Start a Session

Run /startsession to begin. The bot will start monitoring the blockchain and announcing every qualifying purchase in the group. When the session ends, the winner is automatically announced.

Sessions can also be configured to start and end automatically on a schedule.

Command Reference

All available admin commands for the TonLoot bot.

/startInitialize and activate the bot in the group

/settoken <address>Set the TON token contract to monitor

/setmin <amount>Set minimum purchase amount in TON

/setmode random|lastbuyerChoose game mode

/setduration <minutes>Set session duration (Random Draw) or initial countdown (Last Buyer)

/setextension <minutes>Set timer extension per purchase (Last Buyer mode only)

/startsessionManually start a new loot round

/stopsessionEnd the current session and draw winner

/statusShow current session status and participants

Common Questions

Which DEXes does the bot monitor?

TonLoot monitors on-chain token transactions, so it detects purchases from any DEX on TON — including STON.fi, DeDust, and others. As long as the wallet receives the configured token, it counts.

How is the winner verified?

All transaction data is read directly from the TON blockchain. The bot stores transaction hashes, so every winner can be independently verified on-chain via tonviewer.com.

Can I run multiple sessions back to back?

Yes. After a session ends and the winner is announced, simply run /startsession again to begin the next round. Settings carry over from the previous session unless changed.

What happens if no purchases are made?

In Random Draw mode, the session expires with no winner. In Last Buyer mode, the countdown runs to zero with no winner if no purchases meet the minimum threshold.

Add TonLoot Bot