Mass Quote

Submit up to 20 cancel-replace/pure-place legs for one symbol. There is no VIP-tier gate.

A batch costs 5 rate-limit credits.

Endpoint

POST /orders/massQuote

Auth: bearer plus the one-shot HPKE request envelope. The logical schema below is encrypted by the SDK.

Request Body

Field	Type	Required	Description
`symbol_id`	integer	Yes	One symbol for the entire batch
`legs`	array	Yes	Cancel-replace or pure-place legs (max 20)
`correlation_id`	string	Yes	Batch correlation id
`stp_mode`	string	No	Uppercase STP enum applied to every leg
`post_only`	boolean	Yes	Reject crossing replacement legs when true

Each leg:

Field	Type	Required	Description
`cancel_order_id`	string/null	No	Existing venue order; null/0 means pure place
`side`	string	Yes	`BUY` or `SELL`
`price`	decimal string	Yes	New order price
`quantity`	decimal string	Yes	New order quantity
`time_in_force`	string	No	`GTC` (default) or `GTD`. `IOC` / `FOK` not permitted.
`expiry_time`	integer	For `GTD`	Nanosecond epoch
`correlation_id`	string	Yes	Leg correlation id

Example

curl -X POST the REST origin/api/v1/orders/massQuote \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "symbol_id": 1,
    "legs": [
      { "cancel_order_id": "1875340519620476928", "side": "BUY", "price": "94800", "quantity": "0.5", "time_in_force": "GTC", "correlation_id": "101" },
      { "cancel_order_id": null, "side": "SELL", "price": "95100", "quantity": "0.4", "time_in_force": "GTD", "expiry_time": 1839975000000000000, "correlation_id": "102" }
    ],
    "correlation_id": "100",
    "stp_mode": "CANCEL_TAKER",
    "post_only": true
  }'

Response

The HTTP response is the standard API envelope containing an encrypted mass-quote ACK. Decrypt it with the SDK; the edge does not expose plaintext per-leg results.

Rate Limiting

Mass quote uses the order-generating bucket and costs 5 credits per batch. See Rate Limits.

Notes

Max 20 legs per batch.
Every leg targets the batch-level symbol_id.
Only limit legs with GTC or GTD are supported — see Order Compatibility.
Pre-trade risk validation applies to each replacement leg individually.