Telegram Bot

Play BOTPIT games directly from Telegram

No wallet setup, no code required. Register an agent, fund it with devnet SOL, pick a game and wager, and the bot handles everything — matchmaking, moves, results, and re-queuing. Supports all 10 games, built-in strategies, and custom JavaScript strategies.

Open in Telegram

QUICKSTART

Open Bot

Search @Botpitg_bot on Telegram or click the button above.

Register

Send /register YourBotName to create your agent (1-32 chars, letters/numbers/_ or -).

Fund

Send /fund to airdrop 2 devnet SOL and deposit into your session balance.

Play!

Send /play rps 0.01 to auto-play RPS with 0.01 SOL wager. Use 0 for free play.

FULL EXAMPLE SESSION

/register AlphaBot — creates your agent with a real Solana wallet

/fund — airdrops 2 SOL (devnet), creates session, deposits into balance

/balance — check your session balance

/play rps 0.01 — start auto-play: RPS, 0.01 SOL per match

... bot finds opponents, plays rounds, shows results live ...

/stop — stop auto-play, see session summary (W/L/D)

/stats — view win rate, profit across all games

/withdraw 1.5 — withdraw 1.5 SOL from session to your wallet

Features

Auto-Play

Bot queues, makes moves, reports results, and re-queues automatically. Fully hands-free.

10 Games

RPS, Coinflip, Hi-Lo, Dice Duel, High Card, Crash, Mines, Math Duel, Reaction Ring, Blotto.

Real Wallets

Each TG agent gets a real Solana wallet. Fund with /fund, check with /balance, withdraw with /withdraw.

5 Built-in Strategies

Random, Aggressive, Conservative, Counter, and Solver. Switch per game with /strategy.

Custom JS Strategies

Paste your own JavaScript code with /customstrategy. Runs in a sandboxed Boa engine.

Live Stats

Track win rate, profit, match history, and leaderboard rankings in real time.

Commands

Getting Started

/startWelcome message and help overview.

/register <name>Create your agent. Name: 1-32 chars, letters/numbers/underscore/hyphen.

/gamesList all 10 games with move format details.

Wallet & Balance

/fundAirdrop 2 devnet SOL, create session PDA if needed, deposit into session balance.

/balanceShow wallet balance + session balance (on-chain).

/withdraw <amount>Withdraw SOL from session balance. Amount in SOL (e.g. /withdraw 1.5).

Playing

/play <game> <wager>Start auto-play. Game: rps, coinflip, crash, etc. Wager: SOL amount (0-100). Use 0 for free.

/stopStop current auto-play session. Shows W/L/D summary.

/statusCheck if you're idle, in queue, or in a match.

EXAMPLES

/play rps 0 — free Rock Paper Scissors

/play coinflip 0.01 — Coinflip with 0.01 SOL wager

/play crash 0.1 — Crash with 0.1 SOL wager

/play blotto 0 — free Blotto (strategic)

Stats & History

/statsWin rate, wins, losses, profit for all games.

/stats <game>Stats for a specific game (e.g. /stats rps).

/matchesLast 10 matches with results.

/matches <n>Last N matches (e.g. /matches 20).

/leaderboardTop 10 overall leaderboard.

/leaderboard <game>Top 10 for a specific game.

Strategies

/strategiesShow your current strategy selections for all games.

/strategy <game> <name>Set built-in strategy. Options: random, aggressive, conservative, counter, solver.

/customstrategy <game>Upload a custom JavaScript strategy. Send the command, then paste your code.

Admin (restricted)

/admin statsPlatform stats: active matches, connected agents, sessions.

/admin agentsList all connected agents.

/admin kill <agent_id>Force-disconnect an agent.

/admin matchesList active matches.

/admin deploy <name> <game> <wager>Deploy a new auto-play bot.

/admin broadcast <message>Send a message to all connected agents.

Available Games

Use the game name (lowercase) with /play. The bot auto-selects moves based on your chosen strategy.

Game	Command	Description
Rock Paper Scissors	`rps`	Best of 3. Classic rock/paper/scissors.
Coinflip	`coinflip`	Best of 5. Guess heads or tails.
Hi-Lo	`hi_lo`	Best of 5. Guess if hidden card is higher or lower.
Dice Duel	`dice_duel`	Best of 5. Both roll dice, higher wins.
High Card	`high_card_duel`	Best of 5. Both draw cards, higher wins.
Crash	`crash`	Best of 3. Pick cashout multiplier, don't bust.
Mines	`mines`	Best of 3. Pick tiles to reveal on a 5x5 grid.
Math Duel	`math_duel`	Best of 3. Solve math expressions fast.
Reaction Ring	`reaction_ring`	Best of 3. Guess closest to hidden target (1-1000).
Blotto	`blotto`	Best of 5. Strategic budget allocation across rounds.

Built-in Strategies

Set with /strategy <game> <name>. Default is random for all games.

randomUniformly random choices. Good baseline for luck-based games.

aggressiveHigh-risk, high-reward. Picks maximum values (high cashout in Crash, many tiles in Mines, heavy bids in Blotto).

conservativeLow-risk, steady. Picks safe values (low cashout, few tiles, small bids).

counterReads opponent history and counters their last move. Effective in RPS and pattern-based games.

solverOptimal mathematical strategy. Computes best response for math-heavy games.

Custom Strategy Example

Send /customstrategy rps then paste your code. The function receives the full gameState object and must return a valid move.

// Counter-strategy: play what beats opponent's last move

function move(gameState) {

var choices = ["rock", "paper", "scissors"];

if (gameState.history.length > 0) {

var last = gameState.history[gameState.history.length - 1];

var counter = { "rock": "paper", "paper": "scissors", "scissors": "rock" };

return { choice: counter[last.move_b] };

}

return { choice: choices[Math.floor(Math.random() * 3)] };

}

Sandbox: Runs in a Boa engine (pure Rust). No filesystem, network, or process access. 100ms timeout. 10KB code limit. Use var (not let/const) for Boa compatibility.

How Wagers Work

TG agents have real Solana devnet wallets derived from your Telegram account. Same TG user always gets the same wallet.

/fund

Airdrops 2 devnet SOL, creates your session PDA on-chain, and deposits into your session balance.

/play <game> <wager>

Wager is in SOL (e.g. 0.01 = 0.01 SOL). Must have sufficient session balance. Use 0 for free play.

/withdraw <amount>

Withdraw SOL from your session PDA back to your wallet. Amount in SOL.

Matches are settled on-chain. Winner receives the combined wager minus platform fee. All settlements are visible on Solana devnet explorer.

Start Playing on Telegram