KAkairos
Combo

Redeem a resolved, winning combo back to pUSD

The settlement path a cash-out cannot cover: once every leg has resolved there is no maker to sell to, so a winning combo is redeemed on-chain instead. Executed as a Polymarket relayer WALLET batch (approve the combo Router as operator, then redeem), signed by the deposit wallet's owner EOA through the user's delegated Turnkey key. Kairos deposit wallets only. Imported and plain-EOA makers get a 400 — the direct redemption path for them is not built yet. Idempotent by construction. The amount comes from the position's real on-chain share balance, never from the request, and the call is validated against GET /combo/positions first. A retry after a successful redeem sees a zero balance and is rejected, rather than firing a second batch that would revert on-chain while the client reads "redeemed". Auth & scope. Requires trade:execute for polymarket, the mutation gate, and a current Turnkey policy version for the combo-redeem capability specifically (403 AUTH_POLICY_OUTDATED if stale).

post/combo/redeem

Request

  • Base URL
    https://execution.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Request body

comboConditionIdstring required

The resolved combo's comboConditionId (31-byte hex) from GET /combo/positions. The amount redeemed is always the position's real on-chain share balance — never caller-supplied — so a wrong or stale value cannot over- or under-redeem.

outcomeIndexinteger nullable

Winning outcome side; 0 = YES (all legs won). Defaults to 0.

Response

The redemption batch was mined.

batchTxIdstring required

The Polymarket relayer batch id for the redemption.

amountE6string required

Amount redeemed, six-decimal fixed-point integer string.

statusstring required

Changes

No recorded changes to this operation across all 1 revision of this API.