Documentation
Learn how to use XPredict to trade on tweet performance and earn rewards.
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.
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:
- • All bets for an outcome (YES/NO) are collected into pools.
- • Winners split the funds from the losing pool, proportional to their bet size.
- • This means you are betting against other users, not the house.
Market Resolution
After the resolution time passes:
- • A trusted platform oracle retrieves the final like count from the X/Twitter API.
- • The oracle submits this count to the smart contract to resolve the market.
- • YES wins if likes are greater than or equal to the target.
- • If a tweet is deleted, the market is canceled and all bets are refunded.
Supported Wallets
Our platform uses RainbowKit, which supports a wide range of wallets, including:
MetaMask
The most popular browser wallet.
WalletConnect
Connects to hundreds of mobile wallets like Trust Wallet.
Two-Token System
You need two types of tokens in your wallet on the Polygon network:
Every transaction on the blockchain (placing a bet, creating a market, claiming winnings) requires a small "gas fee" paid in Polygon (POL). Having 1-2 POL is enough for many transactions.
Market Creation Fee
A flat fee for creating any market, used to prevent spam.
Platform Fee
A small fee deducted from the total pot before winners are paid.
Potential Returns Example
The Payout Pool is 1000 - (3% fee of 30) = 970 USDC.
Your Payout = (100 / 400) * 970 = 242.50 USDC.
Smart Contract Security
- • Built on battle-tested OpenZeppelin standard contracts.
- • Non-custodial: Your funds are only held by the smart contract, not us.
- • All operations are transparent and verifiable on the Polygon blockchain.
Best Practices
- • Never share your private keys or seed phrase with anyone.
- • Always verify transaction details in your wallet before signing.
- • We recommend starting with small amounts to get comfortable.
Financial Risks
- • All betting involves risk of loss. Only bet what you can afford to lose.
- • Past performance does not guarantee future results.
- • Market outcomes are based on social media activity which can be unpredictable.
Technical Risks
- • Smart contracts, while audited, may contain bugs or vulnerabilities.
- • Network congestion may affect transaction processing times.
- • Third-party APIs (Twitter/X) may experience downtime affecting resolution.
Legal Disclaimer
This platform is for entertainment purposes. Users are responsible for compliance with their local laws and regulations regarding online betting and cryptocurrency use.
What happens if a tweet is deleted?
The platform oracle (admin) will cancel the market. All participants can then use the "Claim Refund" function 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 cannot bet on the opposite side of a market you are already in.
What if there's a dispute about the outcome?
The outcome is determined by the like count at the moment of resolution by the platform oracle. This data is public and verifiable on X/Twitter. In rare cases of API issues, the oracle will resolve based on the clearest available data.