Read a trade plan

curl --request GET \
  --url https://execution.kairos.trade/v3/trade-plans/{id} \
  --header 'Authorization: <api-key>' \
  --header 'X-Kairos-Partner-Id: <api-key>'

import requests

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

headers = {
    "X-Kairos-Partner-Id": "<api-key>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-Kairos-Partner-Id': '<api-key>', Authorization: '<api-key>'}
};

fetch('https://execution.kairos.trade/v3/trade-plans/{id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "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"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Kairos-Partner-Id", "<api-key>")
	req.Header.Add("Authorization", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://execution.kairos.trade/v3/trade-plans/{id}")
  .header("X-Kairos-Partner-Id", "<api-key>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["X-Kairos-Partner-Id"] = '<api-key>'
request["Authorization"] = '<api-key>'

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
}

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

{
  "error": "sign-in token has expired; run a login action"
}

{
  "error": "API key missing trade:read scope"
}

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

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

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

{
  "error": "internal error"
}

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