Group Buy Alerts

5. Group Buy Alerts

Industry-Leading Buy Detection Technology - Our proprietary block-by-block scanning catches 30% more buys than competitors by monitoring every single block across all supported chains.

Forum/Topics Support

• Full topic support for Telegram supergroups with forums enabled

• Add tokens to specific topics - alerts appear in the same topic

• Manage multiple tokens across different topics in one group

• Private Mode - Admins can manage group tokens from private chat for convenience

Setup Process

1. Add BoostNova bot to group (or specific topic)

2. Admin uses /add <token_address> command

3. Select blockchain from menu (Ethereum, BSC, Base, Solana, TON)

4. Token info auto-fetched from DexScreener

5. Real-time monitoring begins instantly

How We Catch 30% More Buys

Traditional Monitoring:          BoostNova Technology:

├── Polling every 30-60s        ├── Block-by-block scanning (2s)
├── Miss fast transactions      ├── Every block processed
├── Single RPC endpoint         ├── Multi-RPC failover system
├── Basic swap detection        ├── Advanced DEX router detection
└── High miss rate              └── 30%+ more buys captured

Block Processing Flow:
┌─────────────────────────────────────────────────────┐
│  New Block Detected                                 │
│  ↓                                                  │
│  Parse ALL Transfer Events                          │
│  ↓                                                  │
│  Filter by Monitored Tokens                         │
│  ↓                                                  │
│  Identify Swap Direction (Buy vs Sell)              │
│  ↓                                                  │
│  Calculate USD Value (Real-time price)              │
│  ↓                                                  │
│  Apply User Filters (MEV, threshold, etc.)          │
│  ↓                                                  │
│  Send Alert to Group/Topic                          │
└─────────────────────────────────────────────────────┘

Technical Advantages:

• 2-second polling intervals - Faster than WebSocket for reliability

• Overlap block checking - Re-scans last 3 blocks to catch missed events

• Multi-RPC rotation - 6-8 backup endpoints per chain for 99.9% uptime

• Known router filtering - 50+ DEX routers identified to correctly attribute buys

• Transaction deduplication - Redis-based dedup prevents double alerts

Alert Templates

Template	Features	Best For
Minimal	Price only, no emojis	Clean, professional groups
Default	Buyer, position change, market cap	Most communities
Detailed	All data + holder count + price impact	Data-focused traders
Hype	Max emojis, streaks, full excitement	Meme coin communities

Complete Customization Options

Display Settings:

• show_buyer_address - Show/hide buyer wallet address

• show_position_change - Display new/add position badges

• show_market_cap - Include current market cap

• show_fdv - Show fully diluted valuation

• show_price - Display current token price

• show_holder_count - Include total holders

• show_price_impact - Show buy’s price impact

• show_tx_link - Link to blockchain explorer

Emoji Visualization:

• emoji_enabled - Toggle emoji display

• emoji_character - Custom emoji (default: 💚)

• emoji_step_usd - USD per emoji (default: $100)

• emoji_max_count - Maximum emojis (default: 20)

• use_premium_emoji - Use Telegram premium emojis

• premium_emoji_id - Custom premium emoji ID

Buy Size Tiers (Auto-labeled):

USD Value	Tier	Emoji	Label
$100,000+	Legendary	🏆	LEGENDARY
$50,000+	Massive	🔥	MASSIVE
$25,000+	Huge	💎	HUGE
$10,000+	Whale	🐋	WHALE
$5,000+	Big	🦈	BIG
$1,000+	Medium	🐬	NICE
$500+	Small	🐟	GOOD
<$500	Tiny	🦐	-

MEV & Bot Filtering:

• filter_mev_bots - Auto-filter known MEV bot addresses

• filter_sandwich_attacks - Detect and filter sandwich trades

• min_block_delay - Minimum blocks before alerting

Buy Streaks:

• streak_enabled - Enable streak detection

• streak_window_seconds - Time window (default: 60s)

• Automatic streak messages:

  • 3+ buys: “🔥 3 buys in the last 60s!”

  • 5+ buys: “🔥🔥 HOT STREAK! 5 buys in 60s!”

  • 10+ buys: “🔥🔥🔥 BUYING FRENZY! 10 buys in 60s! $X volume!”

Aggregation Mode:

• aggregate_enabled - Batch small buys together

• aggregate_window_seconds - Aggregation window

• aggregate_min_count - Minimum buys to trigger

Threshold Media (GIFs/Videos):

• Attach different media based on buy size

• Pre-loaded branded animations:

  • 🎯 Buy Signal (default)

  • 🚀 Rocket ($500+)

  • 💰 Gold & Money ($1,000+)

  • 👑 Crown ($10,000+)

  • 🏎️ Lambo ($50,000+)

  • 🏆 Big Win ($100,000+)

• Upload custom GIFs/videos per threshold

Custom Buttons:

• Add unlimited custom buttons to alerts

• Configure button text, emoji, and URL

• Supports: Website, Twitter, Telegram, DEX links

• Hide/show default Chart and Buy buttons

Social Links:

• website_url - Project website

• twitter_url - Twitter/X profile

• telegram_url - Telegram community

• discord_url - Discord server

Wallet Classification:

• classify_buyers - Enable buyer labels

• smart_money_wallets - Label as “🧠 Smart Money”

• team_wallets - Label as “👥 Team”

• kol_wallets - Label as “⭐ KOL”

• Custom wallet labels with emoji

Cooldown & Quiet Hours:

• alert_cooldown_seconds - Minimum time between alerts

• quiet_hours - Set UTC hours to mute alerts

• auto_pin_threshold_usd - Auto-pin buys above threshold

Pair Selection:

• Monitor specific trading pairs

• Auto-fetch available pairs from DexScreener

• Sort by liquidity for optimal tracking

Admin Commands (Group)

Command	Description
/add <address>	Add token to monitor
/remove	Remove token from monitoring
/list	View all monitored tokens
/settings	Configure alert settings
/dashboard	View monitoring statistics
/tutorial	How to use buy alerts

Supported DEX Routers (Auto-detected)

The bot automatically identifies and correctly attributes buys from:

• Uniswap V2, V3, V4, Universal Router

• PancakeSwap V2, V3, Smart Router

• 1inch V3, V4, V5, V6

• 0x Protocol

• SushiSwap

• Odos, OpenOcean, Bebop

• KyberSwap, Paraswap

• CoW Protocol, Balancer, Maverick

• LiFi, Socket (cross-chain)

• MetaMask Swap, OKX DEX

• And 50+ more routers…