Predict Bangers Docs

1. Product Overview

Predict Bangers lets users create and trade yes-or-no markets tied to public internet moments. A market creator defines the question, resolution criteria, category, end date, seed amount, creator fee, and fee recipient. Traders can then buy YES or NO with USDC, exit before expiry, and claim after final resolution.

• Supports both live mainnet usage and a full Base Sepolia testing mode.
• Uses a single factory contract model with per-market V3 contracts.
• Resolves through an optimistic proposal + dispute system rather than an offchain admin-only close flow.
• Includes portfolio views, bet slips, shareable market previews, and market-room chat in the web app.

2. Official Links

3. Live Networks And Contracts

Predict Bangers currently supports Base Mainnet and Base Sepolia. The app can switch between them from the sidebar, and market creation, trading, and resolution behavior stays consistent across both modes.

4. Market Model, Fees, And Core Mechanics

Every market is a USDC-funded yes-or-no pool. At creation, the seed is deposited and split evenly between YES and NO pools. Trade pricing is derived from pool balance, and users can buy or sell before the market ends.

• Minimum market seed: 1 USDC.
• Minimum trade size: 0.1 USDC.
• Platform fee: 1% on every trade.
• Creator fee: 0% to 4%, configurable at market creation.
• Total fee cap: 5%.
• Creator fees can route to any custom recipient address, including multisigs or treasury wallets.

5. Creating A Market

The create flow supports both manual market drafting and URL-driven autofill. Users can paste a supported post or article URL, let the app resolve metadata, then adjust the question, description, category, end date, and fee settings before deployment.

1. Connect a wallet with Privy or a supported external wallet.
2. Select Base Mainnet or Base Sepolia from the app sidebar.
3. Paste a supported URL or manually write the market thesis.
4. Review the generated question, description, category, and end date.
5. Choose the seed size, creator fee, and fee recipient.
6. Approve USDC and confirm deployment.

Supported URL Inputs

Current Category Stack

6. Trading, Portfolio, Bet Slips, And Positions

Once a market is live, traders can buy YES or NO, sell open positions, and track holdings from the portfolio view. The interface also includes saved bet slips and downloadable/shareable preview assets.

• The market detail panel shows current odds, volume, fee rate, chat, and resolution state.
• Portfolio mode tracks positions, pending claims, and wallet-facing P/L snapshots.
• Bet slips can save trades before execution, then be downloaded or shared after they are built.
• Market preview images can be downloaded as PNGs for posting and promotion.

7. Resolution And Dispute Lifecycle

Markets do not finalize automatically at the moment of expiry. Instead, Predict Bangers uses an optimistic resolution model with a posted bond, a liveness window, and a dispute path.

1. After the market end time, anyone can propose an outcome by posting a 0.04 USDC bond.
2. A 2-hour liveness window opens immediately after the proposal.
3. Anyone who disagrees can dispute by posting a second 0.04 USDC bond.
4. If there is no dispute after the window expires, anyone can settle the market and the proposer gets their bond back.
5. If the proposal is disputed, the platform arbitrates the result and the loser’s bond goes to the winner.
6. Once a market is resolved or canceled, users claim payouts directly from the market contract.

• If a market is canceled, the contract redistributes remaining funds pro rata rather than forcing a YES or NO outcome.
• Claims are onchain and irreversible once confirmed.

8. Wallets, Auth, And Onramp

Predict Bangers uses Privy for email and wallet login, supports embedded or external wallets, and can open an onramp flow for funding USDC-compatible wallets on Base.

• Email login can create an embedded wallet automatically.
• External wallets can connect and trade directly if they are on the selected Base network.
• The app supports switching between Base Mainnet and Base Sepolia from inside the sidebar.
• Read-only browsing works without connecting a wallet, but trading, creation, and claiming require one.

9. Sharing, Discovery, And Social Inputs

Predict Bangers is designed to turn internet discourse into tradeable objects, so the app includes multiple discovery and sharing layers on top of the raw contract flows.

• Market creation can start from public social posts and public article URLs.
• Share actions can produce hosted market cards with richer social previews.
• Download actions generate branded PNGs for bet slips and market previews.
• Category inference prioritizes high-engagement culture lanes for internet-native markets.

10. Risks, Limits, And Operational Notes

Predict Bangers is a live onchain product. All usage carries blockchain, market, and interpretation risk.

• USDC approvals, buys, sells, claims, and market creation are onchain transactions and cannot be reversed after confirmation.
• Public source URLs can change, disappear, redirect, or become inaccessible before resolution time.
• Resolution depends on human-readable criteria and public evidence, so poorly written markets are more likely to be disputed.
• Wallet providers, RPC endpoints, and external APIs can fail or rate-limit without warning.
• Predict Bangers is not financial, legal, tax, or investment advice.

11. Frequently Asked Questions

Built by Internet Money Labs.