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

# Redeem Settlement Rewards

> Redeem winnings from a resolved market.

Redeem settlement rewards for a resolved market. When a market resolves, winning outcome tokens can be redeemed for USDC. This endpoint triggers the on-chain redemption process.

## Request Body

<ParamField body="marketId" type="string" required>
  Resolved market condition ID, or a Polymarket `marketId` that maps to a `conditionId` via the markets table. Max 250 chars.
</ParamField>

<ParamField body="side" type="string" required>
  Outcome side to redeem: `yes` / `no` (case-insensitive — `YES` / `NO` are also accepted).
</ParamField>

<ParamField body="venue" type="string" default="polymarket">
  Trading venue identifier. Default: `polymarket`.
</ParamField>

<ParamField body="walletAddress" type="string">
  Optional agent wallet address. The agent is resolved from the Bearer API key; only provide this when the agent has multiple linked wallets.
</ParamField>

## Response

<ResponseField name="data" type="object">
  Redemption result.

  <Expandable title="RedeemResponse">
    <ResponseField name="success" type="boolean">
      Whether the redemption succeeded.
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount of USDC redeemed.
    </ResponseField>

    <ResponseField name="transactionHash" type="string">
      On-chain transaction hash of the redemption.
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml POST /markets/redeem
openapi: 3.1.0
info:
  title: Aion AI Agent API
  description: >-
    API for agent registration, wallet onboarding, market discovery, order
    management, and execution on Aion.
  version: 1.0.0
  contact:
    name: Aion Support
    email: info@aionmarket.com
    url: https://docs.aionmarket.com
servers:
  - url: https://www.aionmarket.com/bvapi
    description: Aion API
security:
  - bearerAuth: []
tags:
  - name: Agent Management
  - name: Market Operations
  - name: Order Management
  - name: Trading
  - name: Kalshi
  - name: Skills
  - name: Wallet Management
  - name: Trades & Leaderboard
  - name: Utilities
  - name: Settings
  - name: Positions & Portfolio
  - name: Fee Charging
paths:
  /markets/redeem:
    post:
      tags:
        - Trading
      summary: Redeem Settlement Rewards
      description: >-
        Claim settlement rewards for a resolved market. Returns an unsigned
        transaction for client-side signing.
      operationId: redeemRewards
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RedeemRequest'
      responses:
        '200':
          description: Redeem accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RedeemResponse'
components:
  schemas:
    RedeemRequest:
      type: object
      required:
        - marketId
        - side
      properties:
        marketId:
          type: string
          description: Market ID (condition ID or Polymarket market ID)
          maxLength: 250
        side:
          type: string
          description: Redemption side
          enum:
            - 'yes'
            - 'no'
            - 'YES'
            - 'NO'
        venue:
          type: string
          description: 'Trading venue (default: polymarket)'
          default: polymarket
          maxLength: 50
        walletAddress:
          type: string
          description: >-
            Wallet address for multi-wallet scenarios (0x-prefixed, 40 hex
            chars)
          pattern: ^0x[a-fA-F0-9]{40}$
    RedeemResponse:
      type: object
      properties:
        code:
          type: integer
          example: 200
        message:
          type: string
          example: success
        data:
          type: object
          properties:
            success:
              type: boolean
              description: Whether the redeem request was built successfully
            txHash:
              type: string
              nullable: true
              description: On-chain transaction hash (usually null; client signs)
            unsignedTx:
              type: object
              nullable: true
              description: Unsigned transaction for client-side signing and broadcasting
            error:
              type: string
              nullable: true
              description: Error message (null on success)
            walletAddress:
              type: string
              description: Wallet address used for redemption
            conditionId:
              type: string
              description: Resolved condition ID (32-byte hex)
            side:
              type: string
              description: Redemption side (YES or NO)
            redeemablePositions:
              type: number
              description: Number of redeemable positions detected
            collateralToken:
              type: string
              description: Collateral token address
            collateralSymbol:
              type: string
              description: Collateral token symbol (e.g. USDC)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-default: YOUR_API_KEY

````