Order groups

Order groups link multiple orders so that filling, cancelling, or expiring one affects the others. Tradara supports three group kinds:

Kind	Behaviour
`OCO`	One-cancels-other. Two orders, typically a take-profit limit and a stop-loss stop. When one fills, the other is cancelled.
`OTO`	One-triggers-other. A primary order; on fill, secondary order(s) are submitted.
`OTOCO`	One-triggers-OCO. Entry order; on fill, an OCO pair (TP + SL) is submitted. Classic bracket.

OCO behaviour

A partial fill on one leg proportionally cancels the other leg’s quantity.

Create a group

POST /v1/orders/groups

Body:

Field	Type	Notes
`kind`	enum	`OCO`, `OTO`, or `OTOCO`.
`account_id`	UUID	Required.
`orders`	array	Order specs in submission order. See Place an order for fields.

OTOCO bracket example

Entry: BUY LIMIT 1 @ 5800. On fill: SELL LIMIT 1 @ 5810 (TP) and SELL STOP 1 @ 5790 (SL), linked OCO.

curl -X POST "$TRADARA_BASE_URL/v1/orders/groups" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "OTOCO",
    "account_id": "'"$ACCOUNT_ID"'",
    "orders": [
      {
        "role": "ENTRY",
        "instrument_id": "'"$INSTRUMENT_ID"'",
        "side": "BUY",
        "execution_type": "LIMIT",
        "limit_price": "5800.00",
        "quantity": 1,
        "position_effect": "OPEN"
      },
      {
        "role": "TAKE_PROFIT",
        "instrument_id": "'"$INSTRUMENT_ID"'",
        "side": "SELL",
        "execution_type": "LIMIT",
        "limit_price": "5810.00",
        "quantity": 1,
        "position_effect": "CLOSE"
      },
      {
        "role": "STOP_LOSS",
        "instrument_id": "'"$INSTRUMENT_ID"'",
        "side": "SELL",
        "execution_type": "STOP",
        "stop_price": "5790.00",
        "quantity": 1,
        "position_effect": "CLOSE"
      }
    ]
  }'

Response:

{
  "group_id": "grp_01HW...",
  "kind": "OTOCO",
  "account_id": "5b1c...",
  "orders": [
    { "order_id": "ord_a", "role": "ENTRY",       "status": "PENDING" },
    { "order_id": "ord_b", "role": "TAKE_PROFIT", "status": "PENDING_TRIGGER" },
    { "order_id": "ord_c", "role": "STOP_LOSS",   "status": "PENDING_TRIGGER" }
  ]
}

Take-profit and stop-loss orders sit in PENDING_TRIGGER until the entry fills.

Get a group

GET /v1/orders/groups/{group_id}

Returns the group with all member orders and their current state.

curl -sS "$TRADARA_BASE_URL/v1/orders/groups/$GROUP_ID" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY"

Cancel a group

DELETE /v1/orders/groups/{group_id}

Cancels every non-terminal member.

curl -X DELETE "$TRADARA_BASE_URL/v1/orders/groups/$GROUP_ID" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY"

Link two existing orders as OCO

These two routes are implemented on the Orders service but not yet present in the published OpenAPI spec.

POST /v1/orders/groups/oco/link

Body:

{
  "order_id_a": "ord_aaa...",
  "order_id_b": "ord_bbb..."
}

Both orders must:

Belong to the same account_id.
Be on the same instrument_id.
Be in a non-terminal state.
Not already be members of a group.

Response contains the new group_id.

Create an OCO companion for an existing order

POST /v1/orders/groups/oco/companion

Given an existing order (e.g. a take-profit limit), create a paired stop-loss in a single call:

{
  "order_id": "ord_existing...",
  "companion": {
    "side": "SELL",
    "execution_type": "STOP",
    "stop_price": "5790.00",
    "quantity": 1,
    "position_effect": "CLOSE"
  }
}

Returns the group_id and the new companion order.

Errors

HTTP	`code`	Meaning
`400`	`invalid_group_kind`	`kind` not in `OCO`, `OTO`, `OTOCO`.
`400`	`invalid_group_members`	Wrong number of orders for the kind.
`409`	`order_already_grouped`	One of the orders is already in a group.
`409`	`instrument_mismatch`	OCO link orders are on different instruments.

Overview

Orders

Fills

Positions

Trades

Balances

Realtime WebSocket

OCO behaviour

Create a group

OTOCO bracket example

Get a group

Cancel a group

Link two existing orders as OCO

Create an OCO companion for an existing order

Errors

​OCO behaviour

​Create a group

​OTOCO bracket example

​Get a group

​Cancel a group

​Link two existing orders as OCO

​Create an OCO companion for an existing order

​Errors

OCO behaviour

Create a group

OTOCO bracket example

Get a group

Cancel a group

Link two existing orders as OCO

Create an OCO companion for an existing order

Errors