Bitsgap API: Ejecuta tu propio algoritmo de trading en 17 exchanges

Configurar tu propia automatización de trading solía significar una semana de trabajo. Leer la documentación de la API de un exchange, implementar su esquema de firma, manejar sus particularidades y luego repetir el proceso para el siguiente exchange. Agregar un servidor, añadir lógica de reconexión y crear una forma de probar sin perder dinero.

La API de Bitsgap elimina esa semana. Un solo par de claves cubre 17 exchanges, los entornos de demostración ya están disponibles y la conexión a tu exchange es la misma que ya utilizan tus bots. Entre las cuentas que la han configurado, el tiempo medio desde la creación de una clave hasta la primera solicitud firmada exitosa es de 13 minutos. La API está incluida Free en cada plan, incluso en el plan Free.

Qué es realmente una API de trading

Una API es una lista fija de comandos que un programa puede enviar a otro. Una API de trading es esa lista para un Market: leer un Precio, consultar un Saldo, colocar una Orden, cancelar una Orden, cerrar una Posición. Tu programa envía un comando, el servidor realiza la acción y envía una respuesta. Todo lo que puedes hacer haciendo clic en Bitsgap, tu código puede hacerlo automáticamente según su propio horario.

La versión de Bitsgap está basada en una idea llamada topic: una cosa nombrada que deseas. price, balance, orders, order_place. Nombras el topic, pasas sus parámetros y recibes a cambio un solo snapshot o un flujo en tiempo real de actualizaciones.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

El resto del protocolo consiste en qué temas existen y qué parámetros acepta cada uno. No hay un endpoint separado por acción ni un segundo formato que aprender a medida que profundizas.

¿Por qué no ir directamente al exchange?

Puedes hacerlo, y para un solo exchange esa es una elección razonable. Pero hay tres cosas que cambian cuando el número supera uno.

Cada exchange tiene su propio esquema de firma, así que agregar una segunda plataforma implica una segunda implementación desde cero. Cada exchange requiere su propia clave, que debe almacenarse y rotarse por separado. Y la mayoría no ofrece un entorno realista para pruebas, por lo que el código nuevo se enfrenta a dinero real en su primer uso.

A través de Bitsgap, es un solo par de claves, un solo esquema de firma y un entorno de demostración que funciona igual que el real. Tu algoritmo también se encuentra en la misma Cuenta que tus bots GRID, DCA y COMBO, por lo que tus posiciones aparecen en un solo lugar en vez de estar divididas entre dos sistemas que muestran solo una parte de la información.

Trece minutos, paso a paso

1. Crea una Cuenta. Free plan, sin tarjeta. La API está incluida en cada plan, así que no necesitas actualizar nada aquí.

2. Genera una clave. Menú de Cuenta → API keys → Crear nueva clave. Asígnale un nombre y una fecha de vencimiento, luego haz clic en Generar. El tiempo de vida predeterminado es de tres años.

3. Guarda la clave privada. Aparece una sola vez, como un archivo PEM. Descárgala y guárdala de la misma forma en que guardarías una clave de exchange. Si se pierde, no se puede recuperar, solo reemplazar.

4. Verifica que tu firma funcione sin conexión. Los ejemplos oficiales incluyen una prueba signing_offline que no requiere clave ni conexión a la red. Ejecútala primero. La mayoría de los problemas de integración son problemas de firma, y esto los detecta antes de que surja cualquier otro inconveniente.

5. Ejecuta la guía paso a paso en modo demo. Los ejemplos están disponibles para Go, Rust, Python y TypeScript, y por defecto utilizan exchanges de demostración. Un solo comando te lleva por la conexión, datos de Market, balances, una Orden Spot, una Orden de Futuros y el historial de órdenes. En ningún momento se utiliza dinero real.

6. Apúntalo a un exchange real. Cambia un solo número — el ID de exchange em — y el mismo código se ejecuta en vivo.

Cómo configurarlo sin tener que escribir el código tú mismo

No tienes que crear la integración manualmente.

La referencia completa del protocolo es pública y legible por máquinas, y junto a ella se encuentran cuatro implementaciones de referencia completas. Dale esa documentación a cualquier asistente de codificación con IA y describe lo que quieres en lenguaje sencillo: vigila la tasa de financiamiento en tres pares y, cuando sea negativa en los tres, cierra mis posiciones largas. Recibirás un script funcional dirigido al entorno de demostración, que puedes ejecutar y ajustar antes de que interactúe con un saldo real.

Ese promedio de 13 minutos se mantiene porque las partes más complejas ya existen en cuatro idiomas, incluyendo la firma Ed25519, las cadenas de solicitud canónicas y la lógica de reconexión, lo que te deja únicamente escribir la regla de trading y nada más.

El Market sigue expandiéndose más rápido de lo que cualquier proceso manual puede seguir, por lo que el tiempo dedicado a la configuración técnica se ha convertido en la parte más costosa de la preparación.

Dos canales, una lista de temas

Ambos canales manejan los mismos temas con los mismos parámetros. REST es para un programa que se activa, hace una pregunta y vuelve a dormir. WebSocket es para uno que permanece activo y reacciona.

A través de REST, la respuesta de un comando confirma que la tarea fue aceptada, no que se completó. El resultado de la ejecución llega mediante una Suscripción WebSocket en orders, positions o balance, o consultando nuevamente esos temas. El contador de límite de velocidad se comparte entre ambos canales, por lo que cambiar de transporte no otorga presupuesto adicional.

A qué tienes acceso

Llama primero a conf_enums. Devuelve las tablas de referencia que convierten los nombres de los exchanges en los IDs numéricos em que esperan todos los demás temas: Binance es 2, Binance demo es 101. El tema manual devuelve el catálogo en tiempo real de cada tema con sus límites de tasa actuales, para que tu código pueda leer los límites en lugar de codificarlos manualmente.

Un campo que vale la pena usar desde el primer día: apiid. Es tu propia etiqueta en una Orden, de hasta 250 caracteres, y aparecerá en cada informe futuro de esa Orden. Coloca en ella el nombre y la versión de la estrategia. Cuando dos de tus programas realizan Operaciones con el mismo par, esa etiqueta es lo único que te indica cuál de ellos ejecutó cada acción.

¿Es seguro conectar la API de Bitsgap?

La conexión de Bitsgap con tu exchange no cambia. Es solo para operaciones y nunca ha tenido permisos de retiro. La API agrega una conexión separada entre tu programa y Bitsgap, firmada con un par de claves Ed25519 que tú generas y controlas. Ed25519 es un esquema de firma, no una contraseña: tú conservas la clave privada, Bitsgap almacena únicamente la clave pública, y el secreto nunca se transmite por la red. Las solicitudes no pueden repetirse, ya que cada una incluye un nonce nuevo y una marca de tiempo que expira en diez segundos. Si revocas la clave, todas las sesiones abiertas se cierran de inmediato.

Los límites, en números

Dos de estos factores influyen en cómo construyes. Los contadores de tasa se comparten entre REST y WebSocket por tema, así que un bucle de sondeo consume el presupuesto que una Suscripción en tiempo real necesita. Y si excedes la tasa de mensajes por conexión, el socket se cierra en lugar de rechazar el mensaje, por lo que la lógica de reconexión requiere retroceso, un nuevo frame de autenticación y volver a suscribirse.

Tres cosas suelen arruinar los primeros intentos, en este orden: un reloj desincronizado, un nonce reutilizado y volver a serializar el cuerpo de la solicitud después de firmarlo. El payload se firma byte por byte, así que cambiar el orden de una clave o agregar un espacio extra genera una firma diferente. Envía exactamente la misma cadena que firmaste.

Pruébalo sin gastar nada

Los exchanges de demostración funcionan igual que los reales. Órdenes, ejecuciones, posiciones, saldos, todo sin dinero real de por medio. demo_market_reset restablece la Cuenta a su estado inicial, para que puedas llevar una estrategia al límite y reiniciar con un solo comando.

La API es Free en todos los planes, incluido el plan Free de $0. No se requiere tarjeta, ni actualización, ni periodo de Prueba. Crea una Cuenta, genera una clave y comienza a firmar solicitudes hoy mismo.

Preguntas frecuentes

¿Qué es la API de Bitsgap? Es una API pública que permite que tu propio programa lea datos de Market y realice operaciones en cualquier exchange conectado a tu Cuenta de Bitsgap. Los canales REST y WebSocket comparten una lista de temas, autenticados con un par de claves Ed25519 que tú generas y controlas.

¿La API de Bitsgap es Free? Sí. Está incluida en cada plan, incluso en el plan Free, sin costo adicional.

¿Necesito saber programar? Debes ser capaz de ejecutar un script. Escribirlo es en gran medida opcional: la referencia del protocolo y cuatro implementaciones de referencia completas son públicas, por lo que un asistente de codificación con IA puede generar una integración funcional a partir de una descripción en lenguaje natural.

¿Qué lenguajes de programación son compatibles? Cualquier lenguaje que pueda realizar una solicitud HTTPS y calcular una firma Ed25519. Los ejemplos oficiales listos para ejecutar están disponibles en Go, Rust, Python y TypeScript.

¿Puede el API retirar mis fondos? No. Bitsgap se conecta a tu exchange con una clave exclusiva para operaciones, que nunca ha tenido permisos de retiro, y el API no modifica eso. Agrega un canal firmado por separado entre tu programa y Bitsgap, que puedes revocar en cualquier momento.

¿REST o WebSocket — cuál debería usar? REST para consultas puntuales y scripts programados. WebSocket para todo lo que necesite reaccionar a movimientos de precio o seguir el estado de la orden en tiempo real.

¿Puedo probar sin dinero real? Sí. Los ejemplos oficiales utilizan por defecto exchanges de demostración, y la Cuenta demo se puede restablecer a sus saldos iniciales en cualquier momento.

¿Cuánto tiempo toma la configuración? El tiempo medio desde la creación de una Clave API hasta la primera solicitud firmada exitosa es de 13 minutos, medido en cuentas de Bitsgap que han conectado una. [Agregar ventana de medición antes de publicar]