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 callers can identify which multi-leg order an order belongs to and what part it plays:
group_id: an opaque UUID shared by every order in onebracket,oto, orocoorder, including legs and replacements.group_role: one ofentry,take_profit, orstop_loss, from the newOrderGroupRoleenum. Forocoorders, the top-level order istake_profit.
Both keys are omitted for orders that are not part of a bracket, oto, or oco order. Trade update events carry the same fields, so clients consuming only the stream can group bracket legs that arrive one at a time with legs set to null. New examples show a bracket order response and a bracket-leg trade update.
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}/ordersDELETE /v1/trading/accounts/{account_id}/positionsDELETE /v1/trading/accounts/{account_id}/positions/{symbol_or_asset_id}GET /v2/events/trades