The Short Version
Every trade you make on Polymarket is settled by the UMA Optimistic Oracle. UMA is the system that settles each market Yes or No, where UMA token holders vote on contested outcomes. Understanding how it works is not optional. It's the difference between holding a winning position with confidence and watching a governance attack flip your $50K payout to zero.
In 2025 alone, controversial UMA resolutions hit more than $30M in market value. The cases: the Ukraine minerals deal, the Fort Knox gold audit, and the UFO declassification markets. In April 2026, the Iran ceasefire dispute involved $280M+ in volume. This guide explains the full mechanism — proposal, challenge, dispute, DVM vote. It walks through every major dispute, sizes up the risks, and gives you a practical playbook to protect your positions.
Part 1 - How UMA Resolution Works, Step by Step
Step 1 - Proposal
A whitelisted proposer submits an outcome for a market question and posts a $750 USDC bond. USDC is a digital dollar — 1 USDC = $1. Since MOOV2 launched in August 2025, only approved addresses can propose. Before MOOV2, anyone could.
Step 2 - Challenge period (2 hours)
The proposed outcome is assumed correct. Anyone can dispute it in this 2-hour window by posting a matching $750 USDC bond. If no one disputes, the market resolves at the end of the window and pays out.
Step 3 - First dispute triggers a reset
A single dispute does not trigger a vote. The UMA system ignores the first dispute, cancels the proposal, and restarts the cycle with a new one. This stops one frivolous dispute from blocking resolution.
Step 4 - Second dispute escalates to DVM
If the question is disputed a second time, it escalates to UMA's Data Verification Mechanism (DVM) - the full token-holder vote.
Step 5 - DVM vote (48-96 hours)
- Debate period (24-48h): evidence submitted in UMA Discord channels and governance forum
- Commit phase (24h): voters submit encrypted commit-reveal votes on-chain
- Reveal phase (24h): voters decrypt and publish their votes
- Voters who align with the majority receive rewards; dissenters lose 0.1% of their staked UMA
Step 6 - Final resolution
The DVM vote decides the outcome. About 98.5% of all proposals resolve at Step 2 without ever reaching a DVM vote. The optimistic oracle works most of the time. It's the 1.5% that make the headlines.
| Scenario | Total Time | Share of Resolutions |
|---|---|---|
| Undisputed resolution | ~2 hours after proposal | ~98.5% |
| Single dispute (auto-reset + new proposal) | ~4 hours | ~1% |
| Two disputes + DVM vote | 4-6 days | ~0.5% |
Part 2 - The Four Resolution Codes
UMA voters pick from exactly four options. They matter a lot, because outcomes like P3 and P4 work very differently from a simple Yes/No.
| Code | Meaning | Effect on Shares |
|---|---|---|
| P1 (NO) | The event did not happen | No shares pay $1.00; Yes shares go to zero |
| P2 (YES) | The event did happen | Yes shares pay $1.00; No shares go to zero |
| P3 (UNKNOWN) | Cannot be determined from available information | All shares pay $0.50 (split/refund) |
| P4 (TOO EARLY) | Cannot be evaluated yet - resolution date not reached | Market stays open; functions as provisional No until reassessed |
Part 3 - The MOOV2 Upgrade (August 2025)
The Ukraine minerals governance attack in March 2025 exposed a fatal structural weakness. In response, UMA rolled out Managed Optimistic Oracle V2 (MOOV2) via governance proposal UMIP-189.
Before MOOV2
- Anyone with $750 could propose a resolution
- Bad actors could propose wrong outcomes and hope no one noticed
- Extremely low barrier to attack
After MOOV2 (August 2025)
- Only whitelisted addresses can propose
- Initial whitelist: 37 addresses (the Risk Labs team, Polymarket staff, and top-accuracy community proposers)
- Expanded to 177 whitelisted addresses by November 2025
- Eligibility: at least 5 proposals with 95%+ accuracy over a rolling 6-month window
- Disputing stays open to anyone - you don't need to be whitelisted to challenge a resolution
| Metric | Before MOOV2 | After MOOV2 (first month) |
|---|---|---|
| Incorrect proposals | Baseline | -59% |
| Total disputes | Baseline | -68% |
| Sports and crypto-price markets | Frequent attacks | Near-zero attacks |
MOOV2 was the biggest UMA upgrade to date. But it didn't fix the deeper concentration problem covered in Part 5.
Part 4 - Five Major Dispute Cases
Part 5 - Dispute Economics
| Action | Cost | Notes |
|---|---|---|
| Propose a resolution | $750 USDC bond | Whitelisted proposers only after MOOV2 |
| Dispute a resolution | $750 USDC bond | Anyone can dispute |
| Win a dispute | Bond refunded + 50% of opponent's bond | Net +$375 on $750 staked |
| Lose a dispute | Forfeit entire $750 bond | Goes to the winning side |
| UMA voter penalty (wrong vote) | 0.1% of staked UMA | Also applies to missed votes |
Part 6 - The Concentration Problem
UMA voting is token-weighted. Your influence scales with how many UMA tokens you have staked. That creates a built-in rule-by-the-rich dynamic:
- 4 whale addresses control roughly 40%+ of total UMA supply
- One individual holds approximately 7.5M of 20M staked UMA tokens at various points
- A well-funded attacker can buy enough UMA on the open market to control a single DVM vote
- UMA voters can also hold positions in the disputed markets - a built-in conflict of interest the protocol doesn't currently prevent
This is not theoretical. The Ukraine minerals, Fort Knox, and UFO cases all turned on concentrated voting power. MOOV2 fixed the proposer side, not the voter side. Until UMA adds quadratic voting, voting caps, or position-disclosure rules, concentration is the main residual risk.
Part 7 - How Disputes Affect Your Positions
What happens when your market is disputed
- Markets stay open - you can continue buying and selling while a dispute is active
- Payouts are frozen - winners cannot collect until final resolution
- Trading shifts to a meta-bet - the market becomes about how UMA voters will decide, not the real-world outcome
- Spreads widen a lot - liquidity fades and exit costs rise
- Price drifts toward the DVM expectation - often not the "fair" outcome, but the likely vote outcome
Your options during a dispute
- Sell winners at $0.95-$0.99 for near-instant liquidity. The ~5-cent haircut usually beats days of dispute uncertainty.
- Buy into disputes you understand if you believe you have better information than the current market - high risk, potentially high reward
- Close positions entirely and move on. Freed-up capital for other trades often beats capital locked in an uncertain market.
Part 8 - Evaluating Dispute Risk Before You Trade
Part 9 - The Six Defense Strategies
- Read the full resolution source, not just the title. This protects you from the most common dispute traps.
- Check for active dispute notes on the market page. Polymarket shows dispute status front and center; ignore it at your peril.
- Sell at $0.95+ instead of waiting for $1.00. The last 5 cents of value carries disproportionate dispute risk.
- Size down on ambiguous markets. If resolution criteria are even slightly subjective, cut your position size in half or skip.
- Monitor UMA whale wallets. Unusual UMA token buys in the days before a vote can signal an attack. UMA DVM dashboards on Dune help here.
- Cross-platform hedge. If the same market trades on Kalshi or another DCM, a smaller opposite position there insures you against a Polymarket dispute going the wrong way.
Part 10 - Is UMA Getting Better?
MOOV2 was a material improvement. Disputes fell 68%. Incorrect proposals fell 59%. For bread-and-butter markets (sports, crypto prices, simple binary politics), UMA works well.
But the core issue remains: token-weighted voting is rule-by-the-rich, not democratic. As long as a few whales can control outcomes through concentrated UMA holdings, dispute risk is a permanent feature of the platform. Polymarket has tried alternatives, like Chainlink Data Streams for fully automated markets and internal resolution for some categories. But UMA is still the main mechanism for political, geopolitical, and ambiguous markets.
Treat UMA dispute risk like any other risk. Understand it. Price it into your trades. Size your positions with it in mind. And never forget: the last 5 cents of value on a winning position is often not worth the wait.
Part 11 - Validated Pro Dispute Tips
These are the habits I see again and again from UMA-aware traders. They've held $50K+ positions through contested resolutions and come out clean.
| Trigger You Observe | Immediate Action |
|---|---|
| Market labeled "disputed" | Sell all shares at best available bid within 5 min |
| Ambiguous event language in title | Cap position at 5% of bankroll |
| UMA whale accumulation on-chain | Reduce correlated market exposure by 50% |
| Market volume over $10M with fuzzy criteria | Skip entirely - attack incentive too high |
| First-time proposer address | Increase watchlist priority, size down 30% |
| Cross-platform spread over 5 cents | Buy cheaper side + hedge on other platform |
What's Next?
- Full breakdown of all three Polymarket resolution systems
- Every category of risk beyond UMA
- Plain-English definitions of every UMA / CLOB / DeFi term
- How resolution differs between Polymarket and Kalshi
- The 18 mistakes that ruin bankrolls (several are UMA-related)
- Tracking whales, including UMA voters and attackers











