Trade plans (preview)

Commit a trade plan for execution

Preview: available on staging (https://staging-execution.kairos.trade); production returns 503 until release.

Commits the plan: Kairos checks balances, reserves tradeBudget.maxDebitRaw at the destination (and funding.amountInRaw at the source when funded) against the wallet’s other plans, then runs it. The body is the same as /answers; answers may be empty when every signature was already posted. Call it before executeBefore.

Result: trade_pending (no funding) or funding_pending (execution.fundingStatus pending, or awaiting_client when submission.funding is client). Calling it again after a successful commit returns the current plan with no new effect.

Client-owned funding. After committing, POST each signed permit yourself to requests[].externalSubmission.endpoint (funding-1 first), then report it with POST /v3/trade-plans/{id}/reports.

POST

trade-plans

{id}

execute

Commit a trade plan for execution

curl --request POST \
  --url https://execution.kairos.trade/v3/trade-plans/{id}/execute \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Kairos-Partner-Id: <api-key>' \
  --data '
{
  "planHash": "0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953",
  "answers": []
}
'

import requests

url = "https://execution.kairos.trade/v3/trade-plans/{id}/execute"

payload = {
    "planHash": "0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953",
    "answers": []
}
headers = {
    "X-Kairos-Partner-Id": "<api-key>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Kairos-Partner-Id': '<api-key>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    planHash: '0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953',
    answers: []
  })
};

fetch('https://execution.kairos.trade/v3/trade-plans/{id}/execute', 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/v3/trade-plans/{id}/execute",
  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([
    'planHash' => '0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953',
    'answers' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "X-Kairos-Partner-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/v3/trade-plans/{id}/execute"

	payload := strings.NewReader("{\n  \"planHash\": \"0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953\",\n  \"answers\": []\n}")

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

	req.Header.Add("X-Kairos-Partner-Id", "<api-key>")
	req.Header.Add("Authorization", "<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/v3/trade-plans/{id}/execute")
  .header("X-Kairos-Partner-Id", "<api-key>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"planHash\": \"0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953\",\n  \"answers\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://execution.kairos.trade/v3/trade-plans/{id}/execute")

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

request = Net::HTTP::Post.new(url)
request["X-Kairos-Partner-Id"] = '<api-key>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"planHash\": \"0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953\",\n  \"answers\": []\n}"

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

{
  "contractVersion": 1,
  "id": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
  "planHash": "0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953",
  "revision": "0",
  "wallet": "0x8ba1f109551bd432803012645ac136ddd64dba72",
  "partnerId": "acme",
  "audience": "https://staging-execution.kairos.trade",
  "interactionMode": "single_batch",
  "submission": {
    "funding": "kairos",
    "trade": "kairos"
  },
  "status": "needs_signatures",
  "venue": "polymarket",
  "tradeExecutionRegion": "opaque-region-id",
  "order": {
    "market": "polymarket:0x5f3a8e1c2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6a",
    "outcome": "Yes",
    "side": "buy",
    "price": "0.05",
    "size": "10",
    "timeInForce": "GTC",
    "postOnly": true,
    "clientOrderId": "partner-trade-1042"
  },
  "tradingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
  "tradePayloadDigest": "0xa3612e136ad81349bbc469dbc02ebd85d3cfcd3f76f90fc06a5c33d6bd03a67a",
  "tradeBudget": {
    "collateral": {
      "kind": "evm",
      "chainId": "137",
      "token": "0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb"
    },
    "decimals": 6,
    "notionalRaw": "500000",
    "maxCollateralFeeRaw": "16750",
    "maxPlatformFeeBps": 75,
    "maxDebitRaw": "516750",
    "existingSpendableRaw": "0",
    "partnerFee": {
      "scheduleId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
      "maxBps": 25,
      "maker": {
        "model": "flat",
        "bps": 10
      },
      "taker": {
        "model": "flat",
        "bps": 25
      }
    }
  },
  "funding": {
    "sourceChainId": "42161",
    "sourceToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
    "sourceDecimals": 6,
    "quoteId": "wallet-funding:0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "providerRequestId": "0x5d7e9f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9c1d3e5f7a9b1c3d5e7f9a1b3c5d7e",
    "amountInRaw": "531200",
    "maxGasCostRaw": "0",
    "destination": {
      "kind": "evm",
      "chainId": "137",
      "token": "0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb"
    },
    "destinationDecimals": 6,
    "recipient": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
    "refundRecipient": "0x8ba1f109551bd432803012645ac136ddd64dba72",
    "requiredArrivalRaw": "516750",
    "minimumArrivalRaw": "516750",
    "expectedArrivalRaw": "517900",
    "quoteExpiresAt": "2026-10-28T12:02:00Z",
    "fundingSubmitBefore": "2026-10-28T12:02:00Z",
    "maxAmountRaw": "750000",
    "slippageBps": 50
  },
  "createdAt": "2026-10-28T12:00:00Z",
  "executeBefore": "2026-10-28T12:02:00Z",
  "tradeSubmitBefore": "2026-10-28T12:04:00Z",
  "requests": [
    {
      "id": "plan",
      "purpose": "plan",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0x89",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{\"domain\":{\"chainId\":137,\"name\":\"KairosTradePlan\",\"version\":\"1\"},\"message\":{\"audience\":\"https://staging-execution.kairos.trade\",\"executeBefore\":\"1793188920\",\"partnerId\":\"acme\",\"planHash\":\"0xb3d5…6953\",\"planId\":\"0b1c2d3e-…\",\"tradeSubmitBefore\":\"1793189040\",\"wallet\":\"0x8ba1…ba72\"},\"primaryType\":\"TradePlan\",\"types\":{…}}"
        ]
      },
      "requestHash": "0x164f42fed95c09f82995ceb0d79c95e4074f81d9165c7ec449ffe4f5e15ace6e",
      "collectAfter": [],
      "executeAfter": [],
      "status": "ready",
      "actionable": true
    },
    {
      "id": "funding-1",
      "purpose": "funding",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0xa4b1",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{…}"
        ]
      },
      "requestHash": "0x2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c",
      "collectAfter": [],
      "executeAfter": [],
      "status": "ready",
      "actionable": true
    },
    {
      "id": "funding-2",
      "purpose": "funding",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0xa4b1",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{…}"
        ]
      },
      "requestHash": "0x3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d",
      "collectAfter": [],
      "executeAfter": [
        "funding-1"
      ],
      "status": "ready",
      "actionable": true
    },
    {
      "id": "trade",
      "purpose": "trade",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0x89",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{…}"
        ]
      },
      "requestHash": "0x0949c4fc3fec5036e82047f68491e76ea6d7a10b11c8bb5c5b04aa62969a1297",
      "collectAfter": [],
      "executeAfter": [
        "funding-1",
        "funding-2"
      ],
      "status": "ready",
      "actionable": true
    }
  ],
  "execution": {
    "committed": false,
    "phase": "collecting",
    "fundingStatus": "not_started",
    "tradeStatus": "not_started"
  },
  "error": null
}

{
  "error": "unknown or expired action"
}

{
  "error": "unknown or expired action"
}

{
  "error": "unknown or expired action"
}

{
  "error": "trade plan not found"
}

{
  "error": "unknown or expired action"
}

{
  "error": "plan authorization has expired"
}

Failed to deserialize the JSON body into the target type: action.price: invalid type: floating point `0.52`, expected a string

Failed to deserialize the JSON body into the target type: action.price: invalid type: floating point `0.52`, expected a string

Failed to deserialize the JSON body into the target type: action.price: invalid type: floating point `0.52`, expected a string

{
  "error": "rate limit exceeded for this endpoint; retry later"
}

{
  "error": "internal error"
}

{
  "error": "unknown or expired action"
}

Authorizations

X-Kairos-Partner-Id

string

header

required

Wallet API partner id, issued by Kairos together with the partner's base URL. Identifies the partner (tenant) on every /v3 call; sent instead of an API key. Letters, digits and ._:-, at most 64 characters, case-insensitive. A partner id issued for an individual account cannot be sent this way — that account sends its API key triple instead.

Authorization

string

header

required

Wallet sign-in token: SIWE <token>, where <token> is result.token from a login action (exactly one space after SIWE). Proves the wallet on reads of its orders and positions, and on trade plans, fee settlements and on-chain intents. The token is bound to the partner and the environment that issued it and lasts 24 hours; run a new login action to renew it.

Path Parameters

string<uuid>

required

Trade plan id.

Body

application/json

Body of /answers and /execute.

planHash

string

required

Must equal the plan's planHash.

answers

object[]

required

Maximum array length: 32

One answer, tagged by kind. Only signature answers are accepted; transaction answers are refused.

Option 1
Option 2

Show child attributes

Response

The committed plan (execution.committed: true).

A trade plan. Statuses: needs_signatures → ready_to_execute → (/execute) funding_pending → trade_pending → completed, with reconciling while an outcome is being confirmed. Terminal: completed, expired, failed, funded_trade_failed, funded_trade_expired.

audience and tradeExecutionRegion are opaque values signed into the plan — do not interpret or change them.

contractVersion

integer

required

string<uuid>

required

planHash

string

required

Hash of the plan's terms; every answer must echo it.

revision

string

required

Increases on every stored change ("0" at prepare).

wallet

string

required

The signing wallet, lowercase.

partnerId

string

required

audience

string

required

Opaque signed field.

interactionMode

enum<string>

required

Available options:

single_batch,

allow_followup

submission

object

required

Who submits each part. Defaults to Kairos for both. trade accepts only kairos.

Show child attributes

status

enum<string>

required

Available options:

needs_signatures,

ready_to_execute,

funding_pending,

trade_pending,

reconciling,

completed,

expired,

failed,

funded_trade_failed,

funded_trade_expired

venue

enum<string>

required

Venue id. predict.fun is accepted as an input alias of predictfun.

Available options:

polymarket,

predictfun,

hyperliquid

tradeExecutionRegion

string

required

Opaque signed field.

order

object

required

The order. Decimals must be canonical ("0.5", not "0.50"; "1", not "1.0"). size must match the venue's share lot exactly. Hyperliquid: whole-share size, at most 5 price decimals, GTC/FAK/IOC only. In a response this is the effective order — check it before signing: outcome is canonical and on Predict.fun a GTC order may come back as GTD with expiresAt set.

Show child attributes

tradingWallet

string

required

Where the collateral must sit — Polymarket's trading wallet, or the wallet itself on Predict.fun and Hyperliquid.

tradePayloadDigest

string

required

Signing digest of the trade request.

tradeBudget

object

required

The collateral ceiling the wallet authorizes. Raw amounts are integer strings in collateral base units.

Show child attributes

funding

object | null

required

The funding quote. Raw amounts are integer strings in base units.

Show child attributes

createdAt

string<date-time>

required

executeBefore

string<date-time>

required

Deadline for answers and /execute — funding.fundingSubmitBefore when funded, else tradeSubmitBefore.

tradeSubmitBefore

string<date-time>

required

requests

object[]

required

Required array length: 2 - 32 elements

Show child attributes

execution

object

required

Progress of a committed plan.

Show child attributes

error

object | null

required

Why a plan is in flight or stopped (returned with HTTP 200).

`code`	Meaning
`OUTCOME_UNKNOWN`	Funding or the trade is in flight; keep polling (`nextAction: reconcile`).
`PLAN_EXPIRED`	Not executed before `executeBefore`.
`TRADE_EXPIRED`	The order was not submitted by `tradeSubmitBefore`, or funding arrived after it.
`FUNDING_SHORTFALL`	Less than `minimumArrivalRaw` arrived.
`COLLATERAL_CHANGED`	The balance fell below `maxDebitRaw` before submission.
`VENUE_REJECTED`	The venue refused the signed order.
`PREFLIGHT_REFUSED`	A pre-submission check refused the order.
`NATIVE_NOT_DISPATCHED`	The trade authorization expired before submission.

nextAction is reconcile (keep polling) or inspect_funds (terminal: check where the collateral is — bridged funds stay in tradingWallet).

Show child attributes

ctfDependencies

object[]

Show child attributes

Commit a trade plan for execution

curl --request POST \
  --url https://execution.kairos.trade/v3/trade-plans/{id}/execute \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'X-Kairos-Partner-Id: <api-key>' \
  --data '
{
  "planHash": "0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953",
  "answers": []
}
'

import requests

url = "https://execution.kairos.trade/v3/trade-plans/{id}/execute"

payload = {
    "planHash": "0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953",
    "answers": []
}
headers = {
    "X-Kairos-Partner-Id": "<api-key>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Kairos-Partner-Id': '<api-key>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    planHash: '0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953',
    answers: []
  })
};

fetch('https://execution.kairos.trade/v3/trade-plans/{id}/execute', 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/v3/trade-plans/{id}/execute",
  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([
    'planHash' => '0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953',
    'answers' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "X-Kairos-Partner-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/v3/trade-plans/{id}/execute"

	payload := strings.NewReader("{\n  \"planHash\": \"0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953\",\n  \"answers\": []\n}")

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

	req.Header.Add("X-Kairos-Partner-Id", "<api-key>")
	req.Header.Add("Authorization", "<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/v3/trade-plans/{id}/execute")
  .header("X-Kairos-Partner-Id", "<api-key>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"planHash\": \"0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953\",\n  \"answers\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://execution.kairos.trade/v3/trade-plans/{id}/execute")

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

request = Net::HTTP::Post.new(url)
request["X-Kairos-Partner-Id"] = '<api-key>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"planHash\": \"0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953\",\n  \"answers\": []\n}"

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

{
  "contractVersion": 1,
  "id": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
  "planHash": "0xb3d5c6e930ee2015f733bd9ffa2a2302fedd2a5bf38628e220f0b675d50f6953",
  "revision": "0",
  "wallet": "0x8ba1f109551bd432803012645ac136ddd64dba72",
  "partnerId": "acme",
  "audience": "https://staging-execution.kairos.trade",
  "interactionMode": "single_batch",
  "submission": {
    "funding": "kairos",
    "trade": "kairos"
  },
  "status": "needs_signatures",
  "venue": "polymarket",
  "tradeExecutionRegion": "opaque-region-id",
  "order": {
    "market": "polymarket:0x5f3a8e1c2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6a",
    "outcome": "Yes",
    "side": "buy",
    "price": "0.05",
    "size": "10",
    "timeInForce": "GTC",
    "postOnly": true,
    "clientOrderId": "partner-trade-1042"
  },
  "tradingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
  "tradePayloadDigest": "0xa3612e136ad81349bbc469dbc02ebd85d3cfcd3f76f90fc06a5c33d6bd03a67a",
  "tradeBudget": {
    "collateral": {
      "kind": "evm",
      "chainId": "137",
      "token": "0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb"
    },
    "decimals": 6,
    "notionalRaw": "500000",
    "maxCollateralFeeRaw": "16750",
    "maxPlatformFeeBps": 75,
    "maxDebitRaw": "516750",
    "existingSpendableRaw": "0",
    "partnerFee": {
      "scheduleId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
      "maxBps": 25,
      "maker": {
        "model": "flat",
        "bps": 10
      },
      "taker": {
        "model": "flat",
        "bps": 25
      }
    }
  },
  "funding": {
    "sourceChainId": "42161",
    "sourceToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
    "sourceDecimals": 6,
    "quoteId": "wallet-funding:0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "providerRequestId": "0x5d7e9f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9c1d3e5f7a9b1c3d5e7f9a1b3c5d7e",
    "amountInRaw": "531200",
    "maxGasCostRaw": "0",
    "destination": {
      "kind": "evm",
      "chainId": "137",
      "token": "0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb"
    },
    "destinationDecimals": 6,
    "recipient": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
    "refundRecipient": "0x8ba1f109551bd432803012645ac136ddd64dba72",
    "requiredArrivalRaw": "516750",
    "minimumArrivalRaw": "516750",
    "expectedArrivalRaw": "517900",
    "quoteExpiresAt": "2026-10-28T12:02:00Z",
    "fundingSubmitBefore": "2026-10-28T12:02:00Z",
    "maxAmountRaw": "750000",
    "slippageBps": 50
  },
  "createdAt": "2026-10-28T12:00:00Z",
  "executeBefore": "2026-10-28T12:02:00Z",
  "tradeSubmitBefore": "2026-10-28T12:04:00Z",
  "requests": [
    {
      "id": "plan",
      "purpose": "plan",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0x89",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{\"domain\":{\"chainId\":137,\"name\":\"KairosTradePlan\",\"version\":\"1\"},\"message\":{\"audience\":\"https://staging-execution.kairos.trade\",\"executeBefore\":\"1793188920\",\"partnerId\":\"acme\",\"planHash\":\"0xb3d5…6953\",\"planId\":\"0b1c2d3e-…\",\"tradeSubmitBefore\":\"1793189040\",\"wallet\":\"0x8ba1…ba72\"},\"primaryType\":\"TradePlan\",\"types\":{…}}"
        ]
      },
      "requestHash": "0x164f42fed95c09f82995ceb0d79c95e4074f81d9165c7ec449ffe4f5e15ace6e",
      "collectAfter": [],
      "executeAfter": [],
      "status": "ready",
      "actionable": true
    },
    {
      "id": "funding-1",
      "purpose": "funding",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0xa4b1",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{…}"
        ]
      },
      "requestHash": "0x2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c",
      "collectAfter": [],
      "executeAfter": [],
      "status": "ready",
      "actionable": true
    },
    {
      "id": "funding-2",
      "purpose": "funding",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0xa4b1",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{…}"
        ]
      },
      "requestHash": "0x3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d",
      "collectAfter": [],
      "executeAfter": [
        "funding-1"
      ],
      "status": "ready",
      "actionable": true
    },
    {
      "id": "trade",
      "purpose": "trade",
      "kind": "signature",
      "signer": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "chainId": "0x89",
      "request": {
        "method": "eth_signTypedData_v4",
        "params": [
          "0x8ba1f109551bd432803012645ac136ddd64dba72",
          "{…}"
        ]
      },
      "requestHash": "0x0949c4fc3fec5036e82047f68491e76ea6d7a10b11c8bb5c5b04aa62969a1297",
      "collectAfter": [],
      "executeAfter": [
        "funding-1",
        "funding-2"
      ],
      "status": "ready",
      "actionable": true
    }
  ],
  "execution": {
    "committed": false,
    "phase": "collecting",
    "fundingStatus": "not_started",
    "tradeStatus": "not_started"
  },
  "error": null
}

{
  "error": "unknown or expired action"
}

{
  "error": "unknown or expired action"
}

{
  "error": "unknown or expired action"
}

{
  "error": "trade plan not found"
}

{
  "error": "unknown or expired action"
}

{
  "error": "plan authorization has expired"
}

Failed to deserialize the JSON body into the target type: action.price: invalid type: floating point `0.52`, expected a string

Failed to deserialize the JSON body into the target type: action.price: invalid type: floating point `0.52`, expected a string

Failed to deserialize the JSON body into the target type: action.price: invalid type: floating point `0.52`, expected a string

{
  "error": "rate limit exceeded for this endpoint; retry later"
}

{
  "error": "internal error"
}

{
  "error": "unknown or expired action"
}

Get started

Onboard users

Trade

Route and fund

Partner fees

Build

Endpoints

Commit a trade plan for execution

Authorizations

Path Parameters

Body

Response