Skip to main content

Settlement & Claims

Once a market enters Settlement, the right sidebar shows the settlement panel headed by the Final Result (Yes / No). There are three kinds of rewards to claim, plus the creator's close operation.

Claim Market Reward (winning-token redemption)​

For anyone holding winning tokens (YES if the result is Yes, NO otherwise):

  1. the panel shows your winning-token balance and estimated USDC payout;
  2. click Claim to run ClaimMarketReward:
    • computes distributable = USDC vault balance − uncollected fees;
    • pays usdc_out = your amount × distributable / winning_supply;
    • burns your winning tokens and transfers USDC from the market PDA.

Normally each winning token redeems exactly 1 USDC. Losing tokens go to zero — no action needed.

Claim Dispute Reward (dispute stake settlement)​

Available only if this market had a dispute; claimed by the two dispute parties (ClaimDisputeReward):

Final resultWinnerReceives
Matches the disputer's claimDisputerOwn stake back + the creator's entire deposit
Original result upheldCreatorOwn deposit kept + the disputer's entire stake

One-time claim, marked complete afterwards.

Claim Vote Reward​

For winning-side voters (ClaimVoteReward):

reward = principal + principal × losing_pool / winning_pool

Paid from the dispute vault; your vote record account is closed and its rent refunded. The losing side has nothing to claim.

Close Market (creator only)​

After everyone has claimed, only the creator can call CloseMarket to liquidate the market and reclaim all account rent. The program requires seven preconditions (any failure aborts, guaranteeing no funds are destroyed):

  1. status is Settlement;
  2. YES vault balance is 0;
  3. NO vault balance is 0;
  4. USDC vault balance is 0;
  5. YES / NO mint supplies are 0 (all tokens burned);
  6. the market's deposit account balance is 0 (refunded or paid out);
  7. no uncollected fees on the order book.

It then closes the vaults, the deposit account (refunding any remaining deposit to the creator first), the order book and the market account, writing status Closed. The YES / NO mints remain forever (SPL mints cannot be closed) but their authority dies with the market.

Common Questions​

The market settled before I claimed my maker fills — what now? ClaimFunds works before and after settlement: withdraw first (receiving YES/NO/USDC), then claim settlement rewards on your holdings.

Do unclaimed rewards expire? There is no on-chain deadline, but market closure requires empty vaults — the creator must (and can only) wait for all claims. Please claim promptly.

What about an Invalid result? When the oracle value is abnormal the result is Invalid; the market stays in a retryable state and never settles until a valid result is submitted.