๐Ÿค– Bots


1. Introduction to SwirlBot

SwirlBot lets you:

Bet on sports events: Experience the thrill of predicting outcomes across various sports directly in the BetSwirl's Telegram Bot on the Polygon chain:

  • โšพ Baseball
  • ๐Ÿ€ BasketBall
  • ๐ŸฅŠ Boxing
  • ๐Ÿ Cricket
  • โšฝ Football
  • ๐Ÿ’ Ice Hockey
  • ๐ŸฅŠ MMA
  • ๐Ÿ‰ Rugby Union
  • ๐ŸŽพ Tennis
  • ๐ŸŽฎ E-sport

Play Games: BetSwirl's Bot brings the excitement of our web interface games directly to Telegram:

  • ๐Ÿช™ CoinToss: A simple yet thrilling guess between heads or tails.
  • ๐ŸŽฒ Dice: A dynamic game of predicting dice outcomes.
  • ๐ŸŽฑ Keno: Select up to 4 numbers and see how many match the drawn numbers.
  • ๐ŸŽฐ Roulette: Classic casino game where you bet on numbers, colors, or groups and spin the wheel.

Connect to Telegram SwirlBot:
Access SwirlBot. For a quick start, use the /start command and follow the instructions.
Click the links for more details on how to place sports bets and play games.

2. Smart Accounts

Open the main menu by /menu command and navigate to the "My Smart Wallet" section to view your balance and current wallet chain. You can use the /wallet command for this purpose.

Your Smart Wallet is uniquely generated for your Telegram ID, smart wallet is yours alone, ensuring seamless gaming across various chains. Only you can control and withdraw funds.

Ease & Command: We've introduced individual smart accounts to eliminate the hassle of ERC-20 allowances for each game.

Immediate Play: Activate your smart wallet by depositing at least 0.005 of the native token of your chosen chain into it and start playing. This covers the gas fee for creating your smart wallet in that chain. Each chain requires a separate contract creation, but all will share the same address.

How to Fund Your Wallet: To top up your balance, simply send the desired amount to your SwirlBot Wallet address. You can find your wallet address using the /wallet command.

How to WithDraw: To withdraw funds from your SwirlBot Wallet, use the command: /withdraw <amount> <token> <your external wallet address>.

For example:
/withdraw 100 WETH 0x0000000000000000000000000000000000000000.
!!! Warning: Enter your external wallet address instead of 0x0000000000000000000000000000000000000000.

or use the /withdraw command and follow the instructions.

3. Sports Bettings in Telegram

How to place a bet

  1. Use the /sports command in the chat and follow the instructions:
  2. Choose the Single type using the button (ัombo coming soon).
  3. Select from the available sports categories.
  4. Select a match from the list provided.
  5. Choose the result of the match.
  6. Select the amount you wish to place (only USDT for now).
  7. When ready, click on the pre-built message in your keyboard.

You will receive a confirmation message indicating that your bet has been successfully placed. ๐Ÿ€ Good luck!

How to see betting history

Use /sports_open_bets to view open bets and /sports_bets to check pending bets.

How to redeem my gains

  1. Use the command /sports_bets.
  2. Click on the "Redeem" button located at the end of the message.

Now, your winnings are in your Smart Wallet and can be withdrawn using the /withdraw command.

4. Games

For Each Game, the following rules apply:

  • The randomness is guaranteed by Chainlink VRF, ensuring fair and unbiased outcomes.
  • When placing a bet, your stake plus the cost of randomness (VRF Cost) is deducted.

๐Ÿช™ Coin Toss

Experience the thrill of Coin Toss: Fortune's Game, where your intuition can turn into winnings. Heads or tails, make your selection and see if luck is in your favor.

Winnings are calculated using the formula:
payout = ((bet amount * 2) - house edge) .

๐ŸŽฒ Dice

Roll the 100-sided challenge. Select a number between 1 and 99; the higher your choice, the bigger the potential payout, but the chances drop.

Winnings are calculated using the formula:
payout = ((bet amount * 100) / (100 - cap)) - house edge

๐ŸŽฑ Keno

Dive into the world of Keno: Fortune's Numbers. Select up to 4 numbers out of 15, then watch as 4 numbers are drawn. Your payout is determined by the number of matches between your chosen numbers and the drawn numbers, with each match count having a specific multiplier based on its probability. This means that the less likely the outcome, the higher the potential payout.

Winnings are calculated using the formula:
payout = (bet amount * multiplier) - house edge

  • Where:

    Number of Chosen NumbersNumber of MatchesMultiplier

๐ŸŽฐ Roulette

Experience the elegance and excitement of Roulette: The Classic Casino Game. Place your bets on a single number, various groupings of numbers, the color red or black, whether the number is odd or even, or if the numbers are high (19โ€“36) or low (1โ€“18). Spin the wheel and see where the ball landsโ€”will luck be on your side?

  • Winnings are calculated using the formula:
    payout = ((bet amount * (37 / number of selected numbers)) - house edge)

5. Gameplay Options in Telegram: How to Play Games

Just like on our web platform, you'll need to select the coin side for CoinToss or a dice number for Dice, set your bet amount, and choose a token based on the blockchain network you're currently using.

Gameplay Options in Telegram:

BetSwirl offers two gameplay methods: entering a full game command or using interactive buttons for quick command assembly.

Interactive Buttons Gameplay

For those who prefer a guided approach, simply enter the game's name as a command (e.g., /cointoss, /dice, /keno, /roulette). The bot will then provide a series of interactive buttons to:

  • Select the coin side, dice number, keno or roulette numbers.
  • Choose the betting token from the current network.
  • Set the bet size, offering percentages of 5, 25, 50, 75, and 100% of the allowable betting amount.

After your selections, the bot compiles a game command for you. Clicking this command initiates the game.

Manual Command Entry

For a direct approach, type the game command with your choices. Here's how:

For CoinToss:
/cointoss <heads|tails> <amount> <token>
/cointoss heads 100 ETH

  • cointoss: Game name.
  • heads: Selected coin side.
  • 100: Bet amount.
  • ETH: Chosen token.

For Dice:
/dice <dice side> <amount> <token>
/dice 55 100 ETH

  • dice: Game name.
  • 55: Selected dice number.
  • 100: Bet amount.
  • ETH: Chosen token.

For Keno:
/keno [numbers] <amount> <token>
/keno [1,2,3,4] 100 ETH

  • keno: Game name.
  • [1 2 3 4]: Selected keno number.
  • 100: Bet amount.
  • ETH: Chosen token.

For Roulette:
/roulette [numbers] <amount> <token>
/roulette [1,7,8,14,23,36] 100 ETH

  • roulette: Game name.
  • [1 7 8 14 23 36]: Selected roulette numbers.
  • 100: Bet amount.
  • ETH: Chosen token.

6. Player vs Player Games: CoinTossBattle

๐Ÿช™ Coin Toss Battle

  • To incentivize Hosts, 50% of the house edge generated from each game is allocated to the Host. So, this allocation equates to the Host receiving 1% of the total bet. This setup ensures that the Host is rewarded regardless of the game's outcome, with the casino also retaining 1% of the house edge.
  • The second player's bet matches the first player's bet, contributing equally to the total pot. Winnings are distributed according to the formula:
    payout = (bet amount * 2) - creator payout - house edge = (bet amount * 2) * 98%.

Interactive Buttons Gameplay

How to start a game:

  1. Type the command /cointossbattle.
  2. Choose "Start a new battle."
  3. Select a blockchain.
  4. Choose a side of the coin.
  5. Select the token.
  6. Set the bet amount using the buttons.

A keyboard with a button will appear at the bottom of the screen, and a message will be displayed showing all selected parameters for bet confirmation. On some devices, the keyboard may not automatically open and is presented in a minimized form. You can open it by clicking on the keyboard icon at the bottom right of your chat with the bot. Pressing the button will initiate the game creation.

How to join a game:

  1. Type the command /cointossbattle.
  2. Select "Join the battle."
  3. Choose a blockchain.
  4. View the list of available games.
  5. Use the buttons displayed with each game to make your selection.
  6. Confirm your choice using the keyboard at the bottom of the screen.


As soon as the game is resolved, the winning player and the host can claim their payouts. The winner's payout is claimed automatically. If the second player is also the host, their payout will be processed with the payout of the next game.

How to view your game history:

The Host can view his created games by typing /cointossbattle and selecting "View history."

How to cancel a game:

To cancel a game, type /cointossbattle and select "View History." For games that can be canceled, cancellation buttons labeled with the game number will be displayed. A game can only be canceled by the Host if no opponents have registered yet.

Manual Command Entry

For a direct approach, type the game command with your choices. Here's how:

For Creating
/cointossbattle <Heads|Tails> <amount> <token> <chain>

For Joining:
/cointossbattle join <gameId> <chain>

/cointossbattle Heads 5 MATIC polygon
/cointossbattle join 123 polygon

7. Telegram SwirlBot's Commands

Sports Betting:

  • /sports: Place bets on sports events.
  • /sports_bets: Review your sports betting results and claim your winnings.
  • /sports_open_bets: Check your pending sports bets.

Games Commands:

  • /games: Open games menu.
  • /<game> <side/[numbers]> <amount> <token>: Place a bet by manually entering the command.
  • /cointoss: Play Coin Toss by interactive buttons.
  • /dice: Play Dice by interactive buttons.
  • /keno: Play Keno by interactive buttons.
  • /roulette: Play Roulette by interactive buttons.
  • /cointossbattle: Play Coin Toss Battle by interactive buttons.
  • /games_bets: Check your game results.

Smart Wallet Management:

  • /wallet: Manage your Smart Wallet.
  • /chain: Choose your preferred blockchain network.
  • /withdraw: Withdraw funds from your SwirlBot Wallet by interactive buttons.
  • /withdraw <amount> <token> <your external wallet address>: Withdraw funds from your SwirlBot Wallet by manually entering the command.
  • /refund_vrf: Claim excess VRF funds.

Bot Commands:

  • /start: Launch SwirlBot and view the initial welcome message.
  • /menu: Open the main menu to navigate to various sections.
  • /help: SwirlBot Info & Docs.