Wallet Redemptions

Get all direct and AutoRedeemer-attributed payout redemptions for a wallet.

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.

Owner addresses. Pass an owner EOA as the wallet address and the response combines the EOA’s Polymarket wallets (Safe, proxy, deposit wallets) that have data for this endpoint. Passing a Safe, proxy or deposit wallet returns just that wallet, as before. Combined responses list the combined wallets in wallets. See Owner addresses.

​

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.

​

Owner address fields

Present only when you pass an owner EOA. See Owner addresses.

Field	Type	Description
wallets	array	The combined wallets, in a fixed order, each {wallet, type} with type one of eoa, safe, proxy, or deposit_wallet
data[].wallet	string	The wallet this row belongs to