Getting started
Open the bot inside Telegram. On first /start, you'll be asked to pick a display language. The bot then shows the main menu.
- Tap Wallets → Create to generate a fresh TON wallet (or Import to bring an existing one).
- Copy the wallet address shown and send TON to it.
- Wait a few seconds for the balance to refresh — your wallet is now funded.
- Paste any TON jetton contract address in the chat — the bot opens the trade screen.
Commands
/start— open the main menu (or restart from anywhere).- Paste a jetton address — opens that token's trade screen directly.
- Most navigation happens through inline buttons rather than slash commands.
Wallets
The bot supports multiple TON wallets per user. Each is generated locally, encrypted at rest, and never leaves the host except as a signed transaction blob.
Create
From the main menu: Wallets → Create → choose how many to spawn at once (1–5). Each wallet gets a fresh 24-word mnemonic.
Import
From Wallets → Import, paste a 24-word phrase separated by spaces. Only letters and spaces are accepted.
Reveal mnemonic
Open a wallet detail and tap Show Secret Mnemonics. This message is visible to anyone with access to your Telegram chat — handle with care.
Rename
Tap Edit Name on a wallet. Letters and numbers only. Names are local-only.
Delete
Remove Wallet disables the wallet in the bot. The on-chain account is unaffected — funds remain accessible with the mnemonic.
Buying jettons
Paste a contract address into the chat. The trade screen shows price, FDV, LP value, mintable status and your live position (if any).
- Pick wallets (one or many).
- Tap a quick-amount: 1 ◈ 5 ◈ 10 ◈, or use Custom for an exact value.
- The bot verifies balance, simulates the swap on-chain, applies your slippage, and broadcasts.
- On success, a receipt with explorer links is posted; the screen flips to Sell mode after ~8s for tx propagation.
Selling jettons
From the same trade screen, switch to Sell. Tap a quick-percent (25%, 50%, 75%, 100%) or enter a custom %.
Sells use a single jetton transfer with an embedded swap forward payload — efficient one-tx flow on both Ston.fi and DeDust.
Limit orders
From the trade screen, tap Add Sell Limit. Choose:
- Take Profit — fires when price ≥ target.
- Stop Loss — fires when price ≤ target.
- Trailing Stop — peak-tracking, fires when price drops N% from the running high.
Then enter the amount (% of current jetton balance). Active orders show in Limit Orders from the main menu and can be cancelled any time.
Transfer & distribute
Transfer
Wallets → tap a wallet → Transfer: enter destination, then amount. PIN-protected if enabled.
Distribute
Main menu → Distribute: pick a source wallet, enter total TON, the bot splits evenly across your remaining wallets and broadcasts in 4-recipient batches.
Settings
- Slippage — global swap slippage in % (1–50). Per-trade override available.
- Quick buy/sell amounts — customise the buttons shown on the trade screen.
- Daily cap — hard ceiling on TON spent per UTC day.
- PIN — set / change / disable a numeric PIN that gates transfers and distributions.
- Language — switch among the six supported locales.
Referrals
Open Referrals from the menu. Share your invite link. Every swap an invitee makes credits 30% of the bot's 1% fee to your referral balance. Withdraw once your balance reaches 1 ◈.
Troubleshooting
- "Can't fetch pool data" — the pasted contract isn't a TON jetton with a Ston.fi/DeDust pool, or the pool is too new for both sources. Try again after a minute.
- "Insufficient balance" — leave at least 0.5 TON headroom for gas + fee on buys; sells need ~0.3 TON for gas.
- "Tx not confirmed (timeout)" — network congestion. Check the explorer link for actual outcome before retrying.
- "Daily limit exceeded" — you've hit the configured spend cap; raise it in Settings or wait for the UTC reset.
- Bot is unresponsive — Telegram polling lag;
/startusually unsticks the menu.
Still stuck? Email support@tonsmarttrade.com — include your Telegram username and a brief description of what you tried.
