How Polymarket Markets Resolve: UMA Process

Resolution is when a market receives its official answer. In the usual case one outcome wins, its holders redeem their tokens, and the tokens of the other outcome end up worthless. Polymarket's documentation names two resolution sources: UMA (prediction markets) and Chainlink TWAP (up-down markets), where TWAP means time-weighted average price. This guide follows the UMA path. There the oracle, the system that reports which outcome won, is UMA's Optimistic Oracle, and a proposed result stands unless someone disputes it in time. The Up/Down guide covers the other source, and how Polymarket works covers the basics.

Why the rules matter more than the title

Every market has written resolution rules, and the documentation says they specify a resolution source, an end date and the handling of edge cases. The source says where the answer will be read from, for example official announcements or a particular website. The end date is when the market becomes eligible for resolution. Edge cases say how ambiguous situations are handled. The title describes the question and the rules define how it resolves, which is why the documentation's own advice is to read the resolution rules before trading.

Step 1: a proposal with a bond

Anyone can propose a result. The proposer selects the winning outcome, posts a bond (typically $750 pUSD) and submits the proposal to the UMA oracle. A proposer who is right and undisputed gets the bond back plus a reward, while one who is wrong or too early loses all of it.

Step 2: the challenge period

After a proposal comes a challenge period of 2 hours, during which anyone who disagrees can dispute the outcome. If nobody does, the proposal stands and the market resolves (the data section notes a case where a proposal past its window stays under review).

A dispute costs money: the disputer posts a counter-bond of the same amount as the proposer's bond. The dispute opens a new round with a second proposal, and that proposal can be disputed in turn. If it is, the question goes to a debate period and then to UMA's Data Verification Mechanism (DVM), a vote of UMA token holders.

The three flows

The documentation lists three flows.

1. No dispute. A proposal is made, the challenge period passes and the market resolves. The documentation calls this the fastest path and puts it at about 2 hours after the proposal.
2. One dispute. The first proposal is disputed, a second proposal is made and, if it is accepted, the market resolves on it.
3. Two disputes. The second proposal is disputed as well, so a debate period and a vote of UMA token holders follow.

A vote does not always end the matter. It can also end in "new proposal needed" or "too early" (see the bonds table below), and the pages do not say how many rounds can follow.

What happens in a debate and a vote

A second dispute opens a debate period; the table below gives the length of every phase. During the debate, evidence can be submitted in two UMA Discord channels. When the debate ends, the holders of UMA tokens cast votes on which outcome is correct, and the vote takes about 48 hours. The documentation does not describe how votes are counted; it only links to UMA's documentation about the Optimistic Oracle.

Length of each phase of a UMA resolution. Source: docs.polymarket.com/concepts/resolution, checked Oct 19, 2026.

What happens to the bonds

The vote also decides who keeps the money, as the four possible results show.

What the UMA vote decides and how the bonds move. Source: docs.polymarket.com/concepts/resolution, checked Oct 19, 2026.

The documentation does not say where the other half of a losing bond goes.

What "too early" and 50-50 mean

Two of the four results are not a plain win for either side.

Too early means the event had not concluded yet. The bonds move as if the disputer had won. The documentation does not say what happens to the market next, so check its status in the data (last section).

Unknown or 50-50 covers the rare case where neither outcome applies. The market resolves 50/50 and each token redeems for $0.50. The Positions page notes that a binary market can pay a split instead of a full dollar or nothing, and that negative-risk markets, which are events with several outcomes of which only one can win, never pay a split, because one outcome takes the whole payout and the others get nothing. The Resolution page's 50/50 row does not mention that exception.

What "additional context" can and cannot do

In rare cases, something unforeseen comes up after trading starts. Polymarket may then publish an "Additional context" update for proposers and voters to take into account. Such an update cannot change what the question is fundamentally about. It is recorded onchain in a bulletin board contract, and UMA voters should weigh it when they resolve disputes. To ask for one, the documentation points to the market-review channel on Polymarket's Discord.

How long does resolution take?

The documentation puts an undisputed resolution at about 2 hours after the proposal and a disputed one at 4-6 days in total. It does not break the disputed total down, so the phases above need not add up to it, and it does not say whether the total covers a market disputed once or twice. Treat any time shown for a pending market as an estimate: the data documentation calls it the soonest the market could settle, not a deadline, because a vote on a disputed market can slip into a later round.

What happens after resolution

Once a market has resolved, its trading ends and its tokens can no longer be bought or sold. Winning tokens redeem for $1.00 each in pUSD, the collateral token covered in the pUSD and Protocol V2 guide, and losing tokens become worthless. The Positions documentation says there is no redemption deadline, so winning tokens stay redeemable at any time.

How is this different from Up/Down markets?

The Resolution page says Up/Down markets skip UMA's proposal and dispute process. Each one is defined by an asset pair, a start and a length. A TWAP, the average over a lookback window, taken at the start becomes the price to beat, and a TWAP taken at the end becomes the final price, both from the same Chainlink stream. Up wins if the final price ends at or above the price to beat, and Down wins if it ends lower. The changelog dates the switch from a single price snapshot to TWAPs to August 7, 2026. A market's own rules name its resolution source, so check them; the Up/Down guide covers the windows.

How to read the resolution status in the data

Polymarket's Data API has a resolution route, GET /v2/resolutions on data-api.polymarket.com. It takes one selector at a time: a UMA question id, condition ids or event ids. A request that matches nothing returns an empty list. Each row has a lifecycle status, the time of the last update and, once published, the payouts. The reference lists these lifecycle states: initialized, posed, proposed, challenged, reproposed, disputed or resolved, with active and arbitration also possible on rows returned for a condition. Some names echo the stages above, but none is defined.

While a market waits on an oracle, a row can also carry an expected settlement time in UTC and a field saying how it was worked out: the end of a challenge window, the earliest end of the voting round for a disputed market, or a proposal time plus a liveness window on what the pages call Polymarket's v2 oracle, which they do not describe further. Both fields are left out whenever no estimate applies, including settled markets and proposals under extended review. The reference also describes an extended review flag for a managed proposal that sits past its normal expiry. The Resolution page does not mention that state, and no page explains what "managed" means. Answers are cached, so a fresh proposal, dispute or expiry may take up to 5 seconds to show up.

Rows also flag whether a resolution was ever disputed and whether the question's rules changed after it was posed. Not every market follows the UMA path: Polymarket 101 says V2 markets can also use other resolution mechanisms, and a row names the reporter that resolved the condition. A V2 market's Gamma response has its own status field with the values inactive, active or resolved; the pUSD and Protocol V2 guide explains what a V2 market is.

PolyTerminal is an independent interface for Polymarket and is not operated or endorsed by Polymarket. Orders placed through PolyTerminal carry PolyTerminal’s Polymarket builder code, and PolyTerminal may charge a builder fee on top of Polymarket’s own fees. This page is educational and is not investment advice. Rules were compared with the official documentation on Oct 19, 2026; check the source before you act on a number.