Preguntas frecuentes
Inicio
Centro de soporte
Preguntas frecuentes
Cripto-derivados
Opciones
Binance Options
Interfaz API y Websocket de Binance Options

Interfaz API y Websocket de Binance Options

2022-09-08 09:41
El trading de Binance Options está disponible a través de la suite de conectividad API de Binance Futures y está abierto a usuarios que hayan habilitado la interfaz de trading API de Binance. 

1. Endpoints de datos de mercado

El enlace de Github para cada consulta proporcionará acceso a las ponderaciones, parámetros y respuestas correspondientes de los endpoints. 
Consulta
Descripción
Endpoint y detalles
Probar conectividad
Probar conectividad para la API Rest
GET /eapi/v1/ping
Revisar el horario del servidor
Probar conectividad a la API Rest y obtener el horario actual del servidor
Información del exchange
Reglas de trading e información de símbolos actuales del exchange
GET /eapi/v1/exchangeInfo 
Libro de órdenes
Obtener datos del libro de órdenes
Listado de operaciones recientes
Obtener operaciones de mercado recientes
Búsqueda de operaciones antiguas (MARKET_DATA)
Obtener operaciones de mercado históricas
Datos de línea-K/velas
Línea-K/velas para un símbolo de opción. Cada línea-K tiene su identificación única por horario de apertura
Precio de marca de Opciones
Precio de marca de Opciones e información de las griegas
Estadísticas de cambio de precio del ticker en 24 h
Estadísticas de cambio de precio del ticker en una ventana de 24 h consecutivas
Precio del símbolo de ticker
Obtener el precio del índice spot para el activo subyacente de la opción
Registros de ejercicios históricos
Obtener registros de ejercicios históricos
Interés abierto
Obtener el interés abierto de un activo subyacente en una fecha de vencimiento específica

2. Endpoints de cuentas/operaciones

El enlace de Github para cada consulta proporcionará acceso a las ponderaciones, parámetros y respuestas correspondientes de los endpoints.
Consulta
Descripción
Endpoint y detalles
Información de cuenta de opciones (TRADE)
Obtener información actual sobre la cuenta
GET /eapi/v1/account (HMAC SHA256)
Transferencia de fondos (TRADE)
Ver más detalles aquí
Nueva orden (TRADE)
Enviar una nueva orden
POST /eapi/v1/order (HMAC SHA256)
Generar múltiples órdenes (TRADE)
Enviar múltiples órdenes de opciones
Consulta de una sola orden (TRADE)
Verificar el estado de una orden
Cancelar una orden de opciones (TRADE)
Cancelar una orden activa
Cancelar varias órdenes de opciones (TRADE)
Cancelar varias órdenes activas
Cancelar todas las órdenes de opciones para un símbolo específico (TRADE)
Cancelar todas las órdenes activas para un símbolo
Cancelar todas las órdenes de opciones por subyacente (TRADE)
Cancelar todas las órdenes abiertas de un activo subyacente específico
Consulta de órdenes de opciones abiertas actualmente (USER_DATA)
Consulta de todas las órdenes actuales abiertas, estado: ACCEPTED PARTIALLY_FILLED
Consultar historial de órdenes de opciones (TRADE)
Consultar todas las órdenes terminadas en 5 días. Estado de la orden: CANCELLED, FILLED, REJECTED
Información de la posición de opciones (USER_DATA)
Obtener información sobre la posición actual
Listado de operaciones de cuenta (USER_DATA)
Obtener operaciones para una cuenta y símbolo específicos
Registro de ejercicios del usuario (USER_DATA)
Obtener registros de ejercicios de la cuenta
Flujo de financiación de la cuenta (USER_DATA)
Consultar flujos de financiación de la cuenta

3. Flujos de mercado de WebSocket

Puedes suscribirte o darte de baja para cualquier flujo mencionado a continuación utilizando las solicitudes que aparecen en la sección WebSocket
Flujo
Nombre del flujo
Descripción
Velocidad de actualización
Flujos de operaciones
<symbol>@trade o <underlyingAsset>@trade
Los flujos de operaciones brindan información sin procesar sobre un símbolo específico o un activo subyacente. Por ejemplo, ETH@trade
50ms
Flujo de índices
El flujo del índice del activo subyacente (por ejemplo, ETHUSDT)
1,000ms
Precio de marca
El precio de marca para todos los símbolos de opciones en un activo subyacente específico. Por ejemplo, ETH@markPrice
1,000ms
Flujos de línea-K/velas
El flujo de línea-K/velas brinda actualizaciones de la línea-K/vela actual (si existe) cada 1,000 milisegundos
1,000ms
Ticker en 24 horas
Información de 24 horas del ticker para todos los símbolos. Solo se enviará la información de aquellos símbolos de los que cambió la información del ticker
1,000ms
Ticker en 24 horas por activo subyacente y fecha de vencimiento
Información de ticker en 24 horas por activo subyacente y fecha de vencimiento. Por ejemplo, ETH@ticker@220930
1,000ms
Interés abierto
Interés abierto de la opción para un activo subyacente en una fecha de vencimiento específica Por ejemplo: ETH@openInterest@221125
60s
Información de nuevo símbolo
Flujo de nuevo símbolo listado
50ms  
Flujos de profundidades parciales del libro
<symbol>@depth<levels> o <symbol>@depth<levels>@100ms o <symbol>@depth<levels>@1000ms
Mejores bids y asks. Los niveles válidos son 10, 20, 50, 100
100ms, 500ms o 1,000ms, (predeterminado cuando la velocidad de actualización no es utilizada)
Flujos de diferentes profundidades del libro
Cuando el nivel de profundidad está establecido en 1,000, el flujo devuelve diferentes resultados de profundidades del libro cada 50ms. Sigue las instrucciones sobre cómo administrar correctamente un libro de órdenes local de forma correcta
50ms

4. Flujos de datos de usuario de WebSocket

Puedes acceder a flujos de datos de usuario a través de listenKey. Consulta la sección de flujos de datos de usuario de WebSocket
Evento
Tipo de evento
Descripción
Velocidad de actualización
Información de la cuenta
Actualizar bajo las siguientes condiciones:
  • Depósito o retiro de la cuenta
  • Cambio de información de una posición. Incluye un atributo P si hay cambios, de lo contrario, no incluye un atributo P.
  • Actualización de griegas
50ms
Actualización de la orden
Actualizar bajo las siguientes condiciones:
  • Orden completada
  • Orden generada
  • Orden cancelada
50ms

5. Endpoints de Market Maker

Los siguientes endpoints de API solo están disponibles para market makers.  El enlace de Github para cada consulta proporcionará acceso a las ponderaciones, parámetros y respuestas correspondientes de los endpoints.
Consulta
Descripción
Endpoint y detalles
Información de la cuenta de margen de opciones (USER_DATA)
Obtener información actual sobre la cuenta
GET /eapi/v1/marginAccount (HMAC SHA256)
Establecer configuración de Market Maker Protection (TRADE)
Establecer configuración para MMP. Market Maker Protection (MMP) es un conjunto de mecanismos de protección para los market makers de opciones. Este mecanismo puede prevenir el trading masivo en un corto período de tiempo. Una vez que la cuenta de un market maker se excede del umbral, se disparará el MMP. Todas las órdenes actuales de MMP serán canceladas, y todas las nuevas órdenes MMP serán rechazadas. Los market makers pueden usar esta brecha para reevaluar el mercado y modificar el precio de las órdenes.
Obtener configuración de Market Maker Protection (TRADE)
Obtener configuración para MMP
Restablecer configuración de Market Maker Protection (TRADE)
Restablecer MMP e iniciar las órdenes MMP nuevamente
Establecer la configuración de cancelación automática de todas las órdenes abiertas (Kill-Switch) (TRADE)
Este endpoint establece los parámetros de la función de cancelación automática. Si no se envía ningún mensaje de actividad, se cancelarán todas las órdenes abiertas (órdenes MMP y órdenes no MMP) del símbolo subyacente al final de la cuenta regresiva especificada. Luego del período de cuenta regresiva, todas las órdenes abiertas serán canceladas. Se rechazarán las nuevas órdenes con el código de error -2010 hasta que se envíe un mensaje de actividad o se desactive la función de cancelación automática estableciendo la cuenta regresiva en 0.
Obtener la configuración de cancelación automática de todas las órdenes abiertas (Kill-Switch) (TRADE)
Este endpoint devuelve los parámetros de cancelación automática para cada símbolo subyacente. Ten en cuenta que solo se devolverán los parámetros de cancelación automática que estén activos. Si el tiempo de cuenta regresiva es establecido en 0 (es decir, se ha desactivado countdownTime), la respuesta no devolverá el símbolo subyacente, y el parámetro countdownTime correspondiente no será devuelto en la respuesta.
Mensaje de actividad de cancelación automática de todas las órdenes abiertas (Kill-Switch) (TRADE)
Este endpoint restablece el tiempo desde el cual la cuenta regresiva comenzará hasta el tiempo en el que este mensaje es recibido. Debería ser llamado repetidamente como mensajes de actividad. Los múltiples mensajes de actividad pueden ser actualizados a la vez especificando los símbolos subyacentes en una lista (excepto por BTCUSDT y ETHUSDT) en el parámetro subyacente.