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
Challenge Mode - 1v1 Predictions
Challenge Mode lets you create head-to-head prediction markets with friends. It's perfect for friendly wagers, debates, or competitive predictions!
How to Create a Challenge
Use the challenge command to challenge another user:
@solpredictbot challenge @username [amount] [yes/no] "Your prediction question?"
Command Format:
@username- The Twitter handle of the person you're challenging (required)[amount]- Stake amount in SOL (optional, defaults to 1 SOL)[yes/no]- Your side of the bet (optional, defaults to "yes")"question"- Your prediction question (required, in quotes)
Examples
Basic Challenge (1 SOL, default "yes"):
@solpredictbot challenge @elonmusk "Will Bitcoin hit $100K by December 2025?"
Challenge with Custom Stake:
@solpredictbot challenge @friend 5 "Will the Lakers win the championship?"
Challenge with Side Specified:
@solpredictbot challenge @opponent 2.5 no "Will ETH reach $10K by Q1 2026?"
All Parameters (Full Control):
@solpredictbot challenge @user 10 yes "Will Solana reach $500 by end of 2025?"
How Challenges Work
- You create the challenge - Your stake is locked immediately when you create the challenge
- Bot posts the challenge - The bot replies with a challenge announcement and mentions your opponent
- Opponent accepts - Your opponent must reply with
"[opposite_side] [stake]"to accept (e.g., if you bet "yes", they reply "no 5") - Market resolves - When the market expires, Grok AI automatically resolves it
- Winner takes all - The winner receives both stakes (2x the challenge amount) minus fees
Challenge Response Example
When you create a challenge, the bot will reply with something like:
⚔️ CHALLENGE LOCKED! ⚔️
@YourUsername staked 5 SOL on YES.
@OpponentUsername, reply "no 5" to accept and lock your stake.
🆔 GM-ABC123
"Will Bitcoin hit $100K by December 2025?"
⏰ Ends in 180 days
🔒 Funds held in Solana escrow. Winner takes 10.00 SOL.
Link: https://grokmarkets.com/market/GM-ABC123
#grokmarketsChallenge #PredictionMarket
Accepting a Challenge
To accept a challenge, reply to the bot's challenge tweet with:
[opposite_side] [stake_amount]
For example, if the challenger bet "yes 5", you would reply:
no 5
Your stake will be locked immediately, and the challenge becomes active!
Challenge Rules & Limits
- Minimum stake: 0.1 SOL
- Maximum stake: 100 SOL
- Default stake: 1 SOL (if not specified)
- Default side: "yes" (if not specified)
- You cannot challenge yourself - The bot will reject self-challenges
- Funds are locked in escrow - Both stakes are held securely on Solana until resolution
- Winner takes 2x stake - If you bet 5 SOL and win, you get 10 SOL (minus fees)
- Same resolution system - Challenges use the same Grok AI resolution as regular markets
Tips for Challenges
- 💡 Make sure you have enough balance before challenging (your stake is locked immediately)
- 💡 Use clear, specific questions that Grok AI can verify (dates, prices, outcomes)
- 💡 Challenges are public - everyone can see and bet on them (though only you and your opponent have locked stakes)
- 💡 The bot posts a quote tweet for visibility, so your challenge gets maximum exposure
- 💡 You can challenge anyone on Twitter - they don't need to be a GrokMarkets user yet
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.