Combo Redemptions

Query terminal redemptions, post-resolution compression, and combo lineage across wallets.

Canonical reference: Combo Redemptions

This recipe turns a combo lifecycle record into a direct before-and-after answer. Polymarket’s public combo activity API identifies a REDEEM or COMPRESS operation and the legs on the reported combo. polynode additionally returns the source combo, removed legs, remaining legs, exact leg counts, and destination holding in the same row.

curl "https://api.polynode.dev/v3/combos/redemptions?redemption_scope=partial&limit=25" \
  -H "x-api-key: $POLYNODE_API_KEY"

To locate a post-resolution two-out-of-three transition from either side of its lineage, pass the original or reduced combo condition as condition_id. Use event_kind=Extracted separately for structural reduction without redemption evidence.

What happened in the redemption?

Use the count fields for the compact answer, then inspect the removed and remaining legs only when you need market details:

curl "https://api.polynode.dev/v3/combos/redemptions?tx_hash=0xe73ed3c24d1ca763984df61fad854479c45ea67b555ebaa547c994aa777add0c" \
  -H "x-api-key: $POLYNODE_API_KEY" \
  | jq '.redemptions[] | {
      tx_hash,
      redemption_scope,
      leg_transition,
      source_leg_count,
      removed_leg_count,
      remaining_leg_count,
      removed_legs: [.removed_legs[] | {
        leg_outcome_label,
        market_token_id,
        leg_result,
        leg_current_price,
        leg_price_source
      }],
      remaining_legs: [.remaining_legs[] | {
        leg_outcome_label,
        market_token_id,
        leg_result,
        leg_current_price,
        leg_price_source
      }],
      remaining_combo
    }'

• 3_to_0 with redemption_scope=full means the whole three-leg combo was redeemed.
• 3_to_2 with redemption_scope=partial means one leg was removed and a two-leg combo remained.
• remaining_combo.still_held tells you whether the wallet currently has a positive destination-combo balance when that balance is available.
• market_token_id is the standard token to pass to GET /v3/markets/{token_id}/price or GET /v1/orderbook/{token_id}.

For a UI, redemption_scope plus leg_transition is usually enough to display “full 3-leg redemption” or “5 legs became 1.” For analytics or automation, use source_position_id, destination_position_id, and the changed-leg arrays so no transition has to be inferred from titles or current position state.

To reconstruct multiple steps, fetch the wallet’s rows and follow each row’s source_position_id into a later row’s destination_position_id. This keeps each API item scoped to one redemption while still supporting lifecycle analysis across calls.