CTF

Redeem winning outcome tokens after resolution

After a market resolves on-chain, converts the winning outcome tokens into collateral. Only the winning side is needed (losing shares are worthless). NegRisk redeems unwrap wrapped collateral back to the base asset automatically. db_update_failed: true in the response means the on-chain redeem SUCCEEDED but the position-state bookkeeping write failed — funds are safe; retry the call to fix the bookkeeping. Failures return the structured OrderErrorResponse envelope — match on error_details.code.

POST

exchanges

{exchange_id}

redeem

Redeem winning outcome tokens after resolution

curl --request POST \
  --url https://execution.kairos.trade/exchanges/{exchange_id}/redeem \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '
{
  "condition_id": "0x1234abcd",
  "market_id": "570362"
}
'

import requests

url = "https://execution.kairos.trade/exchanges/{exchange_id}/redeem"

payload = {
    "condition_id": "0x1234abcd",
    "market_id": "570362"
}
headers = {
    "X-Client-Id": "<api-key>",
    "X-Api-Key": "<api-key>",
    "X-Api-Secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Client-Id': '<api-key>',
    'X-Api-Key': '<api-key>',
    'X-Api-Secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({condition_id: '0x1234abcd', market_id: '570362'})
};

fetch('https://execution.kairos.trade/exchanges/{exchange_id}/redeem', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://execution.kairos.trade/exchanges/{exchange_id}/redeem",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'condition_id' => '0x1234abcd',
    'market_id' => '570362'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Api-Key: <api-key>",
    "X-Api-Secret: <api-key>",
    "X-Client-Id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://execution.kairos.trade/exchanges/{exchange_id}/redeem"

	payload := strings.NewReader("{\n  \"condition_id\": \"0x1234abcd\",\n  \"market_id\": \"570362\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Client-Id", "<api-key>")
	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("X-Api-Secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://execution.kairos.trade/exchanges/{exchange_id}/redeem")
  .header("X-Client-Id", "<api-key>")
  .header("X-Api-Key", "<api-key>")
  .header("X-Api-Secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"condition_id\": \"0x1234abcd\",\n  \"market_id\": \"570362\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://execution.kairos.trade/exchanges/{exchange_id}/redeem")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Client-Id"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"condition_id\": \"0x1234abcd\",\n  \"market_id\": \"570362\"\n}"

response = http.request(request)
puts response.read_body

{
  "amount_redeemed": "100",
  "success": true,
  "tx_hash": "0xabc123",
  "db_update_failed": true
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "Unauthorized"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

Authorizations

X-Client-Id

string

header

required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key

string

header

required

64-char hex API key.

X-Api-Secret

string

header

required

64-char hex API secret.

Path Parameters

exchange_id

enum<string>

required

Venue. Split/merge require an on-chain CTF (polymarket, predictfun). Kalshi settles off-exchange — redeem only.

Available options:

polymarket,

predictfun,

kalshi,

opinion

Body

application/json

condition_id

string

required

CTF conditionId of the RESOLVED market.

Example:

"0x1234abcd"

position_id

string | null

Position row to mark redeemed after success.

market_id

string | null

Locates the position when position_id is omitted.

token_id

string | null

Locates the position when position_id is omitted.

user_id

string | null

Optional. Must match the authenticated caller when present — identity is resolved server-side and these fields can never widen scope to another user.

turnkey_org_id

string | null

Optional. Must match the authenticated caller when present.

wallet_address

string | null

Optional wallet override; honored only if the wallet is owned by the caller. Omit to let the server resolve the signer wallet.

Response

Redeem executed on-chain.

amount_redeemed

string

required

Decimal string — rust_decimal always serializes as a string.

Example:

"100"

success

boolean

required

tx_hash

string | null

On-chain transaction hash. null when no transaction was produced — always check success.

Example:

"0xabc123"

db_update_failed

boolean

OMITTED entirely when false (skip_serializing_if). Present and true only when the on-chain redeem succeeded but the bookkeeping write failed after retries — funds are safe, retry to fix bookkeeping.

Redeem winning outcome tokens after resolution

curl --request POST \
  --url https://execution.kairos.trade/exchanges/{exchange_id}/redeem \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '
{
  "condition_id": "0x1234abcd",
  "market_id": "570362"
}
'

import requests

url = "https://execution.kairos.trade/exchanges/{exchange_id}/redeem"

payload = {
    "condition_id": "0x1234abcd",
    "market_id": "570362"
}
headers = {
    "X-Client-Id": "<api-key>",
    "X-Api-Key": "<api-key>",
    "X-Api-Secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Client-Id': '<api-key>',
    'X-Api-Key': '<api-key>',
    'X-Api-Secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({condition_id: '0x1234abcd', market_id: '570362'})
};

fetch('https://execution.kairos.trade/exchanges/{exchange_id}/redeem', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://execution.kairos.trade/exchanges/{exchange_id}/redeem",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'condition_id' => '0x1234abcd',
    'market_id' => '570362'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Api-Key: <api-key>",
    "X-Api-Secret: <api-key>",
    "X-Client-Id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://execution.kairos.trade/exchanges/{exchange_id}/redeem"

	payload := strings.NewReader("{\n  \"condition_id\": \"0x1234abcd\",\n  \"market_id\": \"570362\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Client-Id", "<api-key>")
	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("X-Api-Secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://execution.kairos.trade/exchanges/{exchange_id}/redeem")
  .header("X-Client-Id", "<api-key>")
  .header("X-Api-Key", "<api-key>")
  .header("X-Api-Secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"condition_id\": \"0x1234abcd\",\n  \"market_id\": \"570362\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://execution.kairos.trade/exchanges/{exchange_id}/redeem")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Client-Id"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"condition_id\": \"0x1234abcd\",\n  \"market_id\": \"570362\"\n}"

response = http.request(request)
puts response.read_body

{
  "amount_redeemed": "100",
  "success": true,
  "tx_hash": "0xabc123",
  "db_update_failed": true
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "Unauthorized"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

{
  "error": "<string>",
  "error_details": {
    "code": "FUNDS_INSUFFICIENT_USDC",
    "message": "<string>",
    "actions": [
      {
        "action": "enable_trading",
        "label": "Add Funds",
        "primary": true,
        "url": "<string>"
      }
    ],
    "details": "<string>",
    "metadata": {}
  },
  "code": "<string>"
}

Overview

Market Data API

Data API

Execution API

Agora Auction API

REST Guides

Market Data Guides

RPC Guides

RFQ Guides

WebSocket Guides

Krisis Guides

Redeem winning outcome tokens after resolution

Authorizations

Path Parameters

Body

Response