Skip to main content
PUT
Bulk Upsert Group Instruments

Path Parameters

group_id
string<uuid>
required

Body

application/json

Apply ONE partial patch to MANY symbols in a single transaction.

patch reuses the per-symbol validation (ranges, commission pairing, min<=max, enum checks). symbols is the set of broker-instrument symbols to apply it to. Empty symbols is rejected — a no-op bulk write is almost certainly a frontend bug, and we want the 422 to surface it.

symbols
string[]
required
Required array length: 1 - 2000 elements
patch
GroupInstrumentUpsertRequest · object
required

All override fields are optional. group_instruments is the sole source of commercial terms — there is no fallback to instruments master. Safety limits enforced on all numeric overrides.

Response

Successful Response

id
string<uuid>
required
group_id
string<uuid>
required
instrument_id
string<uuid>
required
symbol
string
required
tradeability
string | null
required
spread
number | null
required
margin_rate
number | null
required
swap_type
string | null
required
swap_long
number | null
required
swap_short
number | null
required
commission_type
string | null
required
commission_value
number | null
required
min_lot
number | null
required
max_lot
number | null
required
lot_step
number | null
required
max_symbol_exposure
number | null