Skip to main content
POST
/
api
/
users
/
{userId}
/
redeem
curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "venue": "polymarket",
    "tokenId": "71321045679252212594626385..."
  }' \
  "https://trade.predexon.com/api/users/550e8400-e29b-41d4-a716-446655440000/redeem"

{
  "transactionHash": "0x1234567890abcdef...",
  "venue": "polymarket",
  "tokenId": "71321045679252...",
  "title": "Will Bitcoin reach $100k?",
  "outcome": "Yes",
  "sizeRedeemed": "100.50",
  "result": "won",
  "amountRedeemed": "100.50",
  "status": "completed"
}

curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "venue": "polymarket",
    "tokenId": "71321045679252212594626385..."
  }' \
  "https://trade.predexon.com/api/users/550e8400-e29b-41d4-a716-446655440000/redeem"

{
  "transactionHash": "0x1234567890abcdef...",
  "venue": "polymarket",
  "tokenId": "71321045679252...",
  "title": "Will Bitcoin reach $100k?",
  "outcome": "Yes",
  "sizeRedeemed": "100.50",
  "result": "won",
  "amountRedeemed": "100.50",
  "status": "completed"
}

​
Request Body

FieldTypeRequiredDescription
venuestringYes"polymarket" or "predict"
tokenIdstringYesOn-chain token ID of the position to redeem

​
Redemption Flow

1

Check positions

Use Get Positions to find positions with status: redeemable.
2

Verify result

Only positions with result: won return funds (USDC.e for Polymarket, USDT for Predict). Losing positions return 0.
3

Redeem

Call this endpoint with the position identifier.
4

Check balance

Funds are credited immediately - USDC.e for Polymarket, USDT for Predict. Verify with Get Balance.
You can redeem losing positions to clear them from your portfolio, but you’ll receive 0 since they’re worthless. After redeeming, use Withdraw to move funds to an external wallet.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
userId
string
required

Unique identifier for the user

Body

application/json
​
venue
enum<string>
required

Trading venue

Available options:
polymarket,
predict
​
tokenId
string
required

Token ID to redeem

Response

Position redeemed

​
transactionHash
string

Blockchain transaction hash for the redemption

​
venue
string

Trading venue where the redemption occurred

​
tokenId
string

Outcome token ID

​
title
string

Market question/title

​
outcome
string

The outcome side that was redeemed

​
sizeRedeemed
string

Number of shares redeemed

​
result
string

Position result: won or lost

​
amountRedeemed
string

Funds received from redemption - USDC.e or USDT (0 for losing positions)

​
status
string

Always 'completed' for successful redemptions