Orders & Execution Graphs

Every order is an execution graph. A simple market buy is a 1-node graph. A multi-leg hedge is a multi-node graph with dependency edges. One endpoint handles both.

Submit Order

Accepts two formats: simple order (auto-wrapped into a 1-node graph) or full execution graph.

Simple Order

{
  "symbol": "BTC-USD",
  "side": "buy",
  "qty": 0.1
}

Prediction-market simple orders use the same endpoint. symbol can be a Polymarket slug, :yes / :no slug, raw token ID, or a full polymarket.com/event/... URL.

Optional fields:

Full Execution Graph

{
  "nodes": [
    {
      "node_id": "spot",
      "instrument": {"symbol": "ETH-USD", "type": "spot"},
      "side": "buy",
      "order_type": "market",
      "quantity": {"fixed": {"qty_1e8": 20000000000}},
      "execution": {"policy": "sor", "urgency": "medium"},
      "activation": "root"
    },
    {
      "node_id": "hedge",
      "instrument": {"symbol": "ETH-USD-PERP", "type": "perp", "venue": "hyperliquid"},
      "side": "sell",
      "order_type": "market",
      "quantity": {"fixed": {"qty_1e8": 20000000000}},
      "execution": {"policy": "aggressive_chase"},
      "activation": "wait"
    }
  ],
  "edges": [
    {
      "edge_id": "e0",
      "from_node": "spot",
      "to_node": "hedge",
      "trigger": "on_fill_ratio",
      "condition": {"fill_ratio_gte": 0.5}
    }
  ],
  "risk": {
    "admission": {"max_notional_usd": 500000},
    "runtime": {"max_loss_usd": 10000}
  },
  "is_sandbox": false
}

Node Fields

Response

{
  "graph_id": "graph_7d769677a7b4448b...",
  "status": "active",
  "node_count": 2,
  "edge_count": 1
}

Get Graph Status

{
  "graph_id": "graph_7d769...",
  "client_id": "client_abc",
  "status": "active",
  "nodes": {
    "spot": {
      "status": "filled",
      "target_qty_1e8": 20000000000,
      "filled_qty_1e8": 20000000000,
      "avg_fill_price_1e9": 2325530000000,
      "fill_count": 3
    },
    "hedge": {
      "status": "executing",
      "target_qty_1e8": 20000000000,
      "filled_qty_1e8": 10000000000,
      "avg_fill_price_1e9": 2324800000000,
      "fill_count": 1
    }
  },
  "edges": {
    "e0": {"status": "fired", "fired": true}
  }
}

Graph status values: active, completed, cancelled, failed, paused.

Node status values: pending, executing, filled, partial_fill, cancelled, rejected, failed.

Transient vs terminal failures

The router distinguishes transient failures (worth retrying) from terminal rejects (don't retry — fix the input first). Inspect traces on the order to see the underlying classification:

List Orders

{
  "orders": [
    {
      "node_order_id": "graph:graph_7d769...:spot:1",
      "client_id": "client_abc",
      "side": "BUY",
      "symbol": "ETH-USD",
      "qty_1e8": 20000000000,
      "filled_qty_1e8": 20000000000,
      "status": "COMPLETED",
      "created_unix_ns": 1776208527263141000,
      "updated_unix_ns": 1776208529872926000,
      "failure_reason": null
    }
  ],
  "total": 42,
  "limit": 50,
  "offset": 0,
  "has_more": false
}

Cancel Order / Graph

Cancels all active nodes in the graph. Returns 200 on success.

To cancel a specific order, extract the graph_id from the node_order_id:

node_order_id: "graph:graph_7d769...:spot:1"
                      ^^^^^^^^^^^^^^^^
                      graph_id

Resume Paused Graph

Resumes a paused graph. Pending nodes will re-evaluate their edge triggers.

Amend Graph Node

Amend a running graph node's execution parameters (urgency, slippage, horizon):

{
  "qty_1e8": 15000000000,
  "urgency": "high",
  "max_slippage_bps": 25,
  "horizon_ms": 5000
}

All fields are optional. Only provided fields are updated.

Amend Order (uniform verb)

Venue-agnostic price/qty amend. Designed for prediction markets (Kalshi + Polymarket) and spot CEX venues behind one call. The graph-level API executes through the parent-order amend / cancel-replace workflow today; Kalshi's lower-level transport supports native atomic /portfolio/orders/{id}/amend, but CC does not yet preserve that native amend path end-to-end through this endpoint.

{
  "new_qty_1e8": 12000000000,
  "new_constraints": {
    "max_price_1e9": 550000000
  }
}

At least one of new_qty_1e8 / new_constraints.max_price_1e9 must be present.

Response:

{
  "node_order_id": "graph_abc...:node_0:2",
  "status": "accepted"
}

The SDK wraps this and surfaces a mode field (cancel_replace today) so queue-sensitive market makers can branch on execution mode.

Decrease Order (uniform verb)

Shrink a resting order's remaining size without touching its price. SDK-only verb (no distinct REST endpoint today — the SDK reads the current size, computes new_qty, and issues a regular amend). Kalshi's lower-level transport supports native /portfolio/orders/{id}/decrease, but CC does not yet preserve that native decrease path end-to-end through this SDK method, so the SDK reports cancel_replace_shrink today.

r = seq.decrease(order_id, reduce_by=5.0)
# {"order_id": "...", "mode": "cancel_replace_shrink", "status": "accepted"}

Batch Orders (uniform verb, SDK-orchestrated)

The SDK batch() builder collects submits/cancels for a target venue and flushes graph roots together. Today the graph-level SDK path serializes and returns mode="serial" for both Kalshi and Polymarket.

The lower venue transports support native batches where the execution engine preserves a transport batch window: Kalshi uses /portfolio/orders/batched (20-op atomic) and Polymarket uses CLOB POST /orders (15 orders, per-order result). Those native paths are not yet surfaced by this SDK graph builder, so queue-sensitive callers must branch on the returned mode.

# Kalshi — works directly, mode=serial today
with seq.batch("kalshi") as b:
    b.buy_limit("KXBTCZ-26DEC31-T99000", 10, 0.55)
    b.cancel(stale_id)
 
# Polymarket — graph-level SDK batch is serial today
seq.batch("polymarket").buy("TOKEN_ID", 10).end()
# → {"mode": "serial", "responses": [...]}

Redeem Prediction Market

Uniform settlement claim. Kalshi auto-settles (returns mode="auto_settled", no action taken); Polymarket fires an authenticated POST to the CLOB relayer (returns mode="relayer_submitted"). See Prediction Markets for full response shape.

List Fills

Each fill carries a Phase-1 TCA breakdown when the venue reported one:

Kill Switch

Emergency circuit breaker. Cancels all active orders and blocks new submissions.

{"active": true, "reason": "risk limit breach"}

To clear: {"active": false}

Execution Policies

Edge Triggers