⚙️Competition Settings
Admins can customize various aspects of referral competitions to match their community's needs.
Accessing Settings
Use
/settingscommand in your group (admins only)Or message the bot privately with
/settingsSelect your group from the list
Competition Configuration
Scoring System
Regular Score
Default: 1 point
Range: 1-10 points
Points awarded for regular users who verify via captcha
Premium Score
Default: 3 points
Range: 1-10 points
Points awarded for Telegram Premium users (skip captcha)
Example: If Regular=1 and Premium=3, a Premium user is worth 3x more than a regular user. Adjust based on your goals.
Winner Count
Default: 3 winners
Range: 1-10 winners
How many top participants receive prizes
Default Prize Text
Customize the prize description shown on leaderboards
Example: "1000 $TOKEN tokens" or "NFT Whitelist"
Only applies to non-auto-pay competitions
Auto-Pay Settings (Premium Groups Only)
Enable/Disable Auto-Pay
Toggle automatic cryptocurrency payments for competition winners.
When Enabled:
Admins deposit prize pool before starting competitions
Winners receive instant automatic payments
Users must set wallet addresses to participate
When Disabled:
Standard referral competitions (no upfront payment)
Admins manually distribute prizes after competitions
Select Payment Token
Choose which cryptocurrency to use for payouts:
USDT
BEP-20 (BSC)
Stablecoin
BNB
BEP-20 (BSC)
Native
SOL
Solana
Native
USDC
Solana
Stablecoin
USDT
Solana
Stablecoin
Important: Once a competition is active or payment is confirmed, you CANNOT change the token. This ensures the deposit and payout currencies always match.
Prize Pool & Distribution
Prize Pool Amount:
Minimum: $50 USD
Maximum: $100,000 USD
5% service fee automatically added
Distribution Presets:
Top 2: 60-40
Top 3: 50-30-20 (Balanced)
Top 3: 70-20-10 (Winner-Heavy)
Top 5: 40-25-15-12-8 (Spread)
Custom Distribution:
Up to 10 winners
Percentages must be whole numbers
Must total exactly 100%
Format:
30, 25, 20, 15, 10
Group Access Settings
Captcha Verification
Enable/Disable:
When enabled: All non-Premium users must verify via wallet captcha
When disabled: Users join freely (not recommended)
Fast-Pass for Premium:
Toggle whether Telegram Premium users skip captcha
Recommended: Keep enabled for better UX
Premium Only Mode
Restrict group to Telegram Premium subscribers only.
When Enabled:
Only Telegram Premium users can join
Non-premium users are kicked automatically
Token Gating
Require users to hold specific tokens to join.
Configuration:
Contract address
Blockchain (Ethereum, BSC, Solana, etc.)
Minimum balance required
See Token Gating for details
Branding (Premium Groups)
Custom Images
Upload custom images for:
Welcome Image - Shown when users join
Competition Start - Posted when competition begins
Leaderboard - Used on leaderboard messages
Requirements:
Supported formats: JPG, PNG
Recommended size: 1280x720px
Max file size: 5MB
Bot Customization
Custom bot username (Whitelabel feature)
Custom welcome messages
Branded buttons and text
Advanced Settings
Auto-DM Winners
Automatically send a congratulations message to winners via DM.
Leaderboard Update Frequency
Default: Every 1 minute
Keep pinned message updated with latest standings
End Date Display
Show competition end date and time on leaderboard.
Best Practices
✅ Test first - Run a small test competition before going big
✅ Clear scoring - Make point values easy to understand (1 for regular, 3 for premium)
✅ Fair distribution - Don't make top prize too dominant
✅ Set appropriate duration - 7-14 days works well for most communities
✅ Enable auto-pay - Builds trust and saves manual work
✅ Use Premium features - Worth the investment for serious growth
❌ Don't change mid-competition - Keep settings consistent
❌ Don't disable captcha - Opens door to bots
❌ Don't set prizes too low - $50 minimum for auto-pay
Last updated