> ## 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.
# private/set_mmp_config
> Configures Market Maker Protection (MMP) for a specific index. This method sets the monitoring window, freeze duration, and exposure limits (quantity, delta, vega, and Maximum Quote Quantity).
At least one limit parameter must be set. Maximum Quote Quantity (MQQ) is a required parameter that limits the total combined size of open MMP orders. MQQ is configured per index but enforced per side, per order book (instrument).
The `interval` parameter defines the monitoring window duration in seconds. The `frozen_time` parameter sets how long MMP remains active after being triggered. Set `frozen_time` to `0` to disable automatic reset (manual reset required).
For Mass Quotes, use the `mmp_group` parameter to configure MMP for a specific group. Set `block_rfq` to `true` to configure MMP for Block RFQ (requires `block_rfq:read_write` scope). Set `interval` to `0` to remove MMP configuration.
**📖 Related Article:** [Market Maker Protection API Configuration](https://docs.deribit.com/articles/market-maker-protection)
**Scope:** `trade:read_write` or `block_rfq:read_write` (when `block_rfq` = `true`)
[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fset_mmp_config)
## OpenAPI
````yaml /specifications/deribit_openapi.json get /private/set_mmp_config
openapi: 3.0.0
info:
title: Deribit API
version: 2.1.1
servers:
- url: https://test.deribit.com/api/v2
security: []
tags:
- name: WebSocket Only
description: Can only be used over websockets.
- name: Public
description: Public methods can be used without authentication.
- name: Private
description: >-
Private methods require authentication. All requests must include a
valid OAuth2 token.
A token can be requested using the /public/auth method.
When using the websockets protocol, the token must be included as a
parameter access_token in the message. When using REST (HTTP
GET), the token may also be passed in the Authorization
header.
- name: Authentication
- name: Session Management
- name: Subscription Management
description: >-
Subscription works as [notifications](#notifications), so users will
automatically (after subscribing) receive messages from the server.
Overview for each channel response format is described in
[subscriptions](#subscriptions) section.
- name: Account Management
- name: Trading
- name: Market Data
- name: Wallet
- name: Chat
paths:
/private/set_mmp_config:
get:
tags:
- Trading
- Matching Engine
- Private
description: >+
Configures Market Maker Protection (MMP) for a specific index. This
method sets the monitoring window, freeze duration, and exposure limits
(quantity, delta, vega, and Maximum Quote Quantity).
At least one limit parameter must be set. Maximum Quote Quantity (MQQ)
is a required parameter that limits the total combined size of open MMP
orders. MQQ is configured per index but enforced per side, per order
book (instrument).
The `interval` parameter defines the monitoring window duration in
seconds. The `frozen_time` parameter sets how long MMP remains active
after being triggered. Set `frozen_time` to `0` to disable automatic
reset (manual reset required).
For Mass Quotes, use the `mmp_group` parameter to configure MMP for a
specific group. Set `block_rfq` to `true` to configure MMP for Block RFQ
(requires `block_rfq:read_write` scope). Set `interval` to `0` to remove
MMP configuration.
**📖 Related Article:** [Market Maker Protection API
Configuration](https://docs.deribit.com/articles/market-maker-protection)
**Scope:** `trade:read_write` or `block_rfq:read_write` (when
`block_rfq` = `true`)
[Try in API
console](https://test.deribit.com/api_console?method=%2Fprivate%2Fset_mmp_config)
parameters:
- name: index_name
required: true
in: query
schema:
$ref: '#/components/schemas/index_name_derivative'
description: Index identifier of derivative instrument on the platform
- name: interval
required: true
in: query
schema:
type: integer
minimum: 0
maximum: 3600
example: 60
description: >
The duration of the monitoring window in seconds. For example, an
`interval` of `3` implies a 3-second window.
The `interval` begins after the first trade. If a new trade is
executed after the `interval` has ended, a new `interval` is
started, and counters reset. If a trade occurs during an already
running `interval`, that `interval` continues unaffected.
This mechanism allows the platform to track activity in short,
rolling windows to identify potentially risky trading behavior.
If set to `0`, MMP is removed.
Maximum value: `3600` seconds (1 hour).
- name: frozen_time
required: true
in: query
schema:
type: integer
minimum: 0
maximum: 3600
example: 0
description: >
Time in seconds that MMP remains active after being triggered. Once
this frozen period has passed, MMP will automatically reset,
allowing new orders to be submitted.
If you want to disable automatic reset, set `frozen_time` to `0`. In
that case, a manual reset is required using the `private/reset_mmp`
method.
Manual reset is also possible during the frozen time period.
Maximum value: `3600` seconds (1 hour).
- name: mmp_group
required: false
in: query
schema:
type: string
example: MassQuoteBot7
description: >
Designates the MMP group for which the configuration is being set.
If the specified group is already associated with a different
`index_name`, an error is returned. This parameter enables distinct
configurations for each MMP group, linked to particular
`index_name`. Maximum 64 characters. Case sensitive. Cannot be empty
string.
**📖 Related Article:** [Mass Quotes
Specifications](https://docs.deribit.com/articles/mass-quotes-specifications)
- name: quantity_limit
required: false
in: query
schema:
type: number
example: 3
description: >
The total traded quantity, measured in units of the base currency
(e.g., BTC in `BTC-PERPETUAL`), within the `interval`.
This count is direction-agnostic—a buy followed by a sell counts
double.
Example: Buy `10` BTC and sell `10` BTC = `20` total quantity.
Applicable to both options and futures.
Positive value with maximum 4 decimal places.
- name: delta_limit
required: false
in: query
schema:
type: number
description: >
The maximum allowable net transaction delta change during the
`interval`.
Expressed in units of base currency.
The `delta_limit` is treated as an absolute threshold: e.g.,
`delta_limit: 10` → MMP is triggered if net transaction delta
exceeds `+10` or drops below `-10`.
Direction matters: buying `+5` delta and selling `−5` delta cancels
out if within the same `interval`.
**Note:** Note that we use the net transaction delta instead of
delta. Net Transaction Delta = `Delta - Mark Price`. In the rest of
this document, "delta" actually refers to net transaction delta.
Positive value with maximum 4 decimal places.
- name: vega_limit
required: false
in: query
schema:
type: number
description: >
The maximum change in vega exposure allowed within a given
`interval`, measured in absolute terms.
Expressed in USD, representing the change in sensitivity to implied
volatility across executed trades.
This parameter is primarily relevant for options traders managing
risk in volatile markets.
Similar to `delta_limit`, the `vega_limit` is direction-aware and
evaluated on a net basis. If the exposure exceeds the set threshold
(positively or negatively), MMP will be triggered.
**Notice:** When evaluating Delta and Vega limits for MMP, Deribit
uses the greeks at the moment of trade execution. The system does
not re-evaluate Delta or Vega using live greeks at the time of MMP
checking.
Positive value with maximum 4 decimal places.
- name: max_quote_quantity
required: true
in: query
schema:
type: number
example: 2.5
description: >-
Maximum Quote Quantity (MQQ) in base currency. MQQ is configured per
index but enforced per side, per order book (instrument) — the total
combined size of open MMP orders per side per instrument cannot
exceed MQQ. **See response description for detailed information
about MQQ behavior and limitations.** Maximum 4 decimal places.
- name: block_rfq
required: false
in: query
schema:
type: boolean
default: false
description: >
If true, configures MMP for Block RFQ. When set, requires
`block_rfq` scope instead of `trade` scope. Block RFQ MMP settings
are completely separate from normal order/quote MMP settings.
- name: trade_count_limit
required: false
in: query
schema:
type: integer
maximum: 1000
minimum: 1
description: >-
For Block RFQ only (`block_rfq` = `true`). Sets the maximum number
of Block RFQ trades allowed in the lookback window. Each RFQ trade
counts as `+1` towards the limit (not individual legs). Works across
all currency pairs. When using this parameter, `index_name` must be
set to `"all"`. Maximum - `1000`.
requestBody:
content:
application/json:
examples:
request:
value:
jsonrpc: '2.0'
id: 7859
method: private/set_mmp_config
params:
index_name: btc_usd
mmp_group: MassQuoteBot7
interval: 60
frozen_time: 0
quantity_limit: 3
max_quote_quantity: 2.5
description: JSON-RPC Request Example
description: JSON-RPC request body
responses:
'200':
$ref: '#/components/responses/PrivateSetMmpConfigResponse'
components:
schemas:
index_name_derivative:
enum:
- btc_usd
- eth_usd
- btc_usdc
- eth_usdc
- ada_usdc
- algo_usdc
- avax_usdc
- bch_usdc
- bnb_usdc
- doge_usdc
- dot_usdc
- link_usdc
- ltc_usdc
- near_usdc
- paxg_usdc
- shib_usdc
- sol_usdc
- ton_usdc
- trx_usdc
- trump_usdc
- uni_usdc
- xrp_usdc
- usde_usdc
- buidl_usdc
- btcdvol_usdc
- ethdvol_usdc
- btc_usdt
- eth_usdt
- all
type: string
description: Index identifier of derivative instrument on the platform
PrivateSetMmpConfigResponse:
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The JSON-RPC version (2.0)
id:
type: integer
description: The id that was sent in the request
result:
type: array
items:
type: object
properties:
index_name:
$ref: '#/components/schemas/index_name'
interval:
type: integer
minimum: 0
maximum: 3600
description: >-
The duration of the monitoring window in seconds. For example,
an interval of 3 implies a 3-second
window.
The interval begins after the
first trade.
If a new trade is executed after the
interval has ended, a new interval
is started, and counters reset.
If a trade occurs
during an already running interval, that
interval continues unaffected.
This
mechanism allows the platform to track activity in short,
rolling windows to identify potentially risky trading
behavior.
If set to 0, MMP is disabled.
Maximum value: 3600 seconds (1 hour).
frozen_time:
type: integer
minimum: 0
maximum: 3600
description: >-
Time in seconds that MMP remains active after being triggered.
Once this frozen period has passed, MMP will automatically
reset, allowing new orders to be submitted.
If you
want to disable automatic reset, set frozen_time
to 0. In that case, a manual reset is required
using the private/reset_mmp method.
Manual reset is also possible during the frozen time
period.
Maximum value: 3600 seconds (1
hour).
id:
type: integer
format: int64
description: >-
Integer identifier for the MMP group (int64). This is the
programmatic identifier for the group. Entries without an
`mmp_group` name correspond to the orders MMP group (the
default group).
mmp_group:
type: string
description: >-
Name of the MMP group. Absent for the orders MMP group (the
default group), which has no string name — its entry is
identified by the `id` field alone.
quantity_limit:
type: number
description: >-
The total traded quantity, measured in units of the base
currency (e.g., BTC in BTC-PERPETUAL), within the
interval.
This count is
direction-agnostic—a buy followed by a sell counts double.
Example: Buy 10 BTC and sell
10 BTC = 20 total quantity.
Applicable to both options and futures.
Note: Once this is set, an initial
margin will be reserved even without any open positions.
Initial Margin due to quantity_limit =
quantity_limit * 0.03
Maximum 4 decimal places.
delta_limit:
type: number
description: >-
The maximum allowable net transaction delta change during the
interval.
Expressed in units of base
currency.
The delta_limit is treated as
an absolute threshold: e.g., delta_limit: 10 →
MMP is triggered if net transaction delta exceeds
+10 or drops below -10.
Direction matters: buying +5 delta and
selling −5 delta cancels out if within the same
interval.
Note: Note
that we use the net transaction delta instead of delta. Net
Transaction Delta = Delta - Mark Price. In the
rest of this document, "delta" actually refers to net
transaction delta.
Maximum 4 decimal places.
vega_limit:
type: number
description: >-
The maximum change in vega exposure allowed within a given
interval, measured in absolute terms.
Expressed in USD, representing the change in
sensitivity to implied volatility across executed trades.
This parameter is primarily relevant for options
traders managing risk in volatile markets.
Similar to
delta_limit, the vega_limit is
direction-aware and evaluated on a net basis. If the exposure
exceeds the set threshold (positively or negatively), MMP will
be triggered.
Notice: When evaluating
Delta and Vega limits for MMP, Deribit uses the greeks at the
moment of trade execution. The system does not re-evaluate
Delta or Vega using live greeks at the time of MMP checking.
Maximum 4 decimal places.
max_quote_quantity:
type: number
description: >-
Maximum Quote Quantity (MQQ). MQQ is configured per index but
enforced per side, per order book (instrument) — the total
combined size of open MMP orders per side per instrument
cannot exceed MQQ (specified in base currency). MQQ is used
for Initial Margin calculation (3% of MQQ is taken as Initial
Margin for MMP orders and quotes).
**Important
Notes:**
- **Configured per index, enforced per
instrument:** MQQ is configured at the index level (an MMP
group is linked to an index). However, the limit is enforced
separately per order book (instrument) per side. "Per order
book" means per instrument (not per expiry). The limit is NOT
the sum across all instruments — each instrument has its own
separate MQQ enforcement.
- **MQQ limits cumulative size,
not order count:** For example, with MQQ of 3 BTC, you can
place multiple orders (three orders of 1 BTC each, or one
order of 2.5 BTC plus one of 0.5 BTC) as long as the total
size per side per instrument does not exceed 3 BTC
- **MQQ
is separate per MMP group:** Each MMP group has its own
independent MQQ configuration. MQQ limits are enforced
separately for each MMP group.
- **MQQ vs Quantity Limit
relationship:** You can set MQQ > `quantity_limit`. This
allows quotes to be larger than the quantity limit, and
enables MMP to trigger on partial fills of quotes. This
decouples the MMP reserved margin from the MMP quantity limit.
- **Base currency:** MQQ is specified and enforced in base
currency
- **Inverse futures:** Size is calculated as
Amount / Price to convert to base currency
- **Inverse
future spreads:** Size is calculated as Amount / IndexPrice
- **SM accounts:** MMP orders and quotes on options and
option_combos are not supported for SM accounts
-
**Rejections:** MQQ is enforced for **MMP-enabled orders and
quotes**. Quote entries and MMP-enabled orders (i.e., orders
with `mmp=true`) are rejected if their individual size is
greater than `max_quote_quantity`, or if accepting them would
make the total open MMP size per side per instrument exceed
`max_quote_quantity`. Non‑MMP orders are not subject to MQQ
and may be larger than `max_quote_quantity`.
-
**Precision:** All MMP configuration values support maximum 4
decimal places
- **Latency:** There are no latency
benefits from MQQ if you already use mass quotes.
block_rfq:
type: boolean
description: >-
If true, indicates MMP configuration for Block RFQ. Block RFQ
MMP settings are completely separate from normal order/quote
MMP settings.
trade_count_limit:
type: integer
description: >-
For Block RFQ only. The maximum number of Block RFQ trades
allowed in the lookback window. Each RFQ trade counts as +1
towards the limit (not individual legs). Works across all
currency pairs.
required:
- index_name
- interval
- frozen_time
required:
- jsonrpc
- result
type: object
index_name:
enum:
- btc_usd
- eth_usd
- ada_usdc
- algo_usdc
- avax_usdc
- bch_usdc
- bnb_usdc
- btc_usdc
- btcdvol_usdc
- buidl_usdc
- doge_usdc
- dot_usdc
- eurr_usdc
- eth_usdc
- ethdvol_usdc
- link_usdc
- ltc_usdc
- near_usdc
- paxg_usdc
- shib_usdc
- sol_usdc
- steth_usdc
- ton_usdc
- trump_usdc
- trx_usdc
- uni_usdc
- usde_usdc
- usyc_usdc
- xrp_usdc
- btc_usdt
- eth_usdt
- eurr_usdt
- sol_usdt
- steth_usdt
- usdc_usdt
- usde_usdt
- btc_eurr
- btc_usde
- btc_usyc
- eth_btc
- eth_eurr
- eth_usde
- eth_usyc
- steth_eth
- paxg_btc
- drbfix-btc_usdc
- drbfix-eth_usdc
type: string
description: Index identifier, matches (base) cryptocurrency with quote currency
responses:
PrivateSetMmpConfigResponse:
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateSetMmpConfigResponse'
examples:
response:
value:
jsonrpc: '2.0'
id: 7859
method: private/set_mmp_config
result:
index_name: btc_usd
mmp_group: MassQuoteBot7
interval: 60
frozen_time: 0
quantity_limit: 3
max_quote_quantity: 2.5
description: Response example
description: Success response
````