Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

outcomeOrderUpdate

Reports an Outcome order accepted through the delayed submission path that then failed before reaching the book. Successful submissions are not pushed. Unlike node channels, this subscription uses the API service's /api-ws endpoint.

ChanneloutcomeOrderUpdateserver → client · type outcomeOrderUpdate

Catch async Outcome order submissions that fail (by traceId). Only failures are pushed; not a fill signal.

Subscribe
{
  "method": "subscribe",
  "subscription": {
    "type": "outcomeOrderUpdate",
    "user": "0xabc123abc123abc123abc123abc123abc123abc1"
  }
}
Try it
WS wss://rpc.txflow-testnet.xyz/api-ws
Subscription parameters
typestringrequired
"outcomeOrderUpdate"
userstring · addressrequired
Server message
channelstring
"outcomeOrderUpdate"
dataobject
bodyobjectnullable
doneboolean
statusstring
"done"
successboolean
traceIdstring
userstring · address
Message example
{
  "channel": "outcomeOrderUpdate",
  "data": {
    "user": "0x0000000000000000000000000000000000000000",
    "traceId": "abc123def456",
    "status": "done",
    "done": true,
    "success": false,
    "body": {
      "status": "err",
      "response": "Place order failed: Outcome limit orders only support GTC, GTD, and ALO orders"
    }
  }
}

Correlate data.traceId with the traceId returned by POST /exchange. Pushes carry success: false with the reason in body; no push means the order was submitted. Follow outcomeOrderUpdates for matching lifecycle events or query outcomeFrontendOpenOrders.

body can be null (transport failure) or contain the node's err response. Code 20002 means the agent is no longer authorized and the account must authorize it again before resubmitting.