Platform Overview

A quick map of how everything on Cupdiction connects.

Architecture

Your wallet (Privy / external Solana wallet)
        ↓
  Deposit USDC / USDT / SOL
        ↓
   Trade on markets
   (LMSR automated pricing)
        ↓
   Shares held in your position
        ↓
   Market closes → Oracle resolves
        ↓
   Winners receive $1.00/share

Key concepts

Concept	What it means
Market	A question with YES/NO outcome, a deadline, and a resolution rule
Share	A unit representing a position in one outcome
LMSR	The pricing formula that determines share prices automatically
Oracle	The system that fetches external data to determine outcomes
Settlement	The on-chain process that pays winners and closes the market
Liquidity	The pool of funds that enables trading; determines how much prices move per trade

Market lifecycle

Created → Open (trading live) → Closed (no more trades) → Resolving → Settled

State	What’s happening
Open	You can buy and sell shares
Closed	Trading stopped; oracle is fetching resolution data
Pending Recheck	Oracle needs to retry — data was unavailable at first check
Needs Review	Data conflict detected; admin review required before settlement
Resolved	Outcome determined, winners paid
Void	Market cancelled; all stakes refunded

Verticals

Cupdiction organises markets into verticals based on data source and theme:

Vertical	Markets	Data source
Bags.fm	Token graduation, fee races	Bags.fm API + Helius on-chain
Sports (coming soon)	Match outcomes, tournament results	Sport data providers

Wallets and custody

Cupdiction uses Privy for wallet management. You can:

Create an embedded wallet — Privy generates a Solana wallet tied to your email or Google account. You can export the private key at any time.
Connect an external wallet — Use any existing Solana wallet (Phantom, Backpack, etc.)

⚠️

Cupdiction is non-custodial. We never hold your private keys or control your funds. Disconnecting the app does not move or affect your balance.

Supported currencies

Currency	Deposit	Trade	Withdraw
USDC	✓	✓	✓
USDT	✓	✓	✓
SOL	✓	✓	✓

All internal accounting uses the currency you chose when placing the trade. Payouts are returned in the same currency used to buy shares.

How Prediction Markets Work Getting Started