Guides Guía de Bybit

Cómo crear y configurar una clave API en Bybit

Intermedio
Guía de Bybit
2023年9月14日

Las API de trading se utilizan ampliamente por su versatilidad y flexibilidad para la personalización. La integración de una API de trading es especialmente útil para establecer una automatización que permite a los traders gestionar sus carteras, analizar las tendencias del mercado o implementar estrategias de trading sofisticadas. A medida que el mercado cripto sigue evolucionando, se están integrando más actualizaciones y características de productos para satisfacer la creciente demanda y un ejemplo de esto es la implementación de las API de Bybit. 

En esta guía, aprenderás a integrar las API de Bybit con otras aplicaciones de trading automatizado. 

Puntos clave:

  • Las API y las claves API funcionan conjuntamente, lo que permite que las aplicaciones de software interactúen entre sí.

  • Bybit ofrece muchas API, desde WebSocket API y API REST hasta API de datos históricos del mercado.

  • Los usuarios pueden beneficiarse de estas API personalizando su interfaz de usuario y sus preferencias y automatizando sus estrategias de copy trading para aumentar su velocidad y precisión de trading.

¿Qué es Bybit API?

La API de Bybit es un conjunto de interfaces de programación de aplicaciones (API) que permiten a los desarrolladores interactuar con la plataforma de Bybit mediante programación. Bybit es un excelente exchange de derivados de criptomonedas que proporciona opciones de trading para diversos recursos digitales. Con las API, los desarrolladores pueden acceder a los datos del mercado, administrar órdenes, ejecutar operaciones y suscribirse a fuentes de datos. 

Las API tienen múltiples versiones que se adaptan a diferentes productos y características. Por ejemplo, la API V3 es compatible con spot trading, USDC perpetuo y contratos de opciones, mientras que la API V2 es compatible con contratos de futuros y perpetuos inversos. Para maximizar la seguridad, las API de Bybit utilizan cifrado HMAC para la autenticación. Los desarrolladores pueden usar una gama de herramientas y lenguajes, incluidos Python, Node.js y WebSocket para integrarlos con la API de Bybit.

Qué son las API y las claves API

API se refiere a un protocolo de comunicación que utiliza un conjunto diferente de reglas y lenguajes de modo que las aplicaciones de software puedan interactuar entre sí. Por ejemplo, la API web utiliza protocolos HTTP que permiten a los desarrolladores acceder a recursos web a través de formatos de datos de uso común como JSON y XML

Las claves API, por su parte, pueden aparecer en forma de claves públicas o privadas. Funcionan como claves de autenticación o tokens de acceso que utilizan una cadena de caracteres únicos como forma de autenticación al solicitar acceso a la función API. Estas claves de autenticación las genera el proveedor de la API principalmente para rastrear el uso de la API por parte de diferentes clientes o aplicaciones. 

API de Bybit, V3 vs. V5: diferencias

La API Bybit V3 es la versión anterior de la API de Bybit. Admite contratos lineales e inversos para cuentas regulares y unificadas. Por otro lado, la API Bybit V5 es la última versión, actualizada para admitir contratos de spot, derivados y opciones para cuentas unificadas de Bybit.

Estas son algunas de las diferencias entre las API V3 y V5:

  • La API Bybit V3 solo admite productos de trading específicos, mientras que otros productos tienen su propio conjunto de API. Por el contrario, la API V5 combina las API de varios productos de trading en una sola, lo que permite a los usuarios operar con contratos spot, derivados y opciones a través de una sola API.

  • A diferencia de V3, la API Bybit V5 permite a los usuarios actualizar sus cuentas a una cuenta de trading unificada para poder compartir fondos y utilizar los distintos tipos de contratos.

  • La API V5 admite préstamos en el modo de cuenta de trading unificada, utilizando múltiples activos como garantía a fin de obtener margen para hacer trading con diferentes productos.

  • La API V5 también permite márgenes combinados entre USDT perpetuo, USDC perpetuo, futuros USDC y contratos de opciones para cuentas de trading unificadas.

La API Bybit V5 se basa en la API V3, por lo que los usuarios pueden actualizarla simplemente ajustando los campos de URL e interfaz.

Aprende más en: Documentación API de Bybit(documentos API)

Cómo crear una clave API en Bybit

Para utilizar Bybit con aplicaciones de terceros, primero debes crear una clave API en la plataforma Bybit. Pero antes de hacerlo, es esencial comprender el límite de tasas de velocidad IP.

Qué es el límite de tasas de velocidad IP

El límite de tasas de velocidad regula el tráfico de red en función de las direcciones IP de las solicitudes entrantes, e impide que los usuarios repitan acciones con demasiada frecuencia dentro de un plazo específico. Bybit tiene diferentes límites de tasas para diferentes solicitudes, como datos públicos, datos privados y realización de órdenes. 

Si superas el límite de tasas para un determinado tipo de solicitud, recibirás un código de error y tu solicitud será rechazada. Para evitarlo, debes supervisar la frecuencia de tus solicitudes y ajustarlas en consecuencia. Además, considera la posibilidad de usar WebSocket API de WebSocket en lugar de API REST para algunas solicitudes, ya que las solicitudes WebSocket no se tienen en cuenta para el límite de velocidad.

Instrucciones paso a paso para conectar tu API

Para utilizar la API de Bybit con una aplicación o plataforma, primero tendrás que crear una clave API en Bybit y luego conectarla a la plataforma deseada. Para ello, sigue estos pasos:

  1. Inicia sesión en tu cuenta de Bybit o regístrate para crear una.

  2. Haz clic en el icono de tu cuenta en la esquina superior derecha de la pantalla y selecciona API en el menú desplegable.

  3. Ve a la pestaña Gestión de API y haz clic en Crear nueva clave.

  4. Selecciona Claves API generadas por el sistema o Claves API autogeneradas.

  5. Selecciona Conectar a aplicaciones de terceros, selecciona la aplicación de terceros en el menú desplegable y el nombre de la Clave API.

  6. Establece los permisos para la clave API (p. ej., información de la cuenta, realización de órdenes, información de posición) y haz clic en Enviar.

  7. Copia la clave API y la clave secreta y guárdalas en un lugar seguro.

  8. Inicia sesión en la aplicación de terceros y vincula la API guardada. 

Cómo conectar la API 3Commas en Bybit

Si quieres usar la plataforma de trading cripto 3Commas con Bybit, primero debes conectarla con una clave API. Estos son los pasos a seguir:

  1. Inicia sesión en tu cuenta de Bybit o regístrate para crear una.

  2. Haz clic en el icono de tu cuenta en la esquina superior derecha de la pantalla y selecciona API en el menú desplegable.

  3. Ve a la pestaña Gestión de API y haz clic en Crear nueva clave.

  4. Elige Claves API generadas por el sistema.

  5. Cambia a Conectar a aplicaciones de terceros y selecciona 3Commas en el menú desplegable de nombre de la aplicación.

  6. Selecciona los permisos para la clave API: información de la cuenta, realización de órdenes, información de posición, etc. (También puedes seleccionar Solo lectura si solo deseas ver los datos de tu cuenta en 3Commas).

  7. Haz clic en Enviar para generar la clave API. Verás tu clave API y clave secreta en la pantalla. Puedes copiarlas en el portapapeles o descargarlas como un archivo.

  8. Inicia sesión en tu cuenta de 3Commas o crea una nueva.

  9. Ve a la página Mis exchanges y haz clic en Añadir exchange.

  10. Selecciona Bybit de la lista de exchanges compatibles e introduce la clave API y clave secreta que generaste en Bybit. También tendrás que introducir tu ID de cliente, que encontrarás en la página Cambiar contraseña de Bybit.

  11. Haz clic en Conectar para vincular tu cuenta de Bybit a 3Commas.

Una vez que completes estos pasos, puedes usar 3Commas con Bybit y acceder a varias herramientas y características de trading. Si necesitas actualizar o eliminar tu clave API, puedes hacerlo desde la página de gestión de API en Bybit o desde la página Mis exchanges en 3Commas.

Cómo conectar la API Insilico en Bybit

Insilico es una plataforma de trading de criptomonedas que ofrece una gama de herramientas y características, como gráficos interactivos, libros de órdenes, trades, instrumentos, actividad, órdenes, posiciones, ajustes, configuración, paneles de ejecución y paneles laterales. 

A continuación, te explicamos cómo vincular tu cuenta de Bybit a Insilico:

  1. Inicia sesión en tu cuenta Bybit y haz clic en el icono Cuenta en la esquina superior derecha de la pantalla.

  2. Haz clic en el icono de tu Cuenta en la esquina superior derecha de la pantalla y selecciona API en el menú desplegable.

  3. Ve a la pestaña Gestión de API y haz clic en Crear nueva clave.

  4. Elige Claves API generadas por el sistema.

  5. Cambia a Conectar a aplicaciones de terceros y selecciona Terminal Insilico en el menú desplegable. Esto garantiza que la clave quede bloqueada en el rango de IP del servidor de Insilico.

  6. Selecciona los permisos para la clave API: información de la cuenta, realización de órdenes e información de posiciones. También puedes seleccionar Solo lectura para ver los datos de la cuenta solo en Insilico.

  7. Haz clic en Enviar para generar la clave API. Verás tanto tu clave API como la clave secreta en la pantalla. Si lo deseas, también puedes copiarlos o descargarlos como archivo.

  8. Inicia sesión en tu cuenta de Insilico (o crea una nueva).

  9. Ve a la página Ajustes y haz clic en Añadir exchange.

  10. Selecciona Bybit de la lista de exchanges compatibles e introduce la clave API y clave secreta que generaste en Bybit. También tendrás que introducir tu ID de cliente, que encontrarás en la página Cambiar contraseña de Bybit.

  11. Haz clic en Conectar para vincular tu cuenta de Bybit a Insilico.

¿Puedo utilizar el entorno de pruebas Bybit para pruebas de API?

Sí. Puedes utilizar el entorno de pruebas Bybit para pruebas de API siempre que lo desees, pero los datos y las transacciones no son reales y pueden no reflejar las condiciones reales del mercado. El entorno de pruebas Bybit, también conocido como testnet, es una plataforma de trading virtual que te permite probar tus estrategias y códigos de API sin poner en riesgo fondos reales. Proporciona acceso a los servicios API de Bybit, como API REST, WebSocket API y datos históricos del mercado.

Tipos de API de Bybit

Bybit API tiene tres tipos de interfaces. 

API REST

API REST es una interfaz que te permite enviar solicitudes y recibir respuestas mediante métodos HTTP, como GET, POST, PUT y DELETE. Puedes utilizar API REST para realizar varias acciones en la plataforma Bybit: Consultar datos del mercado, realizar órdenes, modificar órdenes y comprobar posiciones. API REST es ideal para solicitudes de baja frecuencia y alta latencia.

WebSocket API

Esta interfaz te permite establecer una conexión persistente con el servidor de Bybit y recibir actualizaciones en tiempo real mediante el protocolo WebSocket. Puedes utilizar WebSocket API, equipada con los datos de WebSocket, para suscribirte a diversos mercados y temas de datos privados, como el libro de órdenes, K-line, trades, tasa de financiamiento, estado de la orden y estado de la posición. WebSocket API es más adecuada para solicitudes de alta frecuencia y baja latencia.

ExploraSuscribirse a WebSocket API.

Datos históricos del mercado

Puedes descargar datos históricos del mercado público en formato CSV y utilizarlos para probar tus estrategias y analizar las tendencias del mercado. Los datos históricos del mercado incluyen instantáneas de libros de órdenes, datos de K-line, datos de operaciones y datos de tasas de financiamiento.

Aprende más: Descarga la API de datos del mercado de Bybit aquí.

¿Cómo puedes beneficiarte de la API de Bybit?

Bybit API es una potente herramienta que puede ayudar a mejorar tu experiencia y rendimiento con el trading. Estas son algunas de las formas en las que puedes beneficiarte:

  • Automatiza tus estrategias de trading con velocidad y precisión. La API de Bybit te permite crear y ejecutar bots de trading que pueden realizar, modificar y cancelar órdenes y administrar posiciones según tu lógica y parámetros predefinidos. La API también te permite la integración con herramientas y funciones de trading de terceros.

  • Accede a datos históricos del mercado y a datos en tiempo real. Suscríbete a varios temas de datos del mercado y recibe actualizaciones en tiempo real con WebSocket API. También puedes descargar datos históricos del mercado público en formato CSV para analizar tendencias del mercado, identificar oportunidades de trading y probar estrategias.

  • Personaliza tu interfaz de usuario y preferencias. Crea tu propia interfaz de usuario y panel para mostrar información y funciones adaptadas a tus necesidades. Puedes adaptar tus ajustes y configuraciones, como el modo de margen, el nivel de apalancamiento y el límite de riesgo.

¿La API de Bybit es gratis?

La API de Bybit es gratuita para los usuarios de Bybit, sin cargos ni tarifas adicionales. Sin embargo, las tarifas de trading y financiación habituales siguen aplicándose a tus transacciones en la plataforma.

En resumen

La API de Bybit proporciona a los desarrolladores herramientas e interfaces útiles para que puedan interactuar con la plataforma Bybit a través de código. Estas herramientas te permiten automatizar las estrategias de trading, acceder a datos del mercado en tiempo real y personalizar tu interfaz de usuario. 

Sigue los pasos anteriores para configurar una clave API en Bybit y conéctala a aplicaciones de terceros como 3Commas o Insilico. Es importante tener en cuenta las diferencias entre las versiones de V3 y V5 de la API de Bybit y asegurarte de mantenerte dentro de los límites de velocidad de IP para garantizar una experiencia de trading fluida.