Back to Documentation
Core Commands
| Command | Description | Example |
|---|---|---|
create |
Create a new prediction market | @solpredictbot create "Will BTC hit $100K?" |
yes/no [amount] |
Place a bet | yes 2 or no 1.5 |
deposit |
Generate or refresh your SOL deposit address | @solpredictbot deposit |
deposit $TOKEN |
View supported SPL / L1 partner token deposit instructions | @solpredictbot deposit $BONK |
balance |
Check your current balance | @solpredictbot balance |
withdraw |
Withdraw SOL to your wallet | @solpredictbot withdraw 5 [address] |
help |
Get help and command list | @solpredictbot help |
Advanced Commands
For power users and market creators:
@solpredictbot stats- Your betting statistics@solpredictbot leaderboard- Top winners@solpredictbot trending- Popular markets@solpredictbot challenge @user "question"- Challenge friends@solpredictbot share [market_id]- Share a market@solpredictbot template crypto/stocks/sports- Get templates@solpredictbot resolve [market_id] yes/no- Admin/manual resolution override@solpredictbot reminder 30m- Set a reminder before market expiry
Rate Limits & Fallbacks
The bot operates within Twitter API limits and adds its own guard rails:
- ⏱️ Mention polling every 15 minutes (testing mode: 3 minutes)
- 🚫 Self-mention filter prevents loops from @solpredictbot replies
- 🛡️ Replies that fail with
403automatically trigger a fallback tweet from the bot's profile - 📌 Fallback tweet IDs are stored with the market for continued betting
- 📈 Rate limit headers are logged to adjust cadence dynamically
If you see a fallback tweet:
1. Reply to the fallback post with
yes [amount] or no [amount]
2. The bot links both threads to the same market ID
3. Updates appear on-site within seconds
How @solpredictbot Works
@solpredictbot is our Twitter bot that handles all interactions. It:
- ✅ Polls Twitter mentions every 15 minutes (adaptive if rate limited)
- ✅ Monitors Solana deposits every minute across supported SPL tokens
- ✅ Checks expired markets every 10 minutes with Grok AI fallback
- ✅ Validates Grok responses for accuracy, confidence, and language
- ✅ Posts resolutions publicly on Twitter (with corrected copy on conflicts)
- ✅ Pays winners automatically and logs payouts/server responses
Fully automated 24/7! No manual intervention needed.