Redeem

POST/api/v1/orders/redeemBearer

Trading APIprice E4 · size E2 · amount E6 (integers)YES | NO

After resolution, holders of the winning token redeem at face value (1.0000 USD per share). 202 is fire-and-forget: the engine checks that the market is final and that you hold a winning position, and a rejection is equally silent — once you have called redeem the only observable outlet is GET /markets/{marketId}/redemption.

Send Authorization: Bearer <token>. The token is issued by POST /api/v1/auth/verify, and expires after 24h idle or 7d after issuance.

Request body

marketIdstringrequired
Id of the market to redeem in
Example"mkt-0001"

Response

202Command persisted

cursorstring
Read-your-writes continuation point
Example"c1:mkt-0001:184"
commandIdstring
Command identifier
Example"cmd_01K5H2M3N7Q8R9S1"

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X POST "$BASE_URL/api/v1/orders/redeem" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "marketId": "mkt-0001"
  }'

Response

Command persisted

{
  "cursor": "c1:mkt-0001:184",
  "commandId": "cmd_01K5H2M3N7Q8R9S1"
}