Redemption Event

Position payout redemptions on Polymarket.

Emitted when a user redeems their outcome tokens for collateral after a market resolves. The redeemPositions function on the Conditional Tokens contract burns the user’s shares and pays out USDC based on the resolved outcome.

Every resolved market generates redemption events as holders claim their payouts. A non-zero payout means the user held winning shares. A zero payout means the user redeemed losing shares (no collateral returned).

Recent redemption events also include the market’s resolved payout vector when available. Use winning_outcome, winning_token_id, or the ordered payouts / outcome_prices arrays to identify which outcome won without making a second market lookup.

{
  "data": {
    "block_number": 85244342,
    "collateral_token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
    "condition_id": "0x487f28579354d6c4408eea243888cdedbe03e83a219a4708523ef455dcbc5e31",
    "event_title": "Bitcoin Up or Down - April 7, 8:15PM-8:20PM ET",
    "event_type": "redemption",
    "index_sets": [1, 2],
    "log_index": 1282,
    "market_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
    "market_slug": "btc-updown-5m-1775607300",
    "market_title": "Bitcoin Up or Down - April 7, 8:15PM-8:20PM ET",
    "neg_risk": false,
    "outcome_prices": [1.0, 0.0],
    "outcomes": ["Up", "Down"],
    "payout": 7.566434,
    "payouts": [1, 0],
    "redeemer": "0x8858aae9c92a82b00986a0f1a66338e8b0cc8641",
    "taker_base_fee": 1000,
    "tick_size": 0.01,
    "timestamp": 1775608721000,
    "token_ids": [
      "81518481532502107093994258923994884503752044066839262771005198927094175386674",
      "112731399428633109059368520083498445904538970112239739400592554575174180266461"
    ],
    "tokens": {
      "112731399428633109059368520083498445904538970112239739400592554575174180266461": "Down",
      "81518481532502107093994258923994884503752044066839262771005198927094175386674": "Up"
    },
    "tx_hash": "0xcfb51c25a8f6ebb0b5a7484de7812d66f2cbf9935f29c0b56561e74722c64fac",
    "winning_outcome": "Up",
    "winning_outcome_index": 0,
    "winning_token_id": "81518481532502107093994258923994884503752044066839262771005198927094175386674"
  },
  "timestamp": 1775608721000,
  "type": "redemption"
}

Fields

type · string · required

Always "redemption".

timestamp · number · required

Block timestamp in Unix milliseconds.

data · object · required

Show data fields

tx_hash · string · required

Transaction hash.

block_number · number · required

Block number.

log_index · number · required

Log index within the transaction.

timestamp · number · required

Block timestamp in Unix milliseconds.

redeemer · string · required

Address that redeemed positions. This is the wallet that held the outcome tokens and called redeemPositions.

collateral_token · string · required

Collateral token address. USDC.e (0x2791bca1f2de4661ed88a30c99a7a9449aa84174) for standard markets.

condition_id · string · required

Market condition ID — identifies which resolved market’s positions were redeemed.

index_sets · number[] · required

Which outcome slots were redeemed. [1] = first outcome only, [2] = second outcome only, [1, 2] = both outcomes. Most redemptions include all outcomes ([1, 2]).

payout · number · required

USDC amount paid out to the redeemer (6 decimal precision). 0 means the user redeemed losing shares and received nothing.

market_title · string

Human-readable market question. Enriched from metadata.

market_slug · string

URL slug for the market.

market_image · string

Market image URL. Enriched from metadata.

event_title · string

Parent event title. Enriched from metadata.

neg_risk · boolean

Whether this market uses the negRisk contract type. Enriched from metadata.

tick_size · number

Minimum price increment (e.g. 0.01 or 0.001). Enriched from metadata.

taker_base_fee · number

Taker fee rate in basis points. 200 = 2%, 1000 = 10%, null = no fee. Enriched from Polymarket metadata.

tokens · object

Map of token ID to outcome name for all outcomes in this market. Enriched from metadata.

token_ids · string[]

Ordered token IDs for this market. Same order as outcomes, payouts, and outcome_prices.

outcomes · string[]

Ordered outcome labels for this market. Same order as token_ids, payouts, and outcome_prices.

payouts · number[]

Resolved payout numerators for each outcome. Binary markets usually resolve to [1, 0] or [0, 1].

outcome_prices · number[]

Normalized payout value for each outcome. Binary winners are 1.0, losing outcomes are 0.0; split outcomes can be fractional.

winning_outcome_index · number

Index of the winning outcome when exactly one outcome has a non-zero payout.

winning_outcome · string

Label of the winning outcome when exactly one outcome has a non-zero payout.

winning_token_id · string

Token ID of the winning outcome when exactly one outcome has a non-zero payout.

Use cases

• Payout tracking — monitor who is cashing out resolved positions and how much they receive
• Wallet PnL — combine with trade data to calculate realized profit/loss per wallet
• Market lifecycle — track the full arc from trading to resolution to redemption
• Winning wallet alerts — filter for large payout values to spot big winners as they redeem
• Outcome-aware automations — use winning_outcome or outcome_prices directly instead of waiting on slower market metadata refreshes

Subscribing

{
  "action": "subscribe",
  "type": "settlements",
  "filters": {
    "event_types": ["redemption"]
  }
}

Filter to only winning redemptions using min_size:

{
  "action": "subscribe",
  "type": "settlements",
  "filters": {
    "event_types": ["redemption"],
    "min_size": 0.01
  }
}

Track redemptions for specific wallets:

{
  "action": "subscribe",
  "type": "wallets",
  "filters": {
    "wallets": ["0x8858aae9c92a82b00986a0f1a66338e8b0cc8641"],
    "event_types": ["redemption"]
  }
}