Mass Quotes

Place multiple quotes using the Starbase Binary API including MassQuoteRequest, MassQuoteResponse, and MassQuoteReject messages.

Placing multiple quotes

Mass Quotes Limit: Mass quotes are limited to 15 double-sided quotes.

Fill Limits: The maximum number of fills on a single mass quote is 2000 fills for single-leg instruments and 400 fills for combo instruments.

Duplicate quote handling: When a client sends the same quote twice (identical price, amount, and instrument), Starbase preserves the bid and ask priorities.

Quote quantity validation is all-or-nothing: If any quote entry in a MassQuoteRequest contains an invalid buyAmount or sellAmount, the entire request is rejected and a MassQuoteReject (232) is returned — no quotes in the message are processed. This differs from the JSON-RPC mass quote system, where each side is validated independently and one side may succeed while the other fails.

Rate limiting and cancels: Setting a quote’s bidQty or askQty to 0 cancels that side. A MassQuoteRequest where all quantities are zero is treated as a cancel: it consumes tokens from the mass quote bucket but is never rejected due to rate limits, even when throttled. Any message containing at least one non-zero quantity is subject to normal rate limiting. See API Rate Limits for details.

MassQuoteRequest (130)

Place buy and/or sell orders for up to 15 instruments in one message.

Field	Name	Type	Length	Description
1	quoteId	int64	8	Numeric client quote ID
2	correlationId	int64	8	Client-assigned ID
3	mmpGroupId	int64	8	Identifier of MMP group
4	selfMatchPreventionId	int64	8	SMPToken. This order cannot match with any other orders within the same portfolio with the same token. Applies to all quotes in the batch.
5	flags	uint8	1	See the table below
6	blockLengthOfQuotes	uint16	2	44 (bytes)
7	numberOfQuotes	uint16	2	Number of quotes in repeating group. Maximum is 15.
->8	instrumentId	int64	8	Numeric instrument ID
->9	bidPrice	Price9	8	Limit price of buy side
->10	askPrice	Price9	8	Limit price of sell side
->11	bidQty	Decimal72	9	Buy quantity. 0 to cancel existing buy orders
->12	askQty	Decimal72	9	Sell quantity. 0 to cancel existing sell orders
->13	bidFlags	uint16	2	See the table below
->14	askFlags	uint16	2	See the table below

The table below outlines the content of field 5 (massQuoteFlags) of MassQuoteRequest.

Bit number (from last to first)	Name	Description
1	resetMMP	0=False 1=True If an MMP freeze is active, this flag will remove the freeze before processing the rest of the message. Keep in mind there is a mandatory 1 second freeze that cannot be overruled
2	Reserved for future use
3	Reserved for future use
4	Reserved for future use
5	Reserved for future use
6	Reserved for future use
7	Reserved for future use
8	Reserved for future use

The table below outlines the content of field 13/14 (bidFlags/askFlags) of MassQuoteRequest.

Bit number (from last to first)	Name	Description
1	postOnly	Enables post-only that amends the quote price to the best bid/ask if it would be immediately executable. The amended price is then validated against price limits. Mutually exclusive with postOnlyReject.
2	postOnlyReject	Enables post-only that rejects the quote if it would be immediately executable. Mutually exclusive with postOnly.
3	marketLimit	Set limitPrice based on the top-of-book instead of the price band.
4	MMP	The order will be subject to the default Market Maker Protection group
5	resetMmp	Unfreeze orders MMP group
6	Reserved for future use
7	Reserved for future use
8	Reserved for future use

MassQuoteResponse (230)

Acknowledges the successful execution of a MassQuoteRequest. Quotes do not have a separate fillAmount and amount. A quote’s amount will always be what’s still available for execution. As such, in a MassQuoteResponse, the amounts of the quotes returned will already incorporate the accompanying fills.

Individual quote sides that aggress may be speed bumped, indicated by buyQuoteStatus = 8 or sellQuoteStatus = 8 (Queued). Once the speed bump period expires, an unsolicited MassQuoteOrdersPlaced message is sent for the placed sides. See Speed Bumps for details.

Field	Name	Type	Length	Description
1	transactTime	int64	8	Nanoseconds since epoch. Time of entry into the order book
2	execId	int64	8	Exchange-assigned event ID
3	quoteId	int64	8	Numeric client quote ID
4	correlationId	int64	8	Client-assigned ID
5	mmpGroupId	int64	8	Identifier of MMP group
6	receiveTime	int64	8	Nanoseconds since epoch. Time of receipt of order on the gateway.
7	blockLengthOfQuotes	uint16	2	76 (bytes)
8	numberOfQuotes	uint16	2	Number of quotes in repeating group. Maximum is 15.
->9	instrumentId	int64	8	Numeric instrument ID
->10	bidOrderId	int64	8	Numeric exchange assigned order ID
->11	askOrderId	int64	8	Numeric exchange assigned order ID
->12	bidPrice	Price9	8	Limit price of buy side (possibly different from submitted price if postOnly)
->13	askPrice	Price9	8	Limit price of sell side (possibly different from submitted price if postOnly)
->14	bidQty	Decimal72	9	Quantity remaining of buy side
->15	askQty	Decimal72	9	Quantity remaining of sell side
->16	bidFilledQty	Decimal72	9	Buy quantity filled
->17	askFilledQty	Decimal72	9	Sell quantity filled
->18	bidStatus	int8	1	0=Inactive 1=Unmodified 2=QuantityReduced 3=Updated 4=Filled 5=CanceledByRequest 6=CanceledByMmp 7=CanceledBySelfMatch 8=Queued
->19	askStatus	int8	1	Refer to buyQuoteStatus for possible values
->20	bidRejectReason	int8	1	Rejection reason code. See Rejection Reason Codes for possible values.
->21	askRejectReason	int8	1	Rejection reason code. See Rejection Reason Codes for possible values.
22	blockLengthOfBidFills	uint16	2	32 (bytes)
23	numberOfBidFills	uint16	2	Indicates the length of the following repeating group containing all immediate buy fills when the order was submitted
->24	matchId	int64	8	Transaction ID representing match
->25	instrumentId	int64	8	Numeric instrument ID
->26	fillPrice	Price9	8	Price of fill
->27	fillQty	Decimal72	9	Quantity of fill
28	blockLengthOfAskFills	uint16	2	32 (bytes)
29	numberOfAskFills	uint16	2	Indicates the length of the following repeating group containing all immediate sell fills when the order was submitted
->30	matchId	int64	8	Transaction ID representing match
->31	instrumentId	int64	8	Numeric instrument ID
->32	fillPrice	Price9	8	Price of fill
->33	fillQuantity	Decimal72	9	Quantity of fill
34	blockLengthOfLegs	uint16	2	33 (bytes)
35	numberOfLegs	uint16	2	Indicates the length of the following repeating group containing all combo leg quantities and prices. Non-zero for trades on combo instruments only.
->36	matchId	int64	8	Transaction ID representing match.
->37	instrumentId	int64	8	Numeric instrument ID.
->38	legPrice	Price9	8	Price of this leg in the combo instrument
->39	legQty	Decimal72	9	Quantity of this leg in the combo instrument
->40	legSide	int8	1	1=BUY -1=SELL

MassQuoteReject (232)

Reject generated in case a MassQuoteRequest is unsuccessful.

Field	Name	Type	Length	Description
1	transactTime	int64	8	Nanoseconds since epoch. Time of entry into the order book
2	execId	int64	8	Exchange-assigned event ID
3	quoteId	int64	8	Numeric client quote ID
4	correlationId	int64	8	Client-assigned ID
5	mmpGroupId	int64	8	Identifier of MMP group
6	reason	int8	1	0=SystemError 1=InvalidMmpGroup 2=MmpGroupDisabled 3=MmpGroupFrozen 4=TooManyQuotes 5=InvalidInstrument 6=RateLimit 7=PortfolioLocked 8=DuplicateInstrument
7	details	char	0-255	ASCII-encoded string