private/get_mmp_status

Get Market Maker Protection (MMP) status for triggered index (or group). Returns the live MMP state for the index, including whether MMP is enabled or triggered, remaining frozen time (if triggered), whether quoting is currently allowed, and any active freeze conditions. If the parameter is not provided, a list of all triggered MMP statuses is returned. This method lets you track whether protection is active and when quoting will resume.

📖 Related Article: Market Maker Protection API Configuration

Scope: trade:read or block_rfq:read (when block_rfq = true)

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_mmp_status \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 7851,
  "method": "private/get_mmp_status",
  "params": {
    "index_name": "btc_usd",
    "mmp_group": "MassQuoteBot7"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 7851,
  "result": [
    {
      "index_name": "btc_usd",
      "frozen_until": 1744275841861,
      "mmp_group": "MassQuoteBot7"
    }
  ]
}

Query Parameters

index_name · enum<string>

Index identifier of derivative instrument on the platform

Available options: 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

mmp_group · string

Specifies the MMP group for which the status is being retrieved. The index_name must be specified before using this parameter.

📖 Related Article: Mass Quotes Specifications

Example:

"MassQuoteBot7"

block_rfq · boolean · default: false

If true, retrieves MMP status for Block RFQ. When set, requires block_rfq scope instead of trade scope. Block RFQ MMP status is completely separate from normal order/quote MMP status.

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object[] · required

Show child attributes

id · integer

The id that was sent in the request