Skip to main content
Fast-track release: this endpoint is available in the API now, while SDK helper methods are still pending.
Redeems winning conditional-token positions for a resolved market from a server-wallet sub-account.
  • Route: POST /portfolio/redeem
  • Auth: apiToken, Privy, or session auth
  • Scope: trading when using apiToken

​
Request body

FieldTypeRequiredDescription
conditionIdstringYesCTF condition id (bytes32 hex string).
onBehalfOfnumberNoManaged sub-account profile id (partner flow). Must be a child of the authenticated partner profile.

​
Example (HMAC)

curl -X POST "https://api.limitless.exchange/portfolio/redeem" \
  -H "content-type: application/json" \
  -H "lmts-api-key: <tokenId>" \
  -H "lmts-signature: <base64_hmac_sha256_signature>" \
  -H "lmts-timestamp: <iso_8601_timestamp>" \
  -d '{
    "conditionId": "0xa0ba8fd0acc2b86585734c07eb3bef4133f584d5abde78a558a6b8bfc3bbdec0",
    "onBehalfOf": 12345
  }'

​
Notes

  • Market must be resolved and the position must have redeemable balance.
  • API-level resolved status can appear before CTF settlement; on-chain payout must be posted before redemption succeeds.
  • Legacy API keys are not supported on server-wallet operations.