> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deribit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mass Quotes

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

## Placing multiple quotes

<Info>
  **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**.
</Info>

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

<Warning>
  **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.
</Warning>

<Info>
  **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](/starbase/api-rate-limits) for details.
</Info>

### 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<br />`1`=True<br />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](/starbase/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<br />`1`=Unmodified<br />`2`=QuantityReduced<br />`3`=Updated<br />`4`=Filled<br />`5`=CanceledByRequest<br />`6`=CanceledByMmp<br />`7`=CanceledBySelfMatch<br />`8`=Queued |
| ->19  | askStatus             | int8      | 1      | Refer to buyQuoteStatus for possible values                                                                                                                                               |
| ->20  | bidRejectReason       | int8      | 1      | Rejection reason code. See [Rejection Reason Codes](/starbase/binary-api-reference#rejection-reason-codes) for possible values.                                                           |
| ->21  | askRejectReason       | int8      | 1      | Rejection reason code. See [Rejection Reason Codes](/starbase/binary-api-reference#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.<br />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<br />`-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<br />`1`=InvalidMmpGroup<br />`2`=MmpGroupDisabled<br />`3`=MmpGroupFrozen<br />`4`=TooManyQuotes<br />`5`=InvalidInstrument<br />`6`=RateLimit<br />`7`=PortfolioLocked<br />`8`=DuplicateInstrument |
| 7     | details       | char  | 0-255  | ASCII-encoded string                                                                                                                                                                                                  |