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

GET /eapi/v1/time

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

GET /eapi/v1/depth

Listado de operaciones recientes

Obtener operaciones de mercado recientes

GET /eapi/v1/trades

Búsqueda de operaciones antiguas (MARKET_DATA)

Obtener operaciones de mercado históricas

GET /eapi/v1/historicalTrades

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

GET /eapi/v1/klines

Precio de marca de Opciones

Precio de marca de Opciones e información de las griegas

GET /eapi/v1/mark

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

GET /eapi/v1/ticker

Precio del símbolo de ticker

Obtener el precio del índice spot para el activo subyacente de la opción

GET /eapi/v1/index

Registros de ejercicios históricos

Obtener registros de ejercicios históricos

GET /eapi/v1/exerciseHistory

Interés abierto

Obtener el interés abierto de un activo subyacente en una fecha de vencimiento específica

GET /eapi/v1/openInterest

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

POST /eapi/v1/batchOrders (HMAC SHA256)

Consulta de una sola orden (TRADE)

Verificar el estado de una orden

GET /eapi/v1/order (HMAC SHA256)

Cancelar una orden de opciones (TRADE)

Cancelar una orden activa

DELETE /eapi/v1/order (HMAC SHA256)

Cancelar varias órdenes de opciones (TRADE)

Cancelar varias órdenes activas

DELETE /eapi/v1/batchOrders (HMAC SHA256)

Cancelar todas las órdenes de opciones para un símbolo específico (TRADE)

Cancelar todas las órdenes activas para un símbolo

DELETE /eapi/v1/allOpenOrders (HMAC SHA256)

Cancelar todas las órdenes de opciones por subyacente (TRADE)

Cancelar todas las órdenes abiertas de un activo subyacente específico

DELETE /eapi/v1/allOpenOrdersByUnderlying (HMAC SHA256)

Consulta de órdenes de opciones abiertas actualmente (USER_DATA)

Consulta de todas las órdenes actuales abiertas, estado: ACCEPTED PARTIALLY_FILLED

GET /eapi/v1/openOrders (HMAC SHA256)

Consultar historial de órdenes de opciones (TRADE)

Consultar todas las órdenes terminadas en 5 días. Estado de la orden: CANCELLED, FILLED, REJECTED

GET /eapi/v1/historyOrders (HMAC SHA256)

Información de la posición de opciones (USER_DATA)

Obtener información sobre la posición actual

GET /eapi/v1/position (HMAC SHA256)

Listado de operaciones de cuenta (USER_DATA)

Obtener operaciones para una cuenta y símbolo específicos

GET /eapi/v1/userTrades (HMAC SHA256)

Registro de ejercicios del usuario (USER_DATA)

Obtener registros de ejercicios de la cuenta

GET /eapi/v1/exerciseRecord (HMAC SHA256)

Flujo de financiación de la cuenta (USER_DATA)

Consultar flujos de financiación de la cuenta

GET /eapi/v1/bill (HMAC SHA256)

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

<symbol>@index

El flujo del índice del activo subyacente (por ejemplo, ETHUSDT)

1,000ms

Precio de marca

<underlyingAsset>@markPrice

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

<symbol>@kline_<interval>

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

<symbol>@ticker

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

<underlyingAsset>@ticker@<expirationDate>

Información de ticker en 24 horas por activo subyacente y fecha de vencimiento. Por ejemplo, ETH@ticker@220930

1,000ms

Interés abierto

<underlyingAsset>@openInterest@<expirationDate>

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

option_pair

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

<symbol>@depth1000 

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

ACCOUNT_UPDATE

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

ORDER_TRADE_UPDATE

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.

POST /eapi/v1/mmpSet (HMAC SHA256)

Obtener configuración de Market Maker Protection (TRADE)

Obtener configuración para MMP

Get /eapi/v1/mmp (HMAC SHA256)

Restablecer configuración de Market Maker Protection (TRADE)

Restablecer MMP e iniciar las órdenes MMP nuevamente

POST /eapi/v1/mmpReset (HMAC SHA256)

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.

POST /eapi/v1/countdownCancelAll (HMAC SHA256)  

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.

GET /eapi/v1/countdownCancelAll (HMAC SHA256) 

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.

POST /eapi/v1/countdownCancelAllHeartBeat (HMAC SHA256)

Regístrate: obtén hasta 100 USDT de descuento en comisiones de trading (para usuarios verificados)