Preview: available on staging (https://staging-execution.kairos.trade); not yet released in production, where trade plans — the only source of this fee debt — return 503.

Trades placed through trade plans on Polymarket and Predict.fun accrue the Kairos fee and the partner fee as a debt per wallet and collateral asset; nothing is deducted inside the order. This read returns the debt per venue, the threshold at which POST /v3/trade-plans refuses new trades with FEE_SETTLEMENT_REQUIRED, and any open settlement.

owedRaw is a signed integer string in token base units: it is negative when confirmed payments exceed the fees booked so far (a credit carried against later fees). The threshold is set by Kairos per partner. A venue whose settlement rail is not offered is omitted.

Reading also advances settlements: it refreshes the open settlement from chain evidence and credits late payments. Hyperliquid has no fee debt on this API.

{
  "venues": [
    {
      "venue": "polymarket",
      "holdingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
      "assetKey": "evm:137:0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb",
      "decimals": 6,
      "owedRaw": "400000",
      "thresholdRaw": "10000000",
      "settlement": null
    },
    {
      "venue": "predictfun",
      "holdingWallet": "0x8ba1f109551bd432803012645ac136ddd64dba72",
      "assetKey": "evm:56:0x55d398326f99059ff775485246999027b3197955",
      "decimals": 18,
      "owedRaw": "0",
      "thresholdRaw": "10000000000000000000",
      "settlement": null
    }
  ]
}