TARGETHIT!

Más

Comunidad

Tema

Idioma

Escuela de trading cuantitativo/Automatización/API de exchanges: cómo conectarte a los mercados
Automatización11 min de lectura

API de exchanges: cómo conectarte a los mercados

Cómo funciona la interfaz entre tu código y los exchanges

La puerta de entrada a los mercados

Las API de los exchanges son la forma en que tu código se comunica con los exchanges. Son la interfaz crítica que convierte tus decisiones de trading en posiciones reales.

REST vs. WebSocket

API REST: modelo de solicitud y respuesta. Se usan para colocar órdenes, revisar saldos y consultar posiciones. Entre sus limitaciones están los límites de solicitudes (rate limits) y la falta de actualizaciones en tiempo real.

API WebSocket: conexión persistente en la que el exchange te envía los datos. Se usan para flujos de precios, actualizaciones del libro de órdenes y notificaciones de operaciones.

La mayoría de los sistemas de trading usan ambas: WebSocket para los datos en tiempo real y REST para gestionar las órdenes.

Autenticación

Los exchanges exigen autenticación para las operaciones de trading mediante una clave API (identificador público) y una clave secreta de API (clave privada para firmar). La mayoría de los exchanges usan firmas HMAC-SHA256.

Buenas prácticas de seguridad:

  • Nunca guardes secretos en git
  • Usa variables de entorno o gestores de secretos
  • Crea claves API separadas para cada sistema
  • Activa la lista blanca de IP cuando sea posible

Límites de solicitudes

Cada exchange limita la frecuencia con la que puedes llamar a su API. Si superas los límites, recibes errores o bloqueos temporales.

Incorpora el manejo de los límites de solicitudes desde el principio: lleva el control de tu consumo, aplica esperas crecientes (backoff) al acercarte a los límites, pon las solicitudes en cola para repartirlas en el tiempo y prioriza las solicitudes de trading sobre las de datos.

Tipos de orden a fondo

Orden de mercado: ejecución inmediata al precio de mercado actual. Simple, pero sin garantía de precio.

Orden límite: ejecución solo al precio indicado o a uno mejor. Puede que nunca llegue a ejecutarse.

Orden stop loss: activa una orden de mercado cuando se alcanza el precio del stop.

Opciones de vigencia (time in force): GTC (válida hasta ser cancelada), IOC (ejecutar de inmediato o cancelar), FOK (ejecución total inmediata o cancelar), GTX (Post Only).

Manejo de errores

Las llamadas a la API fallan con frecuencia. Maneja los errores de red (tiempo de espera agotado, conexión rechazada), los errores del exchange (firma inválida, límite de solicitudes alcanzado, saldo insuficiente) y nunca des nada por sentado: verifica cada operación.

El estado más peligroso: orden enviada, sin respuesta recibida. ¿Se ejecutó o no? Tienes que verificarlo.

Diferencias entre exchanges

Cada exchange es distinto. Los nombres de los parámetros cambian, los modos de posición difieren (unidireccional frente a cobertura) y los tipos de margen también (cross frente a aislado). Por eso existen librerías como CCXT: normalizan estas diferencias.

Buenas prácticas con WebSocket

Los WebSockets se van a desconectar. Tu código debe detectar la desconexión de inmediato, intentar reconectarse con backoff, volver a suscribirse a los canales y pedir los datos perdidos si están disponibles.

Pruebas sin dinero real

Nunca pruebes primero con dinero real. Usa las testnets de los exchanges (Binance, Bybit y OKX las ofrecen), trading demo con datos reales y un modo de ensayo (dry run) que registra las órdenes en vez de enviarlas.

CCXT: el adaptador universal

CCXT ofrece una interfaz unificada para más de 100 exchanges y se encarga de la autenticación, la firma de solicitudes, el control de los límites de solicitudes y el análisis de las respuestas. Te recomendamos usar CCXT como base y agregar llamadas directas a la API para las funciones que no tienen buen soporte en la librería.

Idea clave

Las API de los exchanges son la base del trading automatizado y la fuente de la mayoría de los bugs en producción. Domina la autenticación, los límites de solicitudes, el manejo de errores y la gestión de WebSocket.