Added
New "group_id" and "group_role" fields on orders
October 8th, 2026
Broker API
Adds two optional fields to the Order and OrderLeg schemas so multi-leg orders can be correlated, including on the trade events stream where legs arrive one at a time with legs: null.
group_id: an opaque UUID shared by every order in onebracket,oto, orocoorder, including legs and replacements.group_role: a newOrderGroupRoleenum with valuesentry,take_profit, andstop_loss. Foroco, the top-level order istake_profit.- Both keys are omitted for orders that are not part of a
bracket,oto, orocoorder. - New examples cover a bracket order response and a bracket-leg trade update event.
Affected Endpoints
POST /v1/trading/accounts/{account_id}/ordersGET /v1/trading/accounts/{account_id}/ordersGET /v1/trading/accounts/{account_id}/orders/{order_id}GET /v1/trading/accounts/{account_id}/orders:by_client_order_idPATCH /v1/trading/accounts/{account_id}/orders/{order_id}DELETE /v1/trading/accounts/{account_id}/ordersPOST /v1/trading/accounts/{account_id}/orders/estimationDELETE /v1/trading/accounts/{account_id}/positionsDELETE /v1/trading/accounts/{account_id}/positions/{symbol_or_asset_id}GET /v1/rebalancing/runsGET /v1/rebalancing/runs/{run_id}GET /v2/events/trades