> ## 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

> All onchain redemptions for a wallet. See who cashed out, when, and how much.

Returns every onchain redemption for a wallet. A redemption is when a user claims their payout after a market resolves. This data is not available through Polymarket's API. Each redemption is enriched with market metadata.

## Request

```
GET /v2/onchain/wallets/{address}/redemptions?limit=100&offset=0
```

| Parameter | Type    | Location | Description                                |
| --------- | ------- | -------- | ------------------------------------------ |
| `address` | string  | path     | Wallet address (0x-prefixed, 40 hex chars) |
| `limit`   | integer | query    | Max results (default 100, max 1000)        |
| `offset`  | integer | query    | Skip first N results for pagination        |

## Response

```json theme={null}
{
  "wallet": "0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa",
  "source": "onchain",
  "count": 1,
  "offset": 0,
  "total_payout": 5,
  "redemptions": [
    {
      "id": "0x655555bc5091e07a453667c20afe4af5df2e099311670abf86a718dc48998b53_0x678",
      "timestamp": 1774749134,
      "condition": "0xedb2d159f7917cedf2ca9fe5b2fe70ba5db7fee23eff951ce8d7f96983cf6a66",
      "index_sets": ["1", "2"],
      "payout": 5,
      "market": "Bitcoin Up or Down - March 28, 9:45PM-9:50PM ET",
      "slug": "btc-updown-5m-1774748700",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png"
    }
  ]
}
```

| Field                      | Type   | Description                                       |
| -------------------------- | ------ | ------------------------------------------------- |
| `total_payout`             | number | Sum of all payout amounts (USDC) in this page     |
| `redemptions[].timestamp`  | number | Unix timestamp of the redemption                  |
| `redemptions[].condition`  | string | Condition ID of the resolved market               |
| `redemptions[].index_sets` | array  | Outcome index sets redeemed                       |
| `redemptions[].payout`     | number | USDC payout amount (0 = losing position redeemed) |
| `redemptions[].market`     | string | Market question                                   |
| `redemptions[].slug`       | string | Market slug                                       |
| `redemptions[].image`      | string | Market image URL                                  |

## Example

```bash theme={null}
curl "https://api.polynode.dev/v2/onchain/wallets/0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa/redemptions?limit=10" \
  -H "x-api-key: YOUR_KEY"
```


## OpenAPI

````yaml GET /v2/onchain/wallets/{address}/redemptions
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v2/onchain/wallets/{address}/redemptions:
    get:
      tags:
        - Onchain
      summary: Wallet redemptions (onchain)
      description: All onchain redemptions for a wallet.
      operationId: onchain_wallet_redemptions
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
          description: Wallet address
        - name: limit
          in: query
          schema:
            type: integer
            default: 100
          description: Max results (max 1000)
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
          description: Skip first N results
      responses:
        '200':
          description: Redemptions
        '401':
          description: Unauthorized
      security:
        - apiKey: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````