¿Por Qué Se Pausó o Detuvo Mi Bot?

#¿Por Qué Se Pausó o Detuvo Mi Bot?

Cuando un bot deja de hacer lo que esperas, casi siempre se trata de una de unas pocas causas que tienen solución — generalmente algo del lado del exchange, como los fondos o los permisos de la API. Esta guía repasa cada una, de la más a la menos común.

No es lo mismo que un bot que no abre operaciones. Si tu bot funciona bien pero no ha entrado en una posición, eso suele tener que ver con las condiciones de entrada — consulta ¿Por Qué Mi Bot No Opera?. Este artículo trata sobre un bot que se pausó, se detuvo o tuvo un error.

---

#Los Estados del Bot de un Vistazo

• Activo — en vivo y observando el mercado en busca de sus condiciones de entrada; aún no hay posición abierta.
• Activando — se cumplieron las condiciones de entrada; el bot está abriendo su posición.
• Ejecutando — hay una posición abierta y el bot está gestionando la operación (órdenes de seguridad, toma de ganancias, salidas).
• Pausado — lo pausaste; no abrirá nuevas posiciones hasta que lo reanudes.
• Esperando pausa — lo pausaste mientras había una posición abierta; termina de gestionar esa posición de forma segura y luego pasa a Pausado.
• Error — intentó actuar pero el exchange o una verificación lo rechazó; se detiene y señala el problema.
• Cerrando / Cerrado — el bot está finalizando la operación; una vez hecho, la operación se guarda en tu historial.

(Para la referencia completa de estados con la distinción ACTIVO-vs-EJECUTANDO, consulta ¿Por Qué Mi Bot No Opera?.)

Cuando un bot encuentra un problema del que no puede recuperarse, pasa a un estado de error y recibes una notificación de «bot fallido» (si configuraste las notificaciones) para que puedas solucionarlo rápidamente.

#La Causa Más Común: Saldo o Margen Insuficiente

Con diferencia, la razón más frecuente por la que un bot deja de colocar órdenes es saldo insuficiente (spot) o margen insuficiente (futuros) en tu cuenta del exchange. Tu bot intentó colocar una orden — una orden base, una orden de promediación o una toma de ganancias — y el exchange la rechazó porque los fondos no estaban ahí.

Solución: asegúrate de que tu cuenta del exchange tenga suficiente saldo/margen libre para cubrir todo el plan del bot — incluyendo cada orden de promediación de su grid. (Por esto es importante financiar todo el grid; consulta Órdenes de Entrada y el Grid.)

#Problemas con la API Key

Si Freya ya no puede actuar en tu nombre, el bot se detiene. Causas comunes relacionadas con la API key:

• Key inválida, revocada o regenerada — si eliminaste o rotaste la key en el exchange, la copia de Freya ya no funciona.
• Permisos incorrectos — la key necesita permisos de lectura y trading (nunca de retiro). Una key de solo lectura no puede colocar órdenes.
• Bloqueo por lista blanca de IP — si restringiste la key a IPs específicas, las IPs del servidor de Freya deben estar permitidas (se muestran cuando conectas el exchange).

Solución: reconecta con una key nueva de lectura y trading. Consulta Cómo Conectar Tu Exchange y Cómo Gestionar Tus API Keys.

#Orden Demasiado Pequeña

Cada exchange tiene un tamaño mínimo de orden (un valor nocional mínimo). Si el monto de tu orden — o una orden individual del grid — cae por debajo de ese mínimo, el exchange rechaza la orden.

Solución: aumenta tu monto de trading (o el volumen por orden) para que cada orden supere el mínimo del exchange.

#Específico de Futuros: Apalancamiento y Modo de Posición

En futuros, dos ajustes pueden bloquear las órdenes:

• Apalancamiento demasiado alto — el apalancamiento que estableciste supera lo que el exchange permite para ese par. Bájalo a un nivel permitido.
• Modo de posición incompatible — tu cuenta del exchange está en un modo de posición distinto (hedge vs un sentido) del que el bot espera. Alinea el modo de posición en el exchange con la forma en que opera el bot.

#Problemas Temporales del Exchange

Algunos errores no son culpa tuya y a menudo se resuelven solos:

• Límites de tasa — demasiadas solicitudes en una ventana corta de tiempo.
• Tiempos de espera agotados / errores de red — un problema momentáneo de conexión con el exchange.
• Errores de marca de tiempo — un problema de sincronización del reloj entre los sistemas y el exchange.
• Exchange ocupado / en mantenimiento — el propio exchange está sobrecargado o caído.

Solución: estos suelen resolverse por sí solos. Si un bot falló por alguno de estos, normalmente puedes reanudarlo una vez que el exchange vuelve a responder con normalidad.

#Qué Hacer: Una Lista de Verificación Rápida

1. Revisa el saldo/margen de tu exchange — la causa número uno. Recárgalo si está bajo.
2. Revisa tu API key — que siga válida, con permisos de lectura y trading, y las IPs de Freya permitidas.
3. Revisa el tamaño de la orden — por encima del mínimo del exchange.
4. En futuros, confirma que el apalancamiento esté dentro de los límites y que el modo de posición coincida.
5. Si fue un error temporal, espera a que el exchange se recupere y reanuda el bot.
6. ¿Sigues atascado? Contacta a [email protected].

#Preguntas Frecuentes

#¿Por qué se pausó o detuvo mi bot?

La mayoría de las veces porque el exchange rechazó una orden — generalmente por saldo o margen insuficiente, un problema con la API key, o una orden por debajo del tamaño mínimo del exchange. En futuros, los ajustes de apalancamiento o modo de posición también pueden bloquear las órdenes. Los problemas temporales del exchange (límites de tasa, tiempos de espera) también pueden detener un bot, pero esos suelen resolverse solos.

#¿Qué significa cuando mi bot está en estado de error?

Intentó actuar pero algo rechazó la acción, así que se detuvo y señaló el problema en lugar de continuar a ciegas. Recibirás una notificación de «bot fallido» (si las notificaciones están activadas). Soluciona la causa subyacente — normalmente saldo o API key — y podrás ponerlo en marcha de nuevo.

#Mi bot dice saldo insuficiente — ¿qué hago?

Añade fondos a tu cuenta del exchange para que haya suficiente saldo libre (spot) o margen (futuros) para cubrir las órdenes del bot, incluyendo su grid de órdenes de promediación. El bot no pudo colocar una orden porque los fondos no estaban disponibles en el exchange.

#¿Podría ser mi API key el problema?

Sí — es una causa común. Si la key fue eliminada, regenerada o configurada como solo lectura, o si tiene restricción de IP y las IPs del servidor de Freya no están permitidas, el bot no puede operar. Reconecta con una key nueva que tenga permisos de lectura y trading (nunca de retiro).

#Mi bot de futuros no coloca órdenes — ¿podría ser el apalancamiento o el modo de posición?

Sí. Si tu apalancamiento es mayor que el que el exchange permite para ese par, o si el modo de posición de tu cuenta (hedge vs un sentido) no coincide con la forma en que opera el bot, las órdenes se rechazan. Baja el apalancamiento a un nivel permitido y alinea el modo de posición en el exchange.

#¿Se me notificará si mi bot falla?

Sí — si configuraste las notificaciones, Freya envía una alerta de «bot fallido» cuando un bot entra en estado de error, para que puedas actuar rápidamente. Consulta Cómo Configurar las Notificaciones.

#Mi bot está ejecutándose pero no ha abierto ninguna operación — ¿es lo mismo?

No. Un bot en ejecución que no ha entrado en una posición normalmente solo es que aún no ha cumplido sus condiciones de entrada — eso se cubre en ¿Por Qué Mi Bot No Opera?. Este artículo trata sobre un bot que se pausó, se detuvo o tuvo un error.