The Short Version
Resolution is the moment a Polymarket market's outcome is officially decided and you get paid in USDC (or pUSD, since the April 22, 2026 V2 launch). Winning shares pay exactly $1.00. Losing shares pay exactly $0.00. The process is automatic - you never click "claim." But the mechanics behind resolution are what separate confident traders from people who are surprised every time a market closes.
This guide covers a lot. You'll learn the three resolution systems. You'll see how UMA's Optimistic Oracle works after the MOOV2 whitelist grew from 37 to 177 approved proposers. You'll learn how to read the rules without getting fooled. And you'll see what happens to your money at each step. We close with four real cases that cost traders millions: Ukraine Minerals ($7M), Fort Knox Gold ($3.5M), UFO ($16M), and the Iran Ceasefire ($280M).
Part 1: What Resolution Actually Is
Every Polymarket share is a claim on $1.00 of USDC. You collect it if a set condition is met by a set date from a set source. When the condition is checked, your shares turn into $1.00 or $0.00. The money lands in your available balance on Polygon (chain 137). No gas. No signatures. No claim button.
Here's the one rule every trader needs to burn into memory:
Part 2: The Three Resolution Systems
Polymarket uses three different systems, depending on the type of market:
| Dimension | UMA Optimistic Oracle | Chainlink Data Streams | Polymarket Markets Team |
|---|---|---|---|
| Used for | Subjective: politics, geopolitics, sports, news | Objective: crypto prices, 5-min markets, weather | Straightforward internal markets (rare) |
| Speed | 2h+ after close | Seconds to minutes | Hours |
| Human involvement | Yes (whitelisted proposer) | Yes (internal team) | |
| Dispute possible? | Yes - $750 bond | No - oracle is authoritative | Limited, flagged in rules |
| Share of markets | ~78% | ~15% | ~7% |
The resolution system is listed in the Rules section of every market. Always check which one applies before you enter.
Part 3: The UMA Optimistic Oracle - Step by Step
Roughly 78% of Polymarket's markets resolve through UMA (the system that settles each market Yes or No). Here's the exact flow from market close to payout.
Step 1: Market closes
Trading stops at one of three points. The market hits its end date. Or the trigger event happens. Or the Polymarket team closes it by hand for resolution.
Step 2: Proposal (whitelisted address posts $750 bond)
An approved proposer submits the outcome - Yes, No, or a set value for multi-outcome - with a $750 USDC bond. Since the MOOV2 whitelist grew in 2026, 177 addresses can submit proposals. That's up from 37 at the original MOOV2 launch. The list includes Risk Labs employees, Polymarket team members, and long-term community proposers vetted by UMA governance.
The bond is posted on-chain and visible on the UMA Oracle dApp at oracle.uma.xyz.
Step 3: Challenge period (exactly 2 hours)
For two hours after the proposal, anyone can review and challenge it. This window is a core design idea. It assumes proposers are mostly honest. It also gives the wider community time to catch mistakes. 2 hours is the hard minimum, not a rough estimate.
If no one challenges within the 2-hour window, the proposal is accepted and payouts begin immediately.
Step 4a: No dispute → payout
This is the most common path. The proposer gets their $750 bond back plus a small fee. Winning shares are credited at $1.00 each. Losing shares are written off at $0.00. Your available balance updates instantly.
Step 4b: Dispute raised (matching $750 bond)
Disagree with the proposed outcome? You can dispute it by posting a matching $750 USDC bond. This triggers the escalation flow.
- First-level dispute: The original proposal is thrown out. A new, potentially corrected proposal can be submitted. If accepted without further challenge, that becomes the final outcome.
- Second-level dispute (rare but critical): If the second proposal is also disputed, the market escalates to UMA's Data Verification Mechanism (DVM).
Step 4c: DVM escalation (48-96 hours)
The DVM is UMA's final backstop. UMA token holders (voters) get 48-96 hours to research and cast votes on the correct outcome.
- Voters who side with the final consensus earn rewards in UMA tokens
- Voters who side against it are penalized (their staked UMA is slashed)
- So the money reward pushes voters to research honestly and land on the truth
- DVM decisions are binding and non-reversible on-chain
Part 4: Chainlink Automated Resolution
Some markets have outcomes a machine can read directly. For these, Polymarket uses Chainlink Data Streams - a real-time oracle feed that resolves markets in seconds.
- Crypto price markets (5-minute, 15-minute, daily, weekly) - resolve against the Chainlink price at the exact timestamp
- Certain weather markets - resolve against official NOAA feeds
- Some sports score markets - resolve against verified score feeds
The upside: no humans, no disputes, no delays. The downside: if the oracle data is wrong or delayed, there's no fix. The reported number is the reported number.
Part 5: Reading Resolution Rules Like a Contract
This is the most profitable habit in prediction-market trading. Every market has a Rules section. Read it before every trade. Here's what to pull out:
- Exact definition of the event - "ceasefire" might require a signed agreement, not just a reduction in fighting. "Launch" might require liftoff, not just a scheduled attempt.
- Time window - when does the event need to happen by? UTC or local time?
- Primary resolution source(s) - "consensus of credible reporting" vs. a single named source (AP, Reuters, NYT, Bloomberg)
- Edge cases and partial fulfillment - what if the event partially happens? What if it's delayed?
- Cancellation clause - under what conditions does the market void and refund?
- Tie-breaker rule - if multiple outcomes could technically apply, which wins?
Four real cases that cost traders millions
Fort Knox Gold audit ($3.5M, 2025): This market hinged on whether the US Treasury would allow an audit. Ambiguity around "allow" and "audit" pushed it to DVM. The outcome ended close to 50/50 - a disaster for anyone who sized up confidently on either side.
Ukraine Critical Minerals Deal ($7M, 2025): This one turned on whether a minerals agreement was "signed." A preliminary MOU existed, but a formal binding deal did not. The market split the difference in a way that angered both sides. DVM intervention was required.
UFO/UAP dispute ($16M, 2025): Resolution depended on what counted as "official government confirmation" of UAP activity. The rules mentioned press briefings without defining "official." DVM voters ultimately chose a strict reading, burning the majority position.
Iran Ceasefire market ($280M, 2026): This was the highest-volume geopolitical dispute to date. Roughly 50 accounts were flagged for insider-trading patterns before resolution. An Israeli Air Force reserve officer was later indicted in April 2026 for $244K of related profits on the Iran Strike market ($188M).
Part 6: What Happens to Your Money
| Scenario | What you receive | When |
|---|---|---|
| Hold Yes, market resolves Yes | $1.00 per share (auto-credited) | Instant on finalization |
| Hold Yes, market resolves No | $0.00 (shares worthless) | Instant |
| Hold No, market resolves No | $1.00 per share (auto-credited) | Instant |
| Hold No, market resolves Yes | $0.00 | Instant |
| Market disputed | Payouts delayed until dispute resolves | 4-96 hours |
| Market canceled/voided | Positions return at collateral value | Typically within 24 hours |
Payouts happen automatically. The USDC (or pUSD, for post-V2 markets) is added to your available balance as soon as resolution finalizes. There is nothing to click, no gas to pay.
Part 7: Timeline - From Market Close to Money in Hand
| Scenario | Time to payout | % of markets |
|---|---|---|
| Chainlink-resolved (crypto, some weather) | Seconds to minutes | ~15% |
| UMA-resolved, no dispute | ~2 hours (challenge window) | ~78% |
| UMA-resolved, single dispute and re-proposal | 4-8 hours | ~6% |
| UMA-resolved, escalated to DVM | 48-96 hours | ~1% |
Most markets resolve within 2 hours. Rare disputes that escalate to DVM make news precisely because they're rare.
Part 8: The MOOV2 Whitelist Expansion (37 → 177)
Before MOOV2, anyone could post a $750 bond and propose an outcome. That created two problems. First, spam proposals clogged the oracle. Second, "griefing" disputes let bad actors challenge correct proposals just to delay payouts.
MOOV2 v1 limited proposals to 37 whitelisted addresses. In 2026, governance grew the whitelist to 177 addresses to handle more volume as it crossed $10B/month. Disputes stay open to anyone. The result:
- Fewer spam proposals → faster average resolution time
- Proposer reliability higher → fewer re-proposals needed
- Community can still catch genuinely bad proposals by posting a dispute bond
- Capacity now matches volume (Apr 2026: 38.4M monthly visits, 688K MAU at ATH, ~2.5M total wallets)
Part 9: Monitoring Pending Resolutions
The system works whether you watch or not. But if you're active or want an edge, here's how to keep tabs:
- UMA's Oracle dApp (
oracle.uma.xyz) - every active proposal, challenge period status, proposer address, bond state - The Polymarket market page - "Resolving" banner with proposed outcome during the 2-hour window
- On-chain data - all proposals visible on Polygon via Polygonscan and queryable programmatically via UMA's subgraph
- Third-party tools - Dune dashboards by Sergeenkov and others track proposal statistics in real time
Part 10: How to Tell if a Market Is About to Be Disputed
Experienced traders watch a few signals during the challenge window. If three or more show up at once, the odds of a dispute jump sharply.
| Signal | What to watch | Dispute correlation |
|---|---|---|
| Rules ambiguity | Subjective words: "ceasefire," "signed," "meaningful," "official" | Very high |
| Proposer reputation | First-time or lightly-used whitelist address | Medium |
| Discord/X noise | Polymarket/UMA Discord threads post-close | High |
| On-chain bond prep | Wallets moving $750+ USDC to UMA oracle shortly after proposal | Very high (pre-dispute staging) |
| Price snap-back | Resolving price moving away from proposed outcome after proposal posts | High |
| News contradiction | Major outlet publishing counter-narrative within challenge window | High |
Hold a losing position and see these signals? Don't rush to sell at $0.02 - disputes can bring prices back up. Hold a winning position? Consider taking profit at $0.97 instead of waiting for the full $1.00 payout to clear the dispute flow.
Part 11: Proposer Track Records - Who to Trust
Not all 177 MOOV2 whitelist addresses are equally accurate. Roughly 90% of proposals come from the top 15 proposers. The top 5 have near-perfect records going back years. You can check any proposer by pulling their submission history on the UMA subgraph.
- Risk Labs core: ~40% of all proposals, accuracy >99%
- Polymarket internal: ~25% of proposals, accuracy >99%
- Community veterans (10+ proposers): ~25%, accuracy >97%
- Newer whitelist adds (50+ proposers since expansion): ~10%, accuracy tracking to be established
The jump from 37 to 177 deliberately brought in newer addresses. The theory: disputes are open, so the system fixes itself. Early data backs this up. The re-proposal rate stayed under 3% after the expansion. That's almost the same as the 37-proposer era.
Part 12: Resolution and the April 2026 V2/pUSD Launch
On April 22, 2026, Polymarket launched V2 and introduced pUSD, a Polymarket-issued stablecoin backed 1:1 by USDC. This has two direct effects on resolution:
- Collateral continuity: Markets created before V2 still pay in USDC. Markets created after V2 pay in pUSD. The amount and timing are identical - only the token symbol differs in your portfolio.
- Perps exclusion: Perpetual futures (launched April 21, 2026 on BTC, NVDA, Gold) do not use UMA resolution. They mark-to-market continuously against a Chainlink price and settle via funding rate. There's no resolution event to dispute - see Perpetual Futures.
Part 13: Common Misconceptions
Part 14: Your Pre-Trade Resolution Checklist
Before you enter any Polymarket position, run this five-item checklist. It takes 90 seconds and saves thousands.
- Open the Rules section. Read every word. If there's a link to an external source, click it. If you see a phrase like "according to credible reporting," figure out which outlets qualify.
- Identify the resolution system. Chainlink (objective, fast, no dispute) or UMA (subjective, 2h minimum, dispute possible). If UMA, flag any subjective terms in the rules.
- Check the end date and resolution date. They can be days apart. Make sure your holding period accounts for the challenge window.
- Search X/Twitter and Polymarket Discord for the market title. If people are already arguing about resolution before the market closes, expect a dispute. Size down or stay out.
- Model the worst case. If the rules were read strictly against your position, would you still win? If not, reduce size.
The public data is brutal: 84.1% of Polymarket wallets lose money. A real chunk of those losses come from resolution surprises. A 90-second rules read would have caught them.
What's Next?
- UMA Disputes - Deep Dive - case studies, when to dispute, how DVM voting actually works
- The Real Risks of Trading Polymarket - every category of loss a trader faces
- Common Mistakes - how to avoid the expensive ones
- Whale Tracking - how large holders maneuver around resolution events
- Market Types - which structures have which dispute risk











