boltQuickstart

Flap Trading Bot Documentation

Multi-wallet DEX volume generation, market making, and browser visits β€” powered by a Telegram bot.


Overview

Flap Trading Bot is a Telegram-based trading bot for BSC (BNB Smart Chain) that automates volume generation, market making, and chart visits across multiple DEXes. It auto-detects whether your token trades on PancakeSwap, Flap.sh, or HuksFun and executes trades through the correct router β€” all from inline Telegram buttons.

Key Highlights

  • No private key required β€” bot generates and manages wallets for you

  • One-step setup β€” paste a token CA and start trading

  • Persistent wallets β€” master + sub-wallets stay the same across token switches

  • Auto DEX detection β€” PancakeSwap V2/V3, Flap.sh, HuksFun Infinity

  • Inline trade panel β€” buy, sell, burst, toggle bots without leaving the chat

  • Multi-user SaaS β€” subscription tiers with usage limits and 3% trade fees


Getting Started

Step 1: Start the Bot

Open the bot on Telegram and send /setup.

Step 2: Paste Token CA

Send your token's contract address. The bot will:

  • Auto-detect which DEX the token is on

  • Generate a master wallet + sub-wallets (first time only)

  • Display your master wallet address for funding

Step 3: Fund Your Wallet

Send BNB to the master wallet address shown. Then tap πŸ’° Fund to distribute BNB to sub-wallets.

Step 4: Trade

Use the inline Trade Panel to:

  • Quick buy/sell with preset or custom amounts

  • Run burst trades (3x, 5x, 10x rapid trades)

  • Toggle auto bots (Volume, Maker, Browser)


Trade Panel

The Trade Panel is the main interface. It shows live on-chain balances and provides inline buttons for all actions.

Panel Layout

Button Reference

Button
Action

🟒 0.01

Buy with 0.01 BNB across sub-wallets

🟒 X

Enter a custom buy amount

πŸ”΄ 50%

Sell 50% of tokens in sub-wallets

πŸ”΄ X

Enter a custom sell percentage

🎲 Burst 5x

Execute 5 rapid random buy/sell trades

βœ… 5%

Set slippage to 5% (βœ… = active)

πŸ“ˆ Vol 🟒

Toggle Volume Bot (🟒 = running, βšͺ = off)

🏭 Mkr βšͺ

Toggle Maker Bot

🌐 Brw βšͺ

Toggle Browser Bot

▢️ Start All

Start all bots at once

⏹ Stop All

Stop all running bots

πŸ’° Fund

Distribute BNB from master to sub-wallets

πŸ’³ Wallets

View wallet balances

πŸ“₯ Export

Download wallet keys as backup

✏️ Amounts

Set custom buy preset amounts

πŸ”€ New Token

Switch to a different token

πŸ’Ž Tiers

View subscription plans

Persistent Dashboard

The panel automatically re-appears after every action (buy, sell, bot toggle, fund, etc.). It never disappears after a trade succeeds or fails.


Wallet System

Auto-Generated Wallets

When you first run /setup, the bot generates:

  • 1 Master Wallet β€” holds your main BNB, funds sub-wallets, receives claims

  • N Sub-Wallets β€” execute trades (number depends on your tier)

No private key is required from you. The bot creates and stores keys securely.

Wallet Persistence

Wallets are created once and reused forever:

  • Switching tokens via /setup only changes the active token CA

  • Master wallet address stays the same β€” fund it once

  • Sub-wallets keep their BNB and any tokens across switches

  • If you hold old tokens, sell them before or after switching

Funding Flow

  1. Send BNB to your master wallet address (shown in panel)

  2. Tap πŸ’° Fund β€” bot checks master balance first

  3. BNB is distributed equally across sub-wallets

  4. If master is empty, bot shows the deposit address instead of getting stuck

Claiming

Tap πŸ“₯ Claim or send /claim to sweep all BNB from sub-wallets back to master.

Export

Tap πŸ“₯ Export to get a text file with all wallet addresses and private keys for backup.


Auto Trading Bots

Volume Bot

Automated buy/sell loop that generates trading volume.

  • Executes trades at randomized intervals (configurable min/max delay)

  • Randomized amounts with weighted distribution (favors smaller trades)

  • Configurable buy/sell ratio (default 55% buys)

  • Uses multiple sub-wallets in rotation

  • Respects daily volume limits per tier

Toggle: Tap πŸ“ˆ Vol on the panel or send /start_volume

Maker Bot

Multi-wallet activity generator that creates realistic trading patterns.

  • Trades from different wallets in varied patterns

  • Creates the appearance of multiple independent traders

  • Configurable number of maker wallets (up to tier limit)

Toggle: Tap 🏭 Mkr on the panel or send /start_maker

Browser Bot

Simulated chart/page visits using headless browsers.

  • Visits token pages on DEX tracking platforms

  • Rotates through proxy servers to generate unique IPs

  • Configurable visit frequency and targets

Toggle: Tap 🌐 Brw on the panel or send /start_browser


Supported DEXes

The bot auto-detects which DEX your token is on when you paste the CA.

PancakeSwap V2 & V3

Standard AMM trading on BSC's largest DEX.

  • V2: Pair-based AMM with constant product formula

  • V3: Concentrated liquidity pools with tick-based pricing

  • Multi-quote detection: Automatically finds USDT, USDC, or BUSD pairs

  • Multi-hop routing: BNB β†’ USDT β†’ Token when no direct BNB pair exists

Flap.sh (Bonding Curve)

Tokens launched via Flap.sh bonding curve protocol.

  • Detection: Checks VaultPortal contract for token registration

  • Tax handling: Auto-detects buy/sell tax rates via TaxTokenHelper

  • Vault verification: Shows if vault is official or unverified

  • Trading: Uses Flap.sh router with bonding curve math

HuksFun (PancakeSwap Infinity)

Tokens launched via HuksFun launchpad on PancakeSwap Infinity CL pools.

  • Detection: Checks factory.tokenIndex() for token existence, then getTokenInfo() for full details

  • Fallback: Buy probe simulation via eth_call if factory call fails

  • Trading: Uses HuksFunSwapRouter's buyTokens() / sellTokens() functions

  • Fee: 1% protocol fee + 1% LP fee (set by factory constants)

  • Gas: 500K gas limit (CL swaps via Vault.lock() need more than standard V2)

Detection Priority

When detecting a token's DEX, the bot checks in this order:

  1. Flap.sh β€” bonding curve (highest priority for new launches)

  2. HuksFun β€” Infinity CL pools

  3. PancakeSwap V2/V3 β€” standard DEX (fallback)

Override with: /set dex_mode flap, /set dex_mode huksfun, /set dex_mode dex, or /set dex_mode auto


Slippage Settings

Set slippage directly from the Trade Panel's slippage row:

Setting
Use Case

1%

Stable, high-liquidity tokens

3%

Standard tokens

5%

Default β€” works for most tokens

10%

Tax tokens or low liquidity

20%

High-tax tokens or volatile launches

The active setting shows βœ… on the panel. You can also set it via /set slippage 15.


Commands Reference

Trading

Command
Description

/start

Open the Trade Panel

/trade

Open the Trade Panel (alias)

/setup

Configure token (or switch to new token)

/detect

Manual DEX detection for current token

Wallets

Command
Description

/wallets

Dashboard with live on-chain balances

/balance

Quick balance check

/fund [amount]

Fund sub-wallets from master

/claim

Sweep all funds back to master

/add_wallets <count>

Add more sub-wallets

/export_wallets

Download wallet backup

Bot Control

Command
Description

/start_volume

Start Volume Bot

/start_maker

Start Maker Bot

/start_browser

Start Browser Bot

/start_all

Start all bots

/stop_all

Stop all bots

Settings

Command
Description

/set <key> <value>

Change a setting

/tiers

View subscription plans

/subscribe <tier>

Subscribe to a tier

/status

View stats and fees

/trades

Trade history

/notifications

Toggle trade alerts

Configurable Settings (/set)

Key
Default
Description

slippage

5

Slippage tolerance (%)

min_amount

0.001

Min trade amount (BNB)

max_amount

0.02

Max trade amount (BNB)

buy_ratio

0.55

Buy vs sell ratio (0-1)

min_delay

2

Min delay between trades (seconds)

max_delay

15

Max delay between trades (seconds)

workers

2

Volume bot worker threads

dex_mode

auto

DEX selection: auto, flap, huksfun, dex


Subscription Tiers

Feature
Free
Starter
Pro
Enterprise

Sub-wallets

5

10

25

100

Volume workers

1

2

5

10

Maker wallets

5

10

25

50

Volume Bot

βœ…

βœ…

βœ…

βœ…

Maker Bot

❌

βœ…

βœ…

βœ…

Browser Bot

❌

❌

βœ…

βœ…

Daily trades

50

200

1000

Unlimited

Trade fee

3%

3%

3%

3%


Performance

Balance Checking

The bot uses batch JSON-RPC calls to check on-chain balances efficiently:

  • 50 wallet balances per RPC request (instead of 1 per request)

  • 30-second cache β€” panel loads instantly on repeated opens

  • Fallback to individual calls if batch fails

  • 500 wallets = ~10 RPC calls instead of 500

Trade Execution

  • Trades execute in parallel across sub-wallets

  • Gas estimates are pre-calculated per DEX type

  • Failed trades don't block subsequent trades

  • All results reported back to the Telegram panel


Security

  • No private key paste β€” bot generates wallets automatically

  • Keys stored in local SQLite database β€” not sent to any external server

  • Export anytime β€” download your keys with /export_wallets

  • Master wallet isolation β€” sub-wallets are separate from your main funds

  • Self-hosted β€” you run the bot on your own server


Technical Stack

Component
Technology

Bot framework

python-telegram-bot

Blockchain

Web3.py (EVM)

Database

SQLite

Browser bot

Selenium + undetected-chromedriver

Proxy support

SOCKS5 / HTTP proxy rotation

RPC

BSC public RPC + configurable


Support

For issues or feature requests, contact the admin via Telegram or open an issue on GitHub.

Last updated