KAkairos
Actions

Read an action's current step

Returns the action's current step. Poll this while status is working; when the step carries holdUntilMs (an order the venue is still matching), wait until then before polling.

An action is readable for 10 minutes after its 15-minute lifetime ends. Unknown, expired, and other partners' actions all read 404.

get/v3/actions/{id}

Request

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

Response

The current step.

idstring uuid required

Action id. One id for the whole action, across venues.

type'setup' | 'order' | 'cancel' | 'login' required
status'needs_signature' | 'working' | 'done' | 'failed' required

needs_signature — run request and answer; working — poll; done — read result; failed — read error and errorCode.

descriptionstring nullable required

Text to show with the wallet prompt (e.g. Confirm this Hyperliquid order), or progress text while working.

chainIdstring nullable required

EIP-155 chain id (hex) the wallet must be on to answer — 0x89 Polygon, 0x38 BNB Chain, 0xa4b1 Arbitrum One (0x66eee Arbitrum Sepolia on Hyperliquid testnet). null for personal_sign and when nothing is asked.

venue'polymarket' | 'predictfun' | 'hyperliquid' required

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

expiresAtMsinteger

Last accepted millisecond (Unix ms) for answering this prompt. Answers after it fail the action with SIGNATURE_EXPIRED.

holdUntilMsinteger

On a working order the venue is still matching — poll again after this time (Unix ms). result then holds a provisional outcome with final: false.

errorstring nullable required

Why the action failed; non-null on failed.

errorCode'NO_MATCH' | 'VENUE_REJECTED' | 'ORDER_OUTCOME_UNKNOWN' | 'CANCEL_OUTCOME_UNKNOWN' | 'SIGNATURE_EXPIRED' | 'CLIENT_ORDER_ID_CONFLICT' | 'HYPERLIQUID_AGENT_MISSING'

Machine-readable reason on a failed step; the key is omitted when the failure has no code. Codes may be added; treat an unknown code as a failure whose order was not placed.

CodeMeaningOrder placed?
NO_MATCHAn immediate order (FOK/FAK/IOC) found nothing to match.No
VENUE_REJECTEDThe venue refused the order.No
ORDER_OUTCOME_UNKNOWNThe submission's outcome is unknown. Read the wallet's orders before placing again.Maybe
CANCEL_OUTCOME_UNKNOWNSome venue may have cancelled. Read the wallet's orders.Maybe
SIGNATURE_EXPIREDThe signing window closed before a signature was accepted. Nothing was sent.No
CLIENT_ORDER_ID_CONFLICTThe clientOrderId names an order with different terms.No
HYPERLIQUID_AGENT_MISSINGHyperliquid no longer lists this wallet's trading approval. Run setup again.No

Example response

{
  "request": {
    "method": "personal_sign",
    "params": [
      "0x6b6169726f732e7472616465207761…",
      "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
    ]
  },
  "chainId": "0x38",
  "fallbackRequests": [
    {
      "method": "personal_sign",
      "params": [
        "0x6b6169726f732e7472616465207761…",
        "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
      ]
    }
  ],
  "expiresAtMs": 1793130772999,
  "result": {
    "ready": false,
    "venues": {
      "polymarket": {
        "ready": true,
        "tradingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
        "transactionHash": "0x7c3e9a1b5d2f4c6e8a0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c"
      },
      "predictfun": {
        "ready": false,
        "next": "fund",
        "tradingWallet": "0x8ba1f109551bd432803012645ac136ddd64dba72",
        "venueDetail": {
          "reason": "needs about 0.0004 BNB on BNB Chain to pay gas for 2 Predict.fun approvals",
          "approvals": 2,
          "gasWei": "400000000000000"
        }
      }
    },
    "tradingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
    "transactionHash": "0x7c3e9a1b5d2f4c6e8a0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c"
  }
}

Changes

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