Skip to main content
POST
/
markets
/
redeem
Redeem Settlement Rewards
curl --request POST \
  --url https://www.aionmarket.com/bvapi/markets/redeem \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketId": "<string>",
  "side": "yes",
  "venue": "polymarket",
  "walletAddress": "<string>"
}
'
{
  "code": 200,
  "message": "success",
  "data": {
    "success": true,
    "txHash": "<string>",
    "unsignedTx": {},
    "error": "<string>",
    "walletAddress": "<string>",
    "conditionId": "<string>",
    "side": "<string>",
    "redeemablePositions": 123,
    "collateralToken": "<string>",
    "collateralSymbol": "<string>"
  }
}

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

​
marketId
string
required
Resolved market condition ID, or a Polymarket marketId that maps to a conditionId via the markets table. Max 250 chars.
​
side
string
required
Outcome side to redeem: yes / no (case-insensitive — YES / NO are also accepted).
​
venue
string
default:"polymarket"
Trading venue identifier. Default: polymarket.
​
walletAddress
string
Optional agent wallet address. The agent is resolved from the Bearer API key; only provide this when the agent has multiple linked wallets.

​
Response

​
data
object
Redemption result.

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
marketId
string
required

Market ID (condition ID or Polymarket market ID)

Maximum string length: 250
​
side
enum<string>
required

Redemption side

Available options:
yes,
no,
YES,
NO
​
venue
string
default:polymarket

Trading venue (default: polymarket)

Maximum string length: 50
​
walletAddress
string

Wallet address for multi-wallet scenarios (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$

Response

200 - application/json

Redeem accepted

​
code
integer
Example:

200

​
message
string
Example:

"success"

​
data
object