Wallet Redemptions

Returns all indexed redemption events attributed to the wallet across direct Conditional Tokens, negative-risk, and AutoRedeemer execution paths. AutoRedeemer rows use the beneficiary wallet rather than the protocol contract address, so the result remains complete when the protocol submits the underlying claim. Direct and AutoRedeemer rows are merged across all time before sorting and pagination. Every row includes transaction_hash, block_number, log_index, redemption_source, and source_event. Rows are enriched with market and resolution metadata when available so clients can identify the winning outcome without a second market lookup. Existing response fields remain present and unchanged.

Request

GET /v3/wallets/{address}/redemptions

Query parameters

Parameter	Type	Default	Description
`after`	integer	—	Start of time range (Unix timestamp)
`before`	integer	—	End of time range
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset
`order`	string	`desc`	Sort order: `asc` or `desc`

Example

curl https://api.polynode.dev/v3/wallets/0x56687bf447db6ffa42ffe2204a05edaa20f55839/redemptions?limit=1

{
  "data": [
    {
      "id": "0x6173027f191670852e049df6ded0b353069a531f5ea647220bdcb64ab634348e_cac",
      "timestamp": "1776731610",
      "condition": "0x19be7c46e28b61455ec766679ee1122fba39eb0d5c85d0878e4b203ab8b18406",
      "payout": "4078910900",
      "index_sets": ["1", "2"],
      "condition_id": "0x19be7c46e28b61455ec766679ee1122fba39eb0d5c85d0878e4b203ab8b18406",
      "payout_e6": "4078910900",
      "payout_usdc": 4078.9109,
      "market_title": "Will John Ternus be the next CEO of Apple?",
      "market_slug": "will-john-ternus-be-the-next-ceo-of-apple",
      "market_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/next-ceo-of-apple-leUfWn-_USCO.jpg",
      "event_title": "Next CEO of Apple?",
      "event_slug": "next-ceo-of-apple",
      "neg_risk": true,
      "token_ids": [
        "92311850691119989700494243314039291208974625045063458908184129720108035114164",
        "14954786464025422340381119759227166561985048022429770302259194276382916274663"
      ],
      "outcomes": ["Yes", "No"],
      "payouts": [1.0, 0.0],
      "outcome_prices": [1.0, 0.0],
      "winning_outcome_index": 0,
      "winning_outcome": "Yes",
      "winning_token_id": "92311850691119989700494243314039291208974625045063458908184129720108035114164",
      "resolved_at": "2026-05-28T04:49:07.589252+00:00",
      "transaction_hash": "0x6173027f191670852e049df6ded0b353069a531f5ea647220bdcb64ab634348e",
      "redemption_source": "direct_neg_risk",
      "source_event": "NegRiskAdapter.PayoutRedemption",
      "block_number": 85805783,
      "log_index": 3244
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "next_offset": 1,
  "offset": 0,
  "limit": 1,
  "order": "desc",
  "source": "v3.wallet_redemptions_unified",
  "elapsed_ms": 3
}

Response fields

Field	Type	Description
`id`	string	Redemption event ID
`timestamp`	string	Unix timestamp
`condition`	string	Market condition ID that was redeemed
`payout`	string	Exact raw payout amount in six-decimal integer units. Preserved for backwards compatibility.
`index_sets`	array \| null	Which outcome index sets were redeemed. AutoRedeemer lifecycle rows may not expose this value.
`condition_id`	string	Alias of `condition`, matching the WebSocket redemption payload naming.
`payout_e6`	string	Alias of `payout`; exact six-decimal payout amount for accounting-safe comparisons.
`payout_usdc`	number	Human-readable payout amount in USDC.
`market_title`	string \| null	Human-readable market question.
`market_slug`	string \| null	Market slug.
`market_image`	string \| null	Market image URL.
`event_title`	string \| null	Parent event title, when available.
`event_slug`	string \| null	Parent event slug, when available.
`neg_risk`	boolean \| null	Whether the market uses Polymarket negative-risk settlement.
`token_ids`	string[] \| null	Ordered market token IDs. Same order as `outcomes`, `payouts`, and `outcome_prices`.
`outcomes`	string[] \| null	Ordered outcome labels for the market.
`payouts`	number[] \| null	Resolved payout numerators for each outcome, when resolution metadata is available.
`outcome_prices`	number[] \| null	Payouts normalized by the payout denominator. Winners are usually `1.0`; losers are usually `0.0`.
`winning_outcome_index`	number \| null	Index of the winning outcome when exactly one outcome has a non-zero payout, or when metadata already provides the winner.
`winning_outcome`	string \| null	Label of the winning outcome.
`winning_token_id`	string \| null	Token ID of the winning outcome.
`resolved_at`	string \| null	ISO timestamp for when the market resolution metadata indicates the condition became resolved.
`transaction_hash`	string	Polygon transaction hash containing the redemption event.
`redemption_source`	string	Normalized execution path: `direct_ctf`, `direct_neg_risk`, `direct_other`, `auto_binary`, `auto_neg_risk`, or `auto_combo`.
`source_event`	string	Exact protocol event family used to attribute the redemption.
`block_number`	integer	Polygon block containing the source event.
`log_index`	integer	Source event log index. Combine with `transaction_hash` for an exact event identity.

AutoRedeemer binary and negative-risk rows carry the market condition directly. Generic combo redemptions resolve their condition through the canonical combo redemption mapping. A transaction can contain multiple legitimate redemption events, so clients should identify rows by transaction_hash plus log_index, not by payout amount.

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Wallet Redemptions

Request

Query parameters

Example

Response fields

​Request

​Query parameters

​Example

​Response fields

Request

Query parameters

Example

Response fields