Skip to main content

Batch Redeem (PREDICTION_TRADE)

API Description

Redeem one or more settled prediction tokens on-chain to claim winnings. Requires SAS authorization.

HTTP Request

POST /sapi/v1/w3w/wallet/prediction/batch-redeem

Request Weight(IP)

200

Request Parameters

NameTypeMandatoryDescription
walletAddressSTRINGYESUser's prediction wallet address
walletIdSTRINGYESWallet ID
tokenIdsLISTYESList of prediction token IDs to redeem. Not empty. Example: tokenIds=112233&tokenIds=112234
chainIdSTRINGNOChain ID. Default: 56 (BSC)

Response Example

{
"batchId": "batch_20260525_redeem_001",
"results": [
{
"requestId": "req_001",
"txHash": "0xabc123def456789abcdef123456789abcdef123456789abcdef123456789abcd",
"status": "PENDING",
"error": null
},
{
"requestId": "req_002",
"txHash": null,
"status": "FAILED",
"error": "Insufficient balance"
}
]
}