Cuando un bot no puede hacer algo, te muestra un mensaje corto — pero no siempre es obvio qué hacer al respecto. Esta es una referencia rápida: encuentra el mensaje que viste, entiende qué significa y descubre si es algo que tú corriges o algo que el exchange resuelve por sí solo. Para profundizar, cada grupo enlaza a la guía de solución de problemas dedicada.
Puntos clave
- La mayoría de los errores caen en unas pocas categorías: saldo/margen, API key, apalancamiento/modo de margen, límites de órdenes, pares deslistados, colocación de órdenes de salida y contratiempos temporales del exchange.
- Muchos mensajes provienen del lado del exchange y no son culpa tuya (modo solo-cancelación, límites de tasa, tiempos de espera agotados) — Freya reintenta estos automáticamente.
- Los que tú corriges suelen ser saldo, tamaño de orden, permisos de API o configuración de apalancamiento/margen.
- Si un mensaje dice «revisa tu posición manualmente», tu posición puede estar desprotegida — establece su toma de ganancias/stop loss en el exchange de inmediato.
- Errores persistentes o no reconocidos → contacta a [email protected] con los detalles del bot y la operación.
Saldo y Margen
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "Insufficient balance. Please check your account funds." | No hay suficientes fondos libres en el exchange para esta orden. | Agrega fondos en el exchange o reduce el monto de orden del bot. |
| "Insufficient margin. Reduce position size or add margin." | Futuros: no hay suficiente margen para la posición con este apalancamiento. | Agrega margen, reduce el tamaño de la posición o ajusta el apalancamiento. |
| "Order value too small. Please increase your bot amount." | Por debajo del tamaño mínimo de orden del par. | Aumenta el monto del bot por encima del mínimo del par. |
➡️ Profundiza: ¿Por Qué se Pausó o se Detuvo Mi Bot? y Cuánto Capital Necesita Tu Bot.
API Key y Permisos
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "API key error. Please verify your API key is valid and has trading permissions." | La key es inválida, fue revocada o carece de permiso de trading. | Vuelve a verificar o recrea la key con el trading habilitado. |
| "API key is IP-restricted. Please add the server IP to your whitelist." | La lista blanca de IP de la key no incluye la IP del servidor de Freya. | Agrega la IP que aparece en la pantalla de conexión a la lista blanca de la key. |
➡️ Profundiza: ¿No Puedes Conectar Tu Exchange? Errores de API Key.
Apalancamiento y Modo de Margen (Futuros)
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "Invalid leverage value. Please check your exchange settings." | El apalancamiento no es aceptado para este par. | Elige un apalancamiento dentro del rango permitido del par. |
| "Position value exceeds the maximum allowed for this leverage. Reduce leverage or position size." | El valor nominal es demasiado grande para el nivel de apalancamiento elegido. | Reduce el apalancamiento o el tamaño de la posición. |
| "Position mode mismatch. Check your Hedge/One-Way mode settings." | La dirección del bot entra en conflicto con el modo de posición de tu exchange. | Alinea el modo Hedge/One-Way del exchange con el bot — consulta Modo Hedge vs One-Way. |
| "Multi-asset mode conflicts with isolated margin. Switch to cross margin or disable multi-asset mode." | El margen multi-activo no se puede combinar con el margen aislado. | Cambia a margen cruzado o desactiva el modo multi-activo en el exchange. |
➡️ Relacionado: Tipo de Margen: Cruzado vs Aislado · Modo Hedge vs One-Way.
Problemas de Órdenes
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "Maximum number of open orders reached. Close some orders first." | Alcanzaste el límite de órdenes abiertas del exchange. | Cancela algunas órdenes abiertas y vuelve a intentarlo. |
| "Order price deviates too far from market price. Please try again." | Un precio límite está fuera de la banda permitida por el exchange frente al mercado. | Reintenta; para una entrada límite, establece un precio más cercano al mercado. |
| "Reduce-only order rejected. Position may already be closed." | Una orden de solo-cierre fue rechazada — normalmente no queda nada por cerrar. | Revisa la posición en el exchange; probablemente ya esté cerrada. |
| "Market is in cancel-only mode. New orders cannot be placed right now." | El exchange puso el mercado en modo solo-cancelación (mantenimiento/liquidación). | Espera — se resuelve cuando el exchange reabre. No es culpa tuya. |
| "Order not found on exchange. It may have been filled or cancelled." | La orden referenciada ya no existe. | Normalmente inofensivo — se ejecutó o fue cancelada. Revisa la operación. |
➡️ Profundiza (problemas de cierre): Mi Operación No Se Cierra.
Par de Trading (Deslistado)
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "Trading pair not found. It may have been delisted from the exchange." | El par fue eliminado o renombrado en el exchange. | Cambia el bot a un par activo y listado. |
| "Trading pair not found on the exchange. It may have been delisted." | El exchange informa que el instrumento no existe. | Elige un par actualmente listado. |
Estos son cambios del lado del exchange, no son culpa tuya — si un exchange deslista una moneda, ningún bot puede seguir operándola.
Colocación de Órdenes de Salida («Revisa Tu Posición Manualmente»)
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "Take profit/Stop loss order placement failed. Please check your position manually." | Tu entrada se ejecutó pero no se pudo colocar la protección de salida — tu posición puede estar desprotegida. | Establece tú mismo la toma de ganancias/stop loss en el exchange ahora y luego revisa el bot. |
| "TP/SL update failed after DCA fill. Please check your position manually." | Tras ejecutarse una orden de seguridad, la salida no se pudo actualizar al nuevo promedio. | Verifica que tus niveles de salida reflejen el nuevo promedio de entrada. |
| "Your exit order (TP/SL) was cancelled outside of Freya Finance. Your position is no longer protected." | Una orden de salida fue cancelada en el exchange, fuera de Freya. | Vuelve a proteger la posición (establece TP/SL) o ciérrala. |
Cualquier mensaje de «revisa tu posición manualmente» significa que una posición podría estar corriendo sin su protección de salida. Abre tu exchange, confirma la posición y establece tú mismo su stop loss / toma de ganancias hasta que el bot pueda retomar el control.
Contratiempos Temporales (Freya los Reintenta)
| Mensaje que ves | Qué significa | Qué hacer |
|---|---|---|
| "Exchange rate limit reached. Will retry automatically." | Demasiadas solicitudes; limitadas brevemente. | Nada — Freya reintenta por su cuenta. |
| "Exchange connection timed out. Please try again." | Una solicitud no se completó a tiempo. | Espera un momento; normalmente se resuelve. |
| "Network connection error. Please try again." | Una falla a nivel de red al contactar el exchange. | Reintenta en breve. |
| "Server time sync error. This usually resolves automatically." | Un desfase de reloj/marca de tiempo frente al exchange. | Normalmente se corrige solo; sin acción. |
| "Exchange server is busy. Please try again in a moment." | El exchange devolvió una respuesta de ocupado/no disponible. | Espera y reintenta. No es culpa tuya. |
¿Sigues Atascado?
Si ves "An unexpected exchange error occurred. Please check your position manually." o "Internal system error. Please try again or contact support." — verifica tu posición en el exchange y, si persiste, contacta a [email protected] con los detalles del bot y la operación. Para la liquidación en concreto, consulta Entendiendo la Liquidación.
Preguntas Frecuentes
Mi bot mostró un error — ¿es culpa de la plataforma?
Depende del mensaje. Los errores de saldo, tamaño de orden, API key y apalancamiento/margen suelen ser configuraciones que tú corriges. El modo solo-cancelación, los límites de tasa, los tiempos de espera agotados, los pares deslistados y el «servidor ocupado» provienen del lado del exchange y no son culpa tuya — Freya reintenta los temporales automáticamente.
¿Qué significa «revisa tu posición manualmente»?
Significa que tu entrada se ejecutó pero Freya no pudo colocar o actualizar la protección de salida, así que la posición podría estar corriendo sin stop loss ni toma de ganancias. Abre tu exchange, confirma la posición y establece tú mismo sus niveles de salida de inmediato — luego revisa el bot.
Recibí «saldo insuficiente» pero tengo fondos — ¿por qué?
Tus fondos podrían no estar libres (ya comprometidos en otras órdenes/posiciones), estar en la subcuenta equivocada o por debajo de lo que la orden necesita una vez incluidas las comisiones. Libera saldo o reduce el monto de orden del bot. Consulta ¿Por Qué se Pausó o se Detuvo Mi Bot?
Mi par dice que fue deslistado — ¿y ahora qué?
El exchange eliminó o renombró ese par de trading, así que ningún bot puede operarlo más. Cambia el bot a un par actualmente listado. Esto es un cambio del exchange, no un problema de Freya.
El error dice «límite de tasa / tiempo de espera / servidor ocupado» — ¿tengo que hacer algo?
No. Son condiciones temporales del lado del exchange, y Freya reintenta automáticamente. Si un bot permanece atascado mucho después de que el exchange se recupere, revisa su estado y contacta a soporte si es necesario.
¿Dónde obtengo ayuda detallada para errores de API key o de cierre?
Para errores de API key / IP / permisos, consulta ¿No Puedes Conectar Tu Exchange? Para posiciones que no se cierran u órdenes sobrantes, consulta Mi Operación No Se Cierra. Para saber por qué se detuvo un bot, consulta ¿Por Qué se Pausó o se Detuvo Mi Bot?