Quickstart
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
π’ 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
/setuponly changes the active token CAMaster 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
Send BNB to your master wallet address (shown in panel)
Tap π° Fund β bot checks master balance first
BNB is distributed equally across sub-wallets
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, thengetTokenInfo()for full detailsFallback: Buy probe simulation via
eth_callif factory call failsTrading: Uses HuksFunSwapRouter's
buyTokens()/sellTokens()functionsFee: 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:
Flap.sh β bonding curve (highest priority for new launches)
HuksFun β Infinity CL pools
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:
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
/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
/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
/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
/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)
/set)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
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_walletsMaster wallet isolation β sub-wallets are separate from your main funds
Self-hosted β you run the bot on your own server
Technical Stack
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
