Settlement & Payouts

What happens when a market resolves and how winners get paid.

The settlement process

When the oracle confirms an outcome, settlement runs automatically:

Outcome confirmed (YES or NO)
    ↓
settle_market() RPC executes atomically on Solana
    ↓
For each winning position:
  locked balance released
  $1.00 per share credited to available balance
    ↓
For each losing position:
  locked balance released at $0
    ↓
Market marked Resolved

Payout amount

Payout is in the same currency you used to buy shares.

Example

You buy 50 YES shares at 40¢ each:

• Cost: 50 × $0.40 = $20.00
• These $20 are locked while the market is open

If YES wins:

• 50 × $1.00 = $50.00 credited to available balance
• Profit: $30.00

If NO wins:

• Locked balance of $20.00 is released at $0
• Loss: $20.00

When does my balance update?

Your available balance updates immediately after settle_market() runs. You can see the updated balance in Portfolio and withdraw it right away.

Settlement typically runs within 10–20 minutes of the resolution being confirmed by the oracle.

Weighted average position

If you made multiple trades on the same market and side, your shares are tracked as a single combined position with a weighted average entry price.

Example:

• Trade 1: 10 YES shares at 30¢ → cost $3.00
• Trade 2: 20 YES shares at 45¢ → cost $9.00
• Combined: 30 YES shares, avg entry 40¢, total cost $12.00

If YES wins: 30 × $1.00 = $30.00 (profit: $18.00)

Tied markets (fee races)

If a fee race market ends with equal deltas for both tokens, the oracle cannot determine a winner automatically. The market enters Needs Review.

An admin reviews the data and may:

• Confirm the tie and void the market (all stakes refunded)
• Identify a tiebreaker (only if specified in the resolution rule)

The default behavior for ties is void and refund.