Documentation & Help Center
Your complete guide to understanding and trading on the XPredict platform.
Getting Started
Your first steps to start trading on XPredict.
Connect Your Wallet
Click "Connect Wallet" and choose from MetaMask, WalletConnect, or other options. You will need funds on the Polygon network.
Get Required Tokens
Ensure you have USDC for betting and a small amount of Polygon (POL) to pay for network transaction fees (gas).
Browse & Bet
Explore active markets, choose YES or NO on a tweet's outcome, and enter your bet amount.
Claim Winnings
If you predicted correctly, return to the market page after it resolves to claim your winnings.
How It Works
Understanding the mechanics behind the platform.
Market Creation
Anyone can create a market by specifying:
- A valid X.com (formerly Twitter) status URL.
- A like target (e.g., 10,000 Likes).
- A resolution duration (6 hours to 7 days).
- A flat creation fee paid in USDC.
Parimutuel Betting
XPredict uses a pool-based betting system where you bet against other users, not the house:
- All bets for an outcome (YES/NO) are collected into their respective pools.
- After the market resolves, winners split the funds from the losing pool, proportional to their bet size.
- The odds are dynamic, determined by the ratio of money in the YES vs. NO pools.
Market Resolution
After the resolution time passes, a trusted platform oracle retrieves the final like count from the X/Twitter API and resolves the market on-chain.
- YES wins if likes are greater than or equal to the target.
- If a tweet is deleted or inaccessible, the market is canceled and all bets are refunded.
Wallet & Tokens
What you need to interact with the Polygon network.
Two-Token System
You need two types of tokens in your wallet on the Polygon network:
Every on-chain action (placing a bet, claiming winnings) requires a small "gas fee" paid in POL. Having 1-2 POL is enough for many transactions.
Fees & Rewards
Understanding the costs and your potential earnings.
A flat fee to prevent spam.
Deducted from the total winning pool.
Potential Returns Example
The Payout Pool becomes 1000 - (3% fee of 30) = 970 USDC.
Your Payout = (Your Bet / Winning Pool) * Payout Pool
Your Payout = (100 / 400) * 970 = 242.50 USDC.
Safety & Security
Our commitment to a secure trading environment.
Smart Contract Security
- Built on battle-tested OpenZeppelin standard contracts for security.
- Non-custodial: Your funds are held exclusively by the smart contract, not by us.
- All operations are transparent and verifiable on the Polygon blockchain.
Best Practices
- Never share your private keys or seed phrase with anyone. The XPredict team will never ask for them.
- Always verify transaction details in your wallet before signing.
- We recommend starting with small amounts to get comfortable with the platform.
All betting involves financial risk. Only bet what you can comfortably afford to lose. Outcomes are based on social media activity, which can be unpredictable. Smart contracts are secure but may have inherent risks. Users are responsible for complying with their local laws.
Frequently Asked Questions
What happens if a tweet is deleted?
The market will be canceled by the platform oracle. All participants can then use the "Claim Refund" function on the market page to get 100% of their bet back.
Can I change my bet after placing it?
No, bets are final once submitted to the blockchain. You also cannot bet on the opposite side of a market you are already participating in.
What if there's a dispute about the outcome?
The outcome is determined by the like count at the exact moment of resolution by the platform oracle. This data is public on X/Twitter. In rare cases of API issues, the oracle will resolve based on the clearest available data to ensure fairness.