Skip to main content
POST
Redeem Settlement Rewards
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

string
required
Resolved market condition ID, or a Polymarket marketId that maps to a conditionId via the markets table. Max 250 chars.
string
required
Outcome side to redeem: yes / no (case-insensitive — YES / NO are also accepted).
string
default:"polymarket"
Trading venue identifier. Default: polymarket.
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

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