KAkairos
Reads

List a wallet's orders across venues

Returns the wallet's orders on every venue, newest first. Requires proof of the wallet: send Authorization: SIWE <token> from a login action (or an API key whose Kairos account owns the wallet).

Each venue is read with the same limit; the rows are merged, sorted by createdAt descending and cut to limit. There is no cursor: this route returns at most 500 orders. When a venue cannot be read its rows are missing and venueDetail.<venue>.error says why.

Order rows carry no fee fields.

get/v3/wallets/{address}/orders

Request

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

Path parameters

addressstring required

The wallet's EVM address (0x + 40 hex; checksum not required).

Query parameters

openboolean

true returns only working orders; false (default) returns every status. Only the literal true / false are accepted.

limitinteger

Maximum rows to return. Values outside 1–500 are clamped.

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

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

Read one venue only. Case-insensitive; predict.fun is accepted for predictfun. An unknown name is 400 unknown venue "<name>"; a venue not offered on this deployment returns an empty list.

Headers

X-Kairos-Wallet-Api'2' required

Wallet API contract version. Send 2 — the multi-venue contract this reference documents. Without the header (or with any other value) /v3/actions and /v3/wallets/* serve the original Polymarket-only contract, which ignores venue prefixes, expiresAt and setup.venues, omits chainId, venue and fallbackRequests from steps, refuses orders on a wallet that is not set up (409), and returns snake_case order and position rows.

Response

Orders, newest first.

venueDetailWalletVenueReadError

Per-venue read failures, keyed by venue. Present only when some venue could not be read.

Example response

{
  "orders": [
    {
      "orderId": "3f2b8c1e-5d4a-4e6f-9b7c-1a2d3e4f5a6b",
      "venue": "predictfun",
      "market": "predictfun:1027194",
      "marketId": "1027194",
      "outcome": "Yes",
      "tokenId": "81517620335745318418347838710345678901234567890",
      "side": "buy",
      "type": "limit",
      "price": "0.52",
      "size": "10",
      "filledSize": "0",
      "avgFillPrice": null,
      "timeInForce": "GTD",
      "postOnly": false,
      "expiresAt": "2026-10-29T00:00:00Z",
      "status": "live",
      "venueOrderId": "512334:0x3c9a…",
      "clientOrderId": "acme-7f3a91",
      "createdAt": "2026-10-28T12:00:00Z",
      "updatedAt": "2026-10-28T12:00:01Z"
    }
  ]
}

Changes

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