📖 User Guide

New to NXTN Bot? Start here.

🚀 Getting Started

1
Open the bot
Search @nxtn_bot on Telegram or click the link, then start a chat.
2
Connect a wallet
After /start choose custodial (bot stores encrypted key) or self-custody (TON Connect).
3
DeFi in plain language
Just say "Swap 10 TON for USDT". The AI finds the best route and executes.

📱 Telegram Mini App

Open the Mini App from the bot menu to manage portfolio, swaps, and orders inside Telegram.

📊 Portfolio
Balances, positions, PnL chart, share card.
🔄 Swap
Quick swap with slippage presets.
📋 Orders
DCA, limit, and stop-loss orders.
🔔 Alerts
Create and cancel price alerts.
💼 Wallet
Addresses and TON Connect.
⚙️ Settings
Language, slippage, accumulation mode.

📥 Depositing Funds (/deposit)

  1. Use /wallet to view and copy your wallet address.
  2. Withdraw from an exchange on the correct network:
    • TON — Upbit, Bithumb, Binance — TON network
    • ETH / Base / BNB / Polygon / Arbitrum — native coin for that chain; network must match
    • SOL — withdraw SOL on Solana network
  3. Assets on another chain? Use /bridge to move them (Orbiter ~2 min).
  4. After depositing, ask the AI e.g. "What's my ETH balance?"

⚠️ Always test with a small amount first. Type /deposit in the bot for full instructions.

📋 Command Reference

Live—works directly
AI Chat—ask AI in natural language
Coming Soon—planned for future
General
/startOpen the main menu. Runs onboarding for new users.
/helpShow help topics with inline buttons.
/clearReset AI conversation history and exit any active flow.
/langSwitch language: /lang en or /lang ko
/chainsList all supported chains, protocols and tokens.
Wallet
/walletWallet management menu (create, import, TON Connect).
/balanceAsk the AI for your balances, e.g. "Show my TON balance".
/depositShow deposit instructions for all chains.
Portfolio
/portfolioAI-powered portfolio overview with positions and value.
/positionsShow active DeFi positions with PnL and APY.
/historyShow last 15 transactions (/history 30 for more).
DeFi
/swapType naturally: "Swap 10 TON for USDT" to execute via AI agent.
/stakeAI shows tsTON / hTON / stTON staking options with live APY.
/vaultsAI lists available strategy vaults with APY and risk level.
/bridgeType "Bridge 0.1 ETH to Base" to initiate a cross-chain bridge.
/rebalanceAsk AI to suggest a rebalancing plan for your portfolio.
Auto-orders
/dca/dca <from> <to> <amount> <hours> — Create a DCA order.
/limit/limit <from> <to> <amount> <price> [above|below] — Limit order.
/ordersList and cancel active DCA / limit / stop-loss orders.
Alerts
/alert/alert <symbol> <price> [above|below] — Set a price alert.
/alertsList and cancel price alerts.
Settings
/settingsConfigure slippage, notifications, and accumulation strategy.
/paperShow current paper trading mode status.

💬 Natural Language Examples

No commands needed — just describe what you want and the AI handles the rest.

Swap
“Swap 10 TON for USDT”
Swap
“Swap ETH to ARB on Arbitrum with 1% slippage”
Staking
“What is the tsTON staking APY?”
Lending
“Supply 500 USDC to Aave on Base”
Bridge
“Bridge 0.05 ETH from Ethereum to Base”
Portfolio
“Show all my balances and positions”
Alert
“Alert me when TON goes above $10”
Nexton
“Stake 5 TON on Nexton”
Nexton
“Show my Nexton positions and earnings”
DCA
“Auto-buy 10 TON worth of USDT every day”

🔐 Security Notes

  • Custodial mode: private keys are encrypted with AES-256-GCM and stored server-side. The master key is managed via environment variable.
  • TON Connect mode: no private key is stored. Each transaction requires signing in your wallet app.
  • Every transaction shows amount, fees, and slippage for explicit confirmation before execution.
  • Admin commands (/arb, /status, /broadcast) are only accessible to users listed in BOT_ADMIN_IDS.

❓ FAQ

▶ /start does not respond.

Type /clear to reset any stuck conversation, then try again. If it still fails, check that the bot server is running.

▶ My transaction is stuck in PENDING.

The TX confirm worker is waiting for on-chain confirmation. Check that Redis is running.

▶ What is paper trading mode?

When PAPER_MODE=true, all transactions are simulated — no real funds are moved. Use it to test without risk.

▶ EVM chain swaps are not working.

Make sure ONEINCH_API_KEY and the relevant *_RPC_URL variables are set correctly.