Atención
Cumplimiento en toda la bolsa (política de uso de OTV y API)
Todo el tráfico de API, ya sea autenticado o público,debe seguir las normas más amplias de integridad comercial de Deribit, incluida la Límites entre pedidos y volúmenes (OTV) y otras protecciones contra el abuso. Las infracciones pueden provocar la desconexión inmediata de la sesión, la limitación adicional o la adopción de medidas coercitivas más estrictas
Para ver las directrices completas, consulta nuestra Política de uso de API (que también cubre los umbrales de OTV y otras reglas de abuso bursátil).
Para mantener un acceso justo y estable a nuestra API, Deribit utiliza un sistema de limitación de tasas basado en créditos. Este sistema garantiza un uso eficiente de los recursos de la plataforma y, al mismo tiempo, se adapta
Sistema basado en créditos
Cada solicitud de API consume una cantidad determinada de créditos. La tasa de recarga y la reserva máxima de créditos de su cuenta dependen de su nivel y actividad de negociación Si llega una solicitud y ya no quedan créditos, le enviamos inmediatamente una too_many_requests (code 10028) o un error similar y finaliza la sesión. Tras una desconexión, debes esperar a que se repongan los créditos y, a continuación, restablecer una nueva conexión antes de enviar solicitudes adicionales.
Los elementos clave de este sistema incluyen:
Recarga de crédito
Los créditos son se repone de forma continua a una tasa fija, según el nivel de tu cuenta. Esta recarga actúa como un balde con fugas: cada segundo, una cantidad determinada de créditos «vuelven» al fondo de crédito de tu cuenta. Puedes pensar en esto como una tasa de recarga de «créditos por segundo» (CPS)
Nota
Se aplican límites de tarifas por subcuenta. Cada subcuenta tiene su propio límite de tasa independiente
-
Ejemplo: Si tu tasa de recarga es de 20 créditos por segundo y cada solicitud cuesta 1 crédito, puedes enviar 20 solicitudes por segundo de forma sostenible sin agotar tus créditos.
-
La recarga continúa incluso cuando no estás haciendo solicitudes, lo que le permite acumular créditos hasta su límite máximo de crédito.
-
Si tu límite máximo de crédito es de 200 y tu tasa de recarga es de 20 créditos por segundo, tardarás 10 segundos en repostar por completo de 0 a 200.
Este mecanismo de recarga ayuda a:
-
Permitir actividad de ráfaga (p. ej., enviar varios pedidos a la vez), siempre y cuando no supere el límite máximo de crédito.
-
Fomentar un uso consistente y predecible, minimizando las sobretensiones repentinas que podrían sobrecargar el sistema.
Créditos máximos
Este es el límite superior de su fondo de crédito disponible. No puedes acumular más créditos que este límite, independientemente del tiempo que esperes. Determina el tamaño de las ráfagas de solicitudes que puedes realizar
Coste por solicitud
Cada punto final de la API consume una cantidad diferente de créditos. Los puntos finales que consumen más recursos pueden costar más que los más ligeros
Sugerencia
El uso de suscripciones a WebSocket para obtener datos en tiempo real reduce el consumo de crédito REST.
Importante
El public/get_instruments endpoint tiene un límite de velocidad único: 1 solicitud cada 10 segundos, con un margen de ráfagas de 5. Este límite se aplica por separado del sistema de crédito estándar.
Los siguientes métodos tienen límites de velocidad personalizados que difieren de los valores predeterminados estándar del motor que no coinciden:
|
Método |
Coste |
Créditos |
Tasa sostenida |
Capacidad de ráfaga |
|---|---|---|---|---|
|
|
10,000 |
500,000 |
1 solicitud/segundo |
50 solicitudes |
|
|
3,000 |
30,000 |
~3,3 solicitudes/segundo |
10 solicitudes |
|
|
100,000 |
600,000 |
6 solicitudes/minuto |
6 solicitudes |
|
|
10,000 |
80,000 |
1 solicitud/segundo |
8 solicitudes |
Estos límites se aplican utilizando el mismo sistema basado en créditos que otros métodos, pero con diferentes configuraciones de costos y fondos de crédito.
Nota
Límites de tarifas descritos en este artículo no se aplican a las cotizaciones masivas. Mass Quotes sigue sus propias reglas específicas de limitación de tarifas, que se documentan por separado Artículo sobre especificaciones de Mass Quotes.
Aviso
El uso de la página web también consume créditos de API
Tenga en cuenta que al usar el Plataforma web Deribit también genera solicitudes de API entre bastidores. Esto significa navegar por ciertas páginas (por ejemplo, la cartera de pedidos, las posiciones, la información de la cuenta) puede consumir créditos de tu límite de velocidad de API, al igual que las llamadas programáticas a la API.
Si está ejecutando scripts automatizados o robots de negociación en paralelo con una sesión web abierta de Deribit, es posible que alcance su límite de crédito más rápido de lo esperado. Cuando esto suceda, es posible que recibas un too_many_requests error (código) 10028), incluso si su script parece estar dentro del volumen de solicitudes esperado.
Para optimizar el rendimiento:
-
Evite mantener abiertas varias pestañas del navegador en páginas con uso intensivo de datos.
-
Considere cerrar sesión en la interfaz web cuando ejecute estrategias de alta frecuencia.
-
Nota: Si personalizas una página de negociación añadiendo más componentes, eso puede afectar al límite de la tasa.
Solicitudes de motor coincidentes y no coincidentes
Hay dos categorías principales de solicitudes de API:
-
Solicitudes de motor coincidentes: Interactúan con la cartera de pedidos, por ejemplo, al realizar o cancelar un pedido.
-
Solicitudes de motor que no coinciden: Se trata de consultas generales, como la recuperación de información de cuentas o datos de mercado.
Cada tipo de solicitud consume créditos a un ritmo diferente.
Configuración predeterminada para solicitudes de motor que no coinciden
-
Coste por solicitud: 500 créditos.
-
Créditos máximos: 50 000 créditos.
-
Tasa de recarga: Los créditos se rellenan a un ritmo que permite hasta 20 solicitudes por segundo (10 000 créditos por segundo).
-
Capacidad de ráfaga: Permite hasta 100 solicitudes a la vez, teniendo en cuenta la reserva máxima de créditos.
Ejemplo de ráfaga y recarga (valores predeterminados que no coinciden)
Aviso
Todos los valores límite de velocidad en este ejemplo son solo ilustrativos. Describen cómo funciona el mecanismo y no representan sus
-
El contador de ráfagas comienza con 50 000 créditos(la piscina máxima).
-
Cada solicitud cuesta 500 créditos; 100 solicitudes consecutivas agotarían por completo la reserva si ignoras las recargas.
-
Créditos rellenar de forma continua en 10 créditos por milisegundo (10 000 por segundo) incluso cuando estás explotando.
-
Si los créditos llegan a cero, las nuevas solicitudes fallan con
too_many_requests(código10028). -
Tráfico sostenido en 20 solicitudes/s(20 × 500 = 10 000) coincide con la tasa de recarga, por lo que la piscina se mantiene estable. Un rápido Ráfaga de más de 100 solicitudes aún puede activarse
10028si supera los créditos actuales. -
Si golpeas
10028y necesito cancelar pedidos, esperando ~50 ms restaura ~500 créditos (10 créditos/ms), suficientes para enviar una cancelación masiva.
Solicitudes de motor coincidentes
Cada subcuenta tiene un límite de tarifa actualizado por hora, que se aplica a todos los libros. Los usuarios pueden comprobar sus límites de tarifas actuales a través del /private/get_account_summary método.
|
Nivel de nivel |
Volumen de operaciones de 7 días |
Límite de velocidad sostenido (solicitudes/segundo) |
Límite de velocidad de ráfaga |
Descripción |
|
Nivel 1 |
Más de 25 millones de dólares |
30 solicitudes/segundo |
100 solicitudes (ráfaga) |
Adecuado para operadores de gran volumen, ya que permite hasta 100 solicitudes en una ráfaga rápida o una velocidad constante de 30 solicitudes por segundo. |
|
Nivel 2 |
Más de 5 millones de dólares |
20 solicitudes/segundo |
50 solicitudes (ráfaga) |
Diseñado para operadores de volumen medio, permite hasta 50 solicitudes en ráfaga o 20 solicitudes por segundo. |
|
Nivel 3 |
Más de 1 millón de dólares |
10 solicitudes/segundo |
30 solicitudes (ráfaga) |
Adecuado para operadores activos, ya que permite hasta 30 solicitudes en ráfaga o 10 solicitudes por segundo. |
|
Nivel 4 |
Hasta 1 millón de USD |
5 solicitudes/segundo |
20 solicitudes (ráfaga) |
Para los operadores habituales, permite hasta 20 solicitudes en una ráfaga o una velocidad constante de 5 solicitudes por segundo. |
Actualizaciones automáticas de límites de velocidad
-
Recalculamos los límites cada hora. No hay ningún retraso de «volumen/7 por día»; el volumen de operaciones más reciente de 7 días se evalúa cada hora para cada subcuenta
-
Ventana de volumen: el final 7 días el volumen de operaciones determina su nivel. Cada recálculo por hora utiliza la última suma de 7 días
-
Actualizaciones: si tu volumen de 7 días supera el umbral de un nivel superior durante una comprobación cada hora, te transferimos inmediatamente a ese nivel (podemos saltarnos los niveles intermedios; por ejemplo, es posible pasar del nivel 1 directamente al nivel 4).
-
Rebajas: durante un control cada hora, si tu volumen de 7 días cae por debajo del límite de tu nivel actual después de haberlo superado la hora anterior, los límites se reducen en consecuencia. También puedes saltarte los niveles si el volumen de 7 días supera varios umbrales
Importante
Limitaciones de acceso público
Público, no autorizado Las solicitudes de API tienen una velocidad limitada en un Por IP—no se basan en el fondo de crédito a nivel de cuenta. Si una IP supera su límite de solicitudes públicas, es posible que se realicen llamadas posteriores rechazada temporalmente o la conexión desconectado para proteger la estabilidad de la plataforma.
Siempre que sea posible, utilice solicitudes autorizadas vinculadas a tu clave de API. El tráfico autenticado se beneficia de
-
Límites más altos y transparentes que escalan con el nivel de tu cuenta.
-
Visibilidad de ID de cliente, lo que nos permite distinguir entre el uso intensivo y legítimo del tráfico abusivo, de modo que, en lugar de un bloqueo inmediato, podemos aplicar medidas de seguridad graduales si se supera el límite.
En resumen, las solicitudes autorizadas son siempre la opción más segura y confiable para un acceso sostenido o de alta frecuencia.
Importante
Producción y Entorno Testnet operar en grupos de límites de tarifas separados y rastreados de forma independiente. Los límites no se comparten entre entornos: superar los límites de Testnet no afectará a tus créditos de producción y viceversa.
Verificación de los límites de tarifas actuales
Los usuarios pueden acceder a los límites de tarifas actuales llamando al /private/get_account_summary método y recepción limits campo en respuesta. La configuración de los límites de los tipos de cambio puede realizarse por divisa o mediante un conjunto predeterminado que se aplique globalmente en todas las divisas. Los límites por moneda no son la configuración predeterminada y solo están habilitados para clientes específicos que lo soliciten
Aviso
Actualmente se utilizan límites de tipos por divisa exclusivamente para disminuir límites de acceso para monedas específicas cuando sea necesario. No se aplican para aumentar los límites de las tasas.
Campo Límites
non_matching_engine: describe los límites de velocidad aplicables a las solicitudes que no utilizan el motor de búsqueda. Definido por:
-
burst: el número máximo de solicitudes permitido en una ráfaga corta. -
rate: El número sostenido de solicitudes permitidas a lo largo del tiempo.
matching_engine: describe los límites de velocidad relacionados con las operaciones que utilizan el motor de búsqueda de coincidencias, con la siguiente estructura:
Límites comunes para todas las configuraciones
Límites de detección y cancelación
-
spot: Se aplica a las operaciones al contado entre dos divisas diferentes. -
cancel_all: se usa para cancelar todos los pedidos a nivel mundial o por etiqueta sin especificar una moneda.
Límites globales frente a límites por divisa
-
¿Cuándo?
limits_per_currency=false, los límites se aplican a nivel mundial:-
trading: Operaciones comerciales generales -
maximum_quotes: número total de cotizaciones -
maximum_mass_quotes: Operaciones de cotización masiva -
guaranteed_mass_quotes: Cotizaciones masivas garantizadas
-
-
¿Cuándo?
limits_per_currency=true, los límites están establecidos por moneda de liquidación bajo elmatching_engineobjeto:-
Cada clave de divisa incluye:
-
trading: Límites de negociación por divisa -
maximum_quotes: límites de cotización por divisa -
maximum_mass_quotes: Límites de cotización masiva por divisa -
guaranteed_mass_quotes: cotizaciones masivas garantizadas por divisa
-
-
Cancelar Endpoint Logic
-
privado/cancel_todo: Usa el global
cancel_alllímite. -
privado/cancelar_todo_por_divisa/instrumento: Aplica el límite de negociación o al contado correspondiente para la divisa o el instrumento especificado.
-
privado/cancelar_todo_por_tipo:
-
No se especificó ninguna moneda → usa cancel_all
-
Divisa específica → usa el límite de negociación por moneda
-
Instrumento puntual → utiliza el límite puntual
-
Ejemplo para usuarios sin configuración por moneda (predeterminado):
{
"non_matching_engine": {
"burst": 1500,
"rate": 1000
},
"limits_per_currency": false,
"matching_engine": {
"trading": {
"total": {
"burst": 20,
"rate": 5
}
},
"spot": {
"burst": 250,
"rate": 200
},
"maximum_quotes": {
"burst": 500,
"rate": 500
},
"maximum_mass_quotes": {
"burst": 10,
"rate": 10
},
"guaranteed_mass_quotes": {
"burst": 2,
"rate": 2
},
"cancel_all": {
"burst": 250,
"rate": 200
}
}
}
Ejemplo para usuarios con una configuración por moneda:
{
"non_matching_engine": {
"burst": 1500,
"rate": 1000
},
"limits_per_currency": true,
"matching_engine": {
"cancel_all": {
"burst": 250,
"rate": 200
},
"spot": {
"burst": 250,
"rate": 200
},
"usdt": {
"maximum_quotes": {
"burst": 500,
"rate": 500
},
"maximum_mass_quotes": {
"burst": 10,
"rate": 10
},
"guaranteed_mass_quotes": {
"burst": 2,
"rate": 2
},
"trading": {
"total": {
"burst": 250,
"rate": 200
}
}
},
"usdc": {
"maximum_quotes": {
"burst": 500,
"rate": 500
},
"maximum_mass_quotes": {
"burst": 10,
"rate": 10
},
"guaranteed_mass_quotes": {
"burst": 2,
"rate": 2
},
"trading": {
"total": {
"burst": 250,
"rate": 200
}
}
},
"eth": {
"maximum_quotes": {
"burst": 500,
"rate": 500
},
"maximum_mass_quotes": {
"burst": 10,
"rate": 10
},
"guaranteed_mass_quotes": {
"burst": 2,
"rate": 2
},
"trading": {
"total": {
"burst": 250,
"rate": 200
}
}
},
"btc": {
"maximum_quotes": {
"burst": 500,
"rate": 500
},
"maximum_mass_quotes": {
"burst": 10,
"rate": 10
},
"guaranteed_mass_quotes": {
"burst": 2,
"rate": 2
},
"trading": {
"perpetuals": {
"burst": 20,
"rate": 10
},
"total": {
"burst": 150,
"rate": 100
}
}
}
}
}
Descripción general de las solicitudes del motor coincidente
Todas las solicitudes no se enumeran a continuación se tratan como motor no coincidente solicitudes.
-
private/buy -
private/sell -
private/edit -
private/edit_by_label -
private/cancel -
private/cancel_by_label -
private/cancel_all -
private/cancel_all_by_instrument -
private/cancel_all_by_currency -
private/cancel_all_by_kind_or_type -
private/close_position -
private/verify_block_trade -
private/execute_block_trade -
private/move_positions -
private/mass_quote -
private/cancel_quotes -
private/add_block_rfq_quote -
private/edit_block_rfq_quote -
private/cancel_block_rfq_quote -
private/cancel_all_block_rfq_quotes
Tipos de mensajes FIX
-
new_order_single -
order_cancel_request -
order_mass_cancel_request -
order_cancel_replace_request -
mass_quote -
quote_cancel