> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Redemptions

> Get all redemption events for a wallet. Redemptions occur when a wallet claims payouts from resolved markets.

Returns redemption events where the wallet claimed payouts from resolved market conditions.
Rows are enriched with market and resolution metadata when available so clients can identify
the winning outcome without a second market lookup. The original 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                    |

## Example

```bash theme={null}
curl https://api.polynode.dev/v3/wallets/0x56687bf447db6ffa42ffe2204a05edaa20f55839/redemptions?limit=1
```

```json theme={null}
{
  "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"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "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             | Which outcome index sets were redeemed                                                                                     |
| `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.                             |