Placing Orders

Place the order with the market’s ticker, your client_order_id, a side, a price on the market’s tick, a quantity in contracts, and a time_in_force:

{
  "ticker": "UDX-EXAMPLE-MARKET",
  "client_order_id": "my-order-1",
  "side": "buy",
  "price": "0.55",
  "quantity": "100",
  "time_in_force": "gtc"
}

Add post_only: true to be rejected rather than fill on arrival, self_trade_prevention_type to choose which of your own orders gives way, and account_id when the key is not restricted to one account.

The 202 Accepted response carries the exchange-assigned order_id and echoes your client_order_id. The Quick Start shows the signed request end to end.

Subscribe to the private orders channel before you place the order, so the order’s lifecycle lands on the same connection. Then place the order with create_order, carrying the same fields as the REST body:

{
  "id": 2,
  "cmd": "create_order",
  "params": {
    "ticker": "UDX-EXAMPLE-MARKET",
    "client_order_id": "my-order-1",
    "side": "buy",
    "price": "0.55",
    "quantity": "100",
    "time_in_force": "gtc"
  }
}

The same optional fields apply: post_only, self_trade_prevention_type, and account_id when the key is not restricted to one account.

The order_create_submitted response carries the exchange-assigned order_id and echoes your client_order_id — the exchange accepted the submission, not the outcome:

{
  "id": 2,
  "type": "order_create_submitted",
  "msg": {
    "order_id": "45c48cce",
    "client_order_id": "my-order-1"
  }
}

The order’s committed state — resting, filled, or rejected — arrives on the orders subscription, which is independent of the command reply: correlate by order_id and client_order_id, never by frame order. Asynchronous Writes covers reading outcomes, error frames, and retrying safely.

Poll the order by its order_id until it reaches the status you expect:

List your orders filtered by client_order_id, ticker, or status to see every order with working orders first. Choose one status; resting with partially_filled; or all four terminal statuses together. Repeat status for each selected value; other combinations return 400. A short or empty page can still carry next_page_url, so continue until it is null. List your fills for executions, correlated by client_order_id.

Subscribe to orders and fills in one command before placing the order. The private channels contain only the authenticated caller’s data. Filter both channels to a catalog ticker when appropriate; omit tickers to receive every order and execution you can see, including combination orders.

{
  "id": 1,
  "cmd": "subscribe",
  "params": {
    "channels": [
      {
        "channel": "orders",
        "tickers": ["UDX-EXAMPLE-MARKET"]
      },
      {
        "channel": "fills",
        "tickers": ["UDX-EXAMPLE-MARKET"]
      }
    ]
  }
}

Each channel receives its own subscribed response and sid.

Amend the order by its order_id:

{
  "ticker": "UDX-EXAMPLE-MARKET",
  "quantity": "80",
  "price": "0.55"
}

The 202 Accepted response echoes the order_id; poll the order for the new values.

Amend the order with amend_order, naming its order_id:

{
  "id": 3,
  "cmd": "amend_order",
  "params": {
    "order_id": "45c48cce",
    "ticker": "UDX-EXAMPLE-MARKET",
    "quantity": "80",
    "price": "0.55"
  }
}

The order_amend_submitted response echoes the order_id — the exchange accepted the submission, not the outcome. An order_id that is unknown, or not yours, answers an order_not_found error, exactly as over REST.

Cancel the order by its order_id, naming its ticker in the query:

DELETE /orders/{order_id}?ticker=UDX-EXAMPLE-MARKET

The response echoes the order_id; poll the order until it reads canceled.

Cancel the order with cancel_order:

{
  "id": 4,
  "cmd": "cancel_order",
  "params": {
    "order_id": "45c48cce",
    "ticker": "UDX-EXAMPLE-MARKET"
  }
}

The order_cancel_submitted response echoes the order_id — the exchange accepted the submission, not the outcome. An order_id that is unknown, or not yours, answers an order_not_found error, exactly as over REST.