Redemption Event

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. This is the comprehensive redemption event class. It includes direct Conditional Tokens redemptions and PM2 AutoRedeemer payouts for normal Binary/NegRisk positions and generic combo positions. For AutoRedeemer transactions, redeemer is the user wallet from the AutoRedeemer log, not the contract, and source identifies the route.

{
  "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,
    "payout_e6": "7566434",
    "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

string

required

Always "redemption".

number

required

Block timestamp in Unix milliseconds.

object

required

Show data fields

string

required

Transaction hash.

number

required

Block number.

number

required

Log index within the transaction.

number

required

Block timestamp in Unix milliseconds.

string

required

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

string

required

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

string

required

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

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]).

number

required

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

string

Exact payout amount in six-decimal integer units. Use this for accounting-safe comparisons.

string

Decoder path for bridged redemptions. AutoRedeemer.BinaryRedemption and AutoRedeemer.NegRiskRedemption identify normal Binary/NegRisk AutoRedeemer payouts; AutoRedeemer.Redemption identifies the generic combo AutoRedeemer route. Direct Conditional Tokens redemptions do not use an AutoRedeemer source.

string

Human-readable market question. Enriched from metadata.

string

URL slug for the market.

string

Market image URL. Enriched from metadata.

string

Parent event title. Enriched from metadata.

boolean

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

number

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

number

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

object

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

string[]

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

string[]

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

number[]

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

number[]

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

number

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

string

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

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

Subscribe directly to redemptions:

{
  "action": "subscribe",
  "type": "redemptions"
}

Or request redemptions from the settlement stream:

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

To receive combo redemptions only, subscribe to type: "combos" with event_types: ["combo_lifecycle"] and action: "Redeem". If you subscribe to both surfaces, a generic combo AutoRedeemer payout can appear in both shapes; correlate or deduplicate it with tx_hash and log_index. 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"]
  }
}

Real-time Streaming

Event Reference

Perps Streaming

More

Fields

Use cases

Subscribing

​Fields

​Use cases

​Subscribing

Fields

Use cases

Subscribing