Referrals Guide
Earn a share of PolyBot's trading fees when users you refer trade. Rewards come from PolyBot's revenue, not from your referrals' balances.
Open from the main menu → 🤝 Referral Hub, or run /refer.
🔗 How it works
- Share your referral link (from 🤝 Referral Hub) or generate a QR code
- New user starts PolyBot from your link → creates wallet → becomes your L1 referral
- Their invites become your L2, and so on to L3
Link must be used on the new user's first /start, before wallet creation. Self-referrals blocked.
💰 Earnings
You earn a percentage of the PolyBot fee collected from eligible attributed fills. Current defaults are shown below, but the bot loads these values from runtime configuration and can show different live rates.
| Level | Who | Your share |
|---|---|---|
| L1 | Users you directly refer | 25% |
| L2 | Referred by your L1s | 5% |
| L3 | Referred by your L2s | 3% |
Example using the current defaults: if an eligible $100 fill pays a 1% PolyBot fee, the fee is $1.00 and a 25% L1 share is $0.25. Promotions, fee overrides, attribution rules, and live tier settings can change the real amount.
Rewards accrue from eligible on-chain fills, including proportional partial fills. The default maturity window is about five minutes, but use the Referral Hub's live claimable balance rather than assuming a fixed timer.
👥 Group referrals
Add PolyBot to a Telegram group from 🤝 Referral Hub → 👥 Add to Group. New users who start from group market/trader cards can be attributed to you. See Group Guide.
🏷️ Referral code
You can edit your referral code from the Referral Hub.
- Codes must be 5-10 letters or numbers.
- Codes must be unique.
- New links use the updated code after it is saved.
📊 Tracking & claiming
🤝 Referral Hub shows: referral link, QR code, total referrals, lifetime earnings, total claimed, claimable balance.
💸 Claiming
Tap 💸 Claim Rewards. The minimum currently defaults to $5.00, but the Referral Hub displays the live threshold. Successful claims are paid to your PolyBot pUSD tradable balance.
Claims can be blocked if your balance is below the minimum, another claim is already in progress, or you claimed too recently.
🔔 Notifications
Mute/unmute referral notifications from the hub.
💡 Tips
- Share in communities where prediction market traders are active
- Add context: PolyBot is fast, self-custodial, gas-free, Telegram-native
- Use QR codes for visual posts or events
- Add PolyBot to active groups for passive attribution
🛡️ Eligibility & anti-abuse
- Self-referrals prevented
- Credit requires first
/startvia your link before wallet creation - Group attribution requires starting from a group card before wallet creation
- Rewards based solely on actual on-chain fees
- Claiming is guarded by minimum balance, recent-claim cooldown, and in-progress checks
❓ FAQ
Do rewards come from referrals' balances? No — from PolyBot's fee share.
When do rewards appear? After an eligible attributed fill is recorded and its configured maturity window passes.
Why isn't my balance updating? The fill may still be indexing, maturing, ineligible, or attributed differently. Check the Hub's totals and claimable balance.
Where do claims go? Your PolyBot pUSD tradable balance.
Can I earn from groups? Yes — add PolyBot via 🤝 Referral Hub.
Commands
| Command | What It Does |
|---|---|
/refer | Open 🤝 Referral Hub |