1. Deribit Soporte
  2. Soporte
  3. Información técnica

Configuración de la API de protección de Market Maker

  • Actualización

Deribit proporciona un conjunto de métodos de API para administrar Market Maker Protection (MMP) ajustes. Estos métodos permiten la configuración y el monitoreo en tiempo real de los parámetros del MMP, lo que garantiza una gestión de riesgos eficiente para los creadores de mercado

Cada configuración de MMP contiene los siguientes parámetros clave:

  • Límite de cantidad — Se permite el volumen total negociado máximo (en la divisa base) antes de que se active el MMP.

  • Límite delta — Exposición direccional máxima.

  • Límite de Vega — (Solo opciones) Se permite un cambio máximo en la exposición a Vega antes de que se active.

  • Intervalo de tiempo — Período de tiempo (en segundos) durante el cual se miden los límites.

  • Tiempo congelado — Duración (en segundos) durante la cual las cotizaciones permanecen inhabilitadas tras la activación de un MMP.

  • Cantidad máxima de cotización (MQQ) — Tamaño máximo combinado de pedidos de MMP abiertos por lado, por índice.

Nota

Los grupos MMP existen pero solo se aplican a Especificaciones de Mass Quotes. Para la cotización estándar basada en pedidos, la configuración de MMP se define por índice

Todos los parámetros de configuración admiten hasta 4 decimales de precisión. Cada límite se monitorea de forma independiente. ¿alguien? se infringe, se cancelan todos los pedidos con la etiqueta MMP y se bloquea según lo configurado frozen_time.

Para obtener detalles completos sobre la configuración y la administración de MMP, consulte la Documentación de la API de Deribit.

Sugerencia

Los ajustes de MMP también se pueden configurar en Página de configuración de la cuenta

mmp_settings.png

Comprender el intervalo frente al tiempo congelado

Estos dos parámetros obligatorios cumplen diferentes funciones dentro del sistema MMP:

intervalo — Ventana de monitorización

El interval define durante cuánto tiempo Deribit monitorea la actividad comercial después de la primera operación ocurre:

  • Comienza después del primera operación.

  • Si no se realizan nuevas operaciones una vez finalizado el intervalo, un comienza un nuevo intervalo con la próxima operación.

  • Si las operaciones se producen durante el intervalo, continúa sin interrupciones.

  • Esto crea ventanas cortas y continuas que se utilizan para detectar posibles estallidos de exposición o comportamientos bursátiles riesgosos.

  • Toda la actividad dentro de un solo intervalo se cuenta para los límites de MMP.

  • Si se establece en 0, se elimina el MMP.

tiempo congelado — Duración de la congelación

El frozen_time define cuánto tiempo permanece MMP activó y bloqueó nuevos pedidos de MMP después de infringir un límite:

  • Durante el período congelado, la cotización de ese índice es deshabilitado.

  • Una vez finalizado el período de congelación, MMP se restablece automáticamente.

  • Configuración frozen_time = 0 desactiva el restablecimiento automático. En este caso

Comprensión de la cantidad máxima de cotización (MQQ)

Importante

La cantidad máxima de cotización estará disponible después 25 de noviembre de 2025 lanzamiento.

Cantidad máxima de cotización (MQQ) define el límite acumulado del tamaño total de las cotizaciones u órdenes de MMP abiertas por lado, por instrumento (libro de pedidos). Actúa como un límite de exposición, evitando un volumen de cotización excesivo incluso antes de que se produzcan las operaciones

Conceptos clave

  • Por instrumento (libro de pedidos):

    Se aplica MQQ de forma independiente para cada instrumento, no se agregan entre los instrumentos ni caducan. Cada instrumento (cartera de pedidos) tiene su propio límite de MQQ independiente

  • Límite de tamaño acumulado, no número de pedidos:

    MQQ limita la tamaño total combinado de pedidos MMP abiertos por lado, no del número de pedidos.

    Ejemplo: con MQQ = 3 BTC, puedes realizar tres pedidos de 1 BTC, o uno de 2,5 BTC y otro de 0,5 BTC, siempre que el total por lado por instrumento sea inferior a 3 BTC.

  • Independiente por grupo MMP:

    Cada grupo MMP (usado solo para cotizaciones masivas) tiene su propia configuración de MQQ. Los límites se aplican por separado para cada grupo

  • Relación con el límite de cantidad:

    Se puede configurar MQQ mayor que quantity_limit.

    Esto permite abrir cotizaciones más grandes y, al mismo tiempo, permite que MMP se active en caso de reposiciones parciales, y desvincula el margen reservado de MMP del límite de cantidad.

  • Aplicación de la moneda base:

    MQQ se especifica y se aplica en moneda base del instrumento.

  • Cálculos de tamaño:

    • Futuros inversos: tamaño = cantidad/precio

    • Diferenciales inversos: tamaño = importe /índice/precio

      (Cambiando a precio mínimo de mercado de las piernas en diciembre de 2025.)

  • Limitaciones de la cuenta:

    Los pedidos y cotizaciones de MMP sobre opciones o combinaciones de opciones son no es compatible para cuentas SMS.

  • Rechazos y validaciones:

    • Cotizaciones o pedidos de MMP que superen max_quote_quantity son rechazados.

    • Es posible que los pedidos regulares superiores al MQQ aún ingresen al mercado, pero las nuevas cotizaciones que superarían el límite son no se aceptan.

    • A partir de diciembre de 2025, si se rechaza una cara de una cotización bilateral, también se rechazará la otra cara.

  • Precisión:

    Todos los parámetros de configuración de MMP, incluido MQQ, admiten hasta cuatro decimales.

  • Cálculo del margen:

    • A partir de la versión 18.11.2025: margen reservado = max (MQQ, quantity_limit)

    • A partir de la versión de diciembre de 2025: margen reservado = max_quote_quantity (≈ 3% del MQQ)

    • Este cambio cambia la lógica de los márgenes de MMP de los límites de tamaño de las cotizaciones a la exposición activa de las cotizaciones.

  • Latencia:

    MQQ proporciona sin ventaja de latencia si ya usas cotización masiva funcionalidad; simplemente añade el control de exposición.

Comprensión de otros parámetros

nombre_índice

Identificador del instrumento derivado (índice) en la plataforma Deribit, como btc_usd o eth_usd. Todos los ajustes de configuración se aplicarán específicamente a este índice.

límite de cantidad

El cantidad total negociada, medido en unidades del moneda base(p. ej., BTC en BTC-PERPETUAL), dentro del intervalo.

  • Este recuento es independiente de la dirección —una compra seguida de una venta cuenta el doble.

    Ejemplo:Compra 10 BTC y vende 10 BTC = 20 en total.

  • Aplicable a ambos opciones y futuros.

    Nota

    Una vez establecido, se reservará un margen inicial incluso sin ninguna posición abierta. initial_margin = quantity_limit * 0.03

límite delta

El máximo permitido delta neto de transacciones cambia durante el intervalo.

  • Expresado en unidades de divisa base.

  • El límite delta se trata como un umbral absoluto:

    p. ej.,delta_limit: 10 → El MMP se activa si el delta neto de la transacción supera los +10 o cae por debajo de -10.

  • La dirección importa: comprar +5 delta y vender −5 delta cancela si está dentro del mismo intervalo.

    Nota

    Nota que utilizamos el delta de transacción neta en lugar de delta.

    Delta neto de la transacción = Delta - Precio de referencia.

    En el resto de este documento, «delta» en realidad se refiere al delta neto de la transacción

límite vega

El cambio máximo en la exposición a Vega permitido dentro de un intervalo determinado, medido en términos absolutos.

  • Expresado en USD, que representa el cambio en la sensibilidad a la volatilidad implícita en las operaciones ejecutadas.

  • Este parámetro es principalmente relevante para operadores de opciones gestionar el riesgo en mercados volátiles.

  • Similar a delta_limit, el vega_limit reconoce la dirección y se evalúa en un en términos netos. Si la exposición supera el umbral establecido (positiva o negativamente), se activará el MMP

Aviso

Al evaluar los límites de Delta y Vega para MMP, Deribit utiliza el griegos en el momento de la ejecución de la operación. El sistema no vuelve a evaluar Delta o Vega utilizaban griegos vivos en el momento de comprobar el MMP.

grupo_mmp

Especifica el grupo MMP utilizado para las cotizaciones masivas. Si se omite, los métodos se aplican a la configuración predeterminada de MMP

Aviso

Los grupos MMP son una función dedicada a las cotizaciones masivas y no están disponibles para el flujo de pedidos normal. Para obtener más información sobre cómo usar los grupos MMP con Mass Quotes Especificaciones de Mass Quotes

block_rfq

Cuando se establece en true, los métodos se aplican a la configuración de Block RFQ MMP. Consulte Tutorial de la API Deribit Block RFQ para obtener más información.

Configuración de MMP

Para configurar Market Maker Protection (MMP) para un determinado índice, debe definir la ventana de monitoreo, la duración de la congelación y al menos un límite de exposición. La configuración de MMP se aplica mediante private/set_mmp_configmétodo.

Parámetros requeridos

  • nombre_índice

    El índice para el que se está configurando MMP (p. ej., btc_usd, eth_usd).

  • intervalo

    Duración (en segundos) del ventana de monitoreo utilizado para rastrear la actividad comercial.

  • tiempo congelado

    Duración (en segundos) durante la que permanece el MMP activo/congelado una vez activado.

  • Al menos un parámetro límite

    Debe establecer al menos una de las siguientes opciones:

    • quantity_limit

    • delta_limit

    • vega_limit

    • max_quote_quantity (MQQ)

      Atención

      Tras el lanzamiento de diciembre de 2025, Se aplicará el MQQ como parámetro obligatorio.

Ejemplo
{
 «jsonrpc»: «2.0",
 «identificación»: 42,
 «método»: «private/set_mmp_config»,
 «parámetros»: {
 «index_name»: «btc_usd»,
 «intervalo»: 3,
 «frozen_time»: 30,
 «límite de cantidad»: 5.0,
 «delta_limit»: 15,0,
 «cantidad_máxima de cotización»: 2.0
 }

Una vez que se envía esta configuración, el sistema aplica MMP para el índice seleccionado en función de los parámetros configurados.

Nota

Bloquear RFQ MMP

MMP también se puede configurar para Solicitud de presupuesto de bloque citando. El proceso de configuración de Block RFQ MMP se describe Tutorial de la API Deribit Block RFQ artículo.

Restablecer MMP

Si su protección de MMP se ha activado y las cotizaciones están congeladas para un índice determinado, puede reanudar las cotizaciones automáticamente después del tiempo de congelación configurado o manualmente a través de la API mediante private/reset_mmp.

Comportamiento

  • Si está configurado frozen_time ha caducado, el sistema restablecerá automáticamente el MMP y los currículums cotizados para ese índice.

  • Si frozen_time está establecido en 0 (reinicio automático desactivado), tú debe llamar private/reset_mmp para volver a habilitar las cotizaciones.

  • También puede realizar un restablecimiento manual durante el período congelado si desea reanudar las cotizaciones anticipadamente.

  • Tras el restablecimiento, la configuración anterior de MMP permanece sin cambios (los límites, el intervalo, etc. permanecen vigentes).

Realizar pedidos con el indicador MMP

Los clientes pueden controlar si las órdenes limitadas individuales están sujetas a la protección de Market Maker configurando el mmp marcar en las solicitudes de compra, venta o edición.

  • Para habilitar o deshabilitar MMP para un pedido específico, incluye "mmp«: true o "mmp«: false en la solicitud.

  • Si solo estás actualizando precio o tamaño y deseo conservar la configuración actual de MMP, simplemente puede omitir el parámetro mmp; su estado permanecerá inalterado.

  • El método de edición permite cambiar la marca MMP, lo que le permite aplicar o eliminar la protección sin cancelar y volver a enviar el pedido.

Monitorización de MMP

Puede supervisar tanto los configuración actual y el estado MMP en vivo para cualquier índice que utilice dos métodos de API.

1. Comprobación de la configuración actual de MMP

Llamando private/get_mmp_config devuelve todos los parámetros MMP actualmente activos para el índice seleccionado, incluido el interval, frozen_time, límites de cantidad/delta/vega y max_quote_quantity. Esto es útil para verificar la configuración o confirmar las actualizaciones aplicadas

2. Comprobación del estado actual del MMP

Llamando private/get_mmp_status devuelve el estado MMP en vivo del índice, que incluye:

  • Si MMP es habilitado o activado

  • Tiempo restante congelado (si se activa)

  • Si las cotizaciones están permitidas actualmente

  • Cualquier condición de congelación activa

Este método le permite controlar si la protección está activa y cuándo se reanudará la cotización.

Eventos y notificaciones de MMP

Deribit proporciona información en tiempo real sobre la actividad de MMP (Market Maker Protection) a través de user.mmp_trigger. {index_name} suscripción e indicadores de eventos, que permiten a los clientes reaccionar rápidamente cuando se activa la protección.

Los clientes pueden suscribirse al canal:

usuario.mmp_trigger. {index_name}

Sustituya {index_name} por el índice del instrumento deseado, por ejemplo:

usuario.mmp_trigger.btc

Cuando se active el MMP para un índice determinado, el cliente recibirá un activar una notificación en el siguiente formato:

{«frozen_until»: 1594390902986}

  • El valor es un Marca de tiempo de Unix en milisegundos indica hasta que el MMP está activo (es decir, las órdenes permanecen bloqueadas).

  • Si frozen_until: 0, significa que MMP permanecerá activo hasta que se restablezca manualmente utilizando el private/reset_mmp método.

Esta notificación permite al cliente realizar un seguimiento Estado de MMP por índice y evite enviar nuevos pedidos que puedan ser rechazados debido a la actual congelación de las MMP.

Indicadores MMP en las respuestas de WebSocket

Además del canal de eventos, Deribit también comunica las acciones relacionadas con MMP-Trigger mediante un campo especial en ordenar mensajes de eventos.

Si se cancela un pedido como resultado directo de una activación de MMP, el evento de pedido incluirá:

{«mmp_cancelled»: verdadero}

Este campo será ausente en todos los demás casos, permite a los clientes distinguir claramente entre las cancelaciones relacionadas con el MMP y otras razones (por ejemplo, las cancelaciones manuales, por tiempo de espera o por API de usuario).

Mejores prácticas

  • Supervise ambos user.mmp_trigger eventos y mmp_cancelled marcas para tener una visión completa de su actividad de cotización y su estado de protección.

  • Al recibir un frozen_until marca de tiempo, deberías pausar el envío de cotizaciones para el índice afectado hasta que finalice el período de congelación o hasta que restablezca manualmente el MMP.

  • Maneje siempre el mmp_cancelled marca de forma explícita en la lógica de gestión de pedidos para evitar que se vuelvan a enviar pedidos que puedan volver a cancelarse inmediatamente.

Configuración FIX

Revise las especificaciones FIX aquí: https://docs.deribit.com/#mmprotection-limits-mm