How Polymarket Markets Resolve: UMA Proposals, Disputes, Chainlink Up/Down Markets and Redemption

Every Polymarket position ends the same way: the market resolves, the winning shares become redeemable for $1, and the losing shares become worthless. How a market resolves, and how long it takes, matters more than many traders realise. It decides when your capital comes back, which edge cases can catch you out, and what an automated bot has to handle on its own.

Polymarket uses two resolution systems: the UMA Optimistic Oracle for most prediction markets, and Chainlink TWAP data for its crypto up-or-down markets (Polymarket: Resolution). This guide walks through both, along with disputes, clarifications and the rare 50/50 outcome, and finishes with what a trading bot should automate.

Rule #1: the rules, not the title, decide the outcome

Every market has a rules section that defines:

• The resolution source: the official announcement, website, data feed or exchange candle that counts.
• The end date: when the market becomes eligible to resolve.
• Edge cases: postponements, cancellations, ties, revised data, ambiguous wording.

Polymarket's own docs warn that the title describes the question while the rules define how it resolves (docs). A title like "Will X happen by Friday?" can hide crucial detail: whose time zone, which source, what counts as "happen". Before you or your bot trade a market, read the rules. Most resolution "surprises" are written there in plain text.

UMA-resolved markets: the optimistic oracle

UMA's oracle is called "optimistic" because it assumes a proposed answer is correct unless someone puts money on the line to challenge it.

Step 1: Proposal

Once the outcome is known, anyone can propose it by choosing the winning outcome and posting a bond, typically $750 in pUSD. If the proposal stands, the proposer gets the bond back plus a reward. If they're wrong, or propose too early, they lose the whole bond (docs).

Step 2: The 2-hour challenge period

After a proposal there's a 2-hour window in which anyone can dispute it by posting an equal counter-bond on the UMA dapp. Polymarket's help centre notes that the dispute link sits in the market's rules section (Help: How are markets disputed?).

• No dispute: the proposal is accepted and the market resolves, about two hours after the proposal.
• First dispute: the proposal is thrown out and a new proposal round starts.
• Second dispute: the question escalates to UMA's Data Verification Mechanism (DVM), where UMA token holders vote.

Step 3 (only if escalated): debate and vote

An escalated dispute gets a 24–48 hour debate period, with evidence posted in UMA's Discord channels (#evidence-rationale and #voting-discussion). That's followed by roughly 48 hours of voting. Polymarket puts a disputed resolution at about 4–6 days in total.

How the vote can end

Vote result	What it means	Bonds
Proposer wins	The original proposal stands	Proposer gets their bond back plus half the disputer's
Disputer wins	The proposal was wrong; a new proposal is needed	Disputer gets their bond back plus half the proposer's
Too early	The event hadn't concluded when it was proposed	Disputer is rewarded; proposer loses their bond
Unknown / 50-50	No listed outcome fits (rare)	Market resolves 50/50: each share redeems for $0.50

(Summarised from Polymarket's resolution docs and help centre.)

Once UMA finalises an outcome, it's final. Polymarket's help centre states that Polymarket is non-custodial and cannot alter or reverse a finalised resolution.

Clarifications ("Additional context")

Sometimes something nobody anticipated happens after trading has started. Polymarket can then publish an "Additional context" clarification. Clarifications are posted on-chain through a bulletin-board contract, can't change the fundamental intent of the question, and are meant to be considered by proposers and UMA voters. Traders can ask for one in the #market-review channel of Polymarket's Discord (docs).

If a market you hold gets a clarification, reread the rules. A clarification can change which outcome is likely even though the question is the same.

Chainlink-resolved "Up or Down" markets

Polymarket's short-term crypto markets ("Bitcoin Up or Down – 9:30PM–9:45PM ET") work differently. They don't go through UMA proposals and disputes. Each market sets an asset pair, a start time and a duration. The TWAP at the start sets the "price to beat", and the TWAP at the end is compared with it. The market resolves Up if the final price is equal to or greater than the price to beat, and Down if it's lower. Because the inputs are fixed, the same data always gives the same answer (docs).

Check each market's own rules, because the source isn't the same everywhere. When we pulled live markets from Polymarket's Gamma API on October 8, 2026:

• 5-minute, 15-minute and 4-hour BTC markets named Chainlink's BTC/USD 60-second TWAP stream as the source ("not according to any other sources or spot markets").
• Hourly BTC markets referenced the Binance BTC/USDT 1-hour candle (open vs close).
• A daily BTC market referenced Binance 1-minute candle closes at noon ET on consecutive days.

For a bot that watches exchange prices, this matters a great deal: the feed you trade on may not be the one the market settles on. More in Polymarket crypto up/down markets.

Multi-outcome events and "Other"

Events with several mutually exclusive outcomes (elections, awards, "which company will…") are groups of binary markets linked as negative risk, where exactly one resolves YES. Some use augmented negative risk, with placeholder outcomes that get named later and an "Other" outcome that catches anything unnamed. Polymarket advises trading only named outcomes and avoiding "Other" directly, because its definition changes as placeholders are filled in (Negative Risk Markets).

After resolution: trading stops, redemption starts

Once a market resolves:

• Trading stops. You can't buy or sell its shares.
• Winning shares redeem for $1.00 each; losing shares are worth $0.00 (or $0.50 each in a 50/50 outcome).
• Redemption is a separate action. Polymarket's interface handles it for you. If you trade programmatically, your code (or your bot) has to call redeem, e.g. redeem_positions(condition_id=...) in the unified Python SDK (see Polymarket API with Python).

Unredeemed winnings don't vanish, but they also don't do anything for you until you redeem them.

What this means for traders and bots

1. Read the rules before you trade. The biggest losses tend to come from wording, not from price moves. For cross-venue strategies, make sure the two venues resolve on the same rules (see Polymarket arbitrage explained).
2. Budget for lock-up time. An undisputed market frees your capital about two hours after a proposal. A disputed one can take days. Size positions so a dispute doesn't strand money you need.
3. Treat late-stage prices with care. Prices near 99¢ before resolution reflect a small but real chance of a surprise outcome or a 50/50 resolution. Buying "free money" at 99¢ risks 99¢ to make 1¢, plus the taker fee (see Polymarket fees).
4. Listen for resolution events. The market WebSocket can emit market_resolved events when custom_feature_enabled is set (Real-Time Data). A good bot uses this to stop trading a market, mark positions and trigger redemption.
5. Plan for redemption. It's the most commonly forgotten piece of DIY bots. Ghost Trader detects settled markets and settles them in your dashboard; for now you redeem winning live positions on polymarket.com (one click per market).
6. Don't propose casually. Proposing an outcome puts a bond at risk. Unless you're sure, and it's after the event, leave it to others.

FAQ

How long does Polymarket take to resolve a market? Undisputed UMA markets resolve about two hours after a proposal is made. Disputed ones take about 4–6 days. Up/down markets resolve from fixed price data without the proposal process.

Who decides the outcome? For most markets, the UMA optimistic oracle: anyone can propose or dispute, and UMA token holders vote on escalated disputes. For up/down markets, the price source named in the rules.

Can Polymarket reverse a resolution? According to its help centre, no. Once UMA finalises an outcome it's immutable.

What happens if the event is cancelled? It depends on the market's rules. Many spell out cancellation or postponement handling, and some edge cases end in a 50/50 resolution. Read the rules before trading.

Why is my winning position not showing as cash? Winning shares must be redeemed. If you trade through an API or a bot, make sure redemption is automated.

---

Ghost Trader watches for resolved markets and settles your trades in the dashboard (you redeem winning live positions on polymarket.com), alongside copy trading, a crypto up/down engine, fractional-Kelly sizing and a daily-loss kill switch. $199/month, paper mode included. See pricing.

Not financial advice. Trading can lose money. Ghost Trader isn't available where Polymarket restricts trading, including the US, and is not affiliated with Polymarket.