Skip to main content

Bulk Operations

Bulk operations let market makers update many quotes with one request while preserving deterministic acknowledgement behavior.

Bulk quote replace​

Bulk quote replace cancels an existing quote set and submits a new quote set for the same account and market.

{
  "market": "BTC-USDC",
  "clientBatchId": "btc-quote-refresh-1842",
  "cancelScope": "market",
  "orders": [
    {"clientOrderId": "bid-1", "side": "buy", "price": "59990", "quantity": "0.50"},
    {"clientOrderId": "ask-1", "side": "sell", "price": "60010", "quantity": "0.50"}
  ]
}

Atomicity​

For supported tiers, the quote refresh is evaluated as one operation:

  • validation failures reject the batch before book mutation
  • accepted batches receive a batch acknowledgement
  • individual order rejects are returned in the batch response where partial mode is enabled by contract

Mass cancel​

Mass cancel can target:

ScopeEffect
AccountCancels all open orders for the account
MarketCancels all open orders in one market
SideCancels all bids or all asks in one market
SessionCancels orders associated with one gateway session

Idempotency​

Use clientBatchId as the idempotency key for bulk operations. Retrying the same batch id returns the existing batch state rather than applying a duplicate refresh.