Errores de Bybit
Códigos de error de Bybit en LootX: clave y firma, permisos, fondos insuficientes, monto mínimo de orden y límites de solicitudes.
Bybit responde a cada solicitud con los campos retCode y retMsg: cero en retCode es éxito, cualquier otro número es un rechazo con una explicación en inglés. El error suele llegar con un estado HTTP normal 200, por lo que hay que mirar el código. Los códigos de trading spot de Bybit, por lo general, empiezan con 170…, los códigos de futuros y de la cuenta de trading unificada, con 110…, y los códigos de clave y firma, con 100….
Si el terminal no reconoce el código, en el mensaje emergente después de «Order:» aparecerá la respuesta de Bybit como Bybit error 170131: Insufficient balance. — primero el número, luego el texto del exchange. El procedimiento general para interpretar errores está en la página Mensajes de error: cómo leerlos, y la configuración de claves, en Conexión de exchanges y API keys.
Qué explica el propio terminal
| Situación | Códigos | Qué verá |
|---|---|---|
| El exchange rechazó la clave o la firma al conectarse | 10003, 10004, texto «API key is invalid» al entrar en el flujo privado |
Etiqueta con el nombre de la conexión: «…: el exchange rechazó la API key o el secret; revíselos en la configuración de la conexión». En Ajustes → Conexiones, la conexión muestra la sugerencia «El exchange rechazó la API key o el secret». El terminal reintenta aproximadamente cada 30 segundos |
| Firma incorrecta en la orden | 10004 |
«Orden rechazada: API key o secret incorrectos» |
| Demasiadas solicitudes | HTTP 429 y 403 | «⚠ … se superó el límite de solicitudes (403), restricción hasta el 30.09.2026 12:01:00 UTC». El terminal espera automáticamente la pausa |
| Reloj desincronizado | 10002 |
El rechazo no se considera un error de clave y la conexión no se corta. El terminal compara la hora con el exchange al conectarse y una vez por minuto; la siguiente comparación elimina la diferencia |
| La orden ya no existe | 110001, 170213 |
Nada: la cancelación se considera completada |
| No hay nada que cancelar | 10001 con texto que indica que no hay órdenes activas |
Nada: la cancelación masiva se considera completada |
| El apalancamiento ya es ese | 110043 |
Nada: el terminal considera el cambio de apalancamiento como completado |
| El monto de la orden spot es menor que el mínimo | — | El terminal aumenta el volumen hasta el monto mínimo de orden con un margen del 1 %, si conoce el mínimo para la moneda |
| Faltaron monedas al cerrar una posición spot | 170131, 110007 |
El terminal relee de inmediato la wallet y repite la venta con un volumen reducido por el monto de la comisión. Si no funciona, muestra el texto del exchange |
| No hay nada que cerrar en spot | — | «Bybit SOLUSDT: no hay nada que vender; saldo de SOL = 0, la posición ya está cerrada». La orden no se envía al exchange |
| El exchange suspendió el trading de la moneda por API | según las palabras en la respuesta | «El trading por API no está disponible para esta moneda: restricción del exchange» |
El código 10005 — sin permiso para la acción — el terminal deliberadamente no lo llama «clave rechazada»: la clave es válida, falta el permiso. Ese rechazo llega con el texto del exchange.
Códigos frecuentes
| Código | Cómo se ve | Causa | Qué hacer |
|---|---|---|---|
10003 |
Etiqueta «el exchange rechazó la API key o el secret» | La clave es incorrecta, fue eliminada o expiró | Verifique la clave en el sitio de Bybit y péguela de nuevo; consulte El exchange rechazó la clave |
10004 |
Etiqueta o «Orden rechazada: API key o secret incorrectos» | La firma no coincide: el secret no corresponde a la clave | Pegue el API Secret de nuevo |
10005 |
Texto del exchange en el mensaje de la orden: «Permission denied for current apikey» | La clave no tiene permiso para esa acción | Active los permisos necesarios de la clave; consulte La clave no tiene permisos |
10002 |
Texto del exchange en el mensaje de la orden: «…server timestamp or recv_window param» | La hora de la solicitud está fuera de la ventana permitida: el reloj de la computadora se desincronizó del exchange, generalmente después de salir del modo de suspensión | Repita la orden en un minuto. Si se repite, active la sincronización de hora en Windows |
| HTTP 403 | «se superó el límite de solicitudes (403), restricción hasta …» | Demasiadas solicitudes desde una misma IP | Espere hasta la hora indicada, reduzca el número de ventanas con Bybit |
| HTTP 429 | «se superó el límite de solicitudes (429), restricción hasta …» | Se superó el límite de solicitudes | Espere a que termine la pausa |
170131 |
Texto del exchange en el mensaje de la orden: «Insufficient balance» | En spot no hay fondos libres suficientes | Verifique el saldo disponible y cancele las órdenes innecesarias; consulte Fondos insuficientes |
110007 |
Texto del exchange en el mensaje de la orden: «ab not enough for new order» | En la cuenta de trading unificada no hay saldo disponible suficiente para la orden | Reduzca el volumen o el apalancamiento, o recargue la cuenta |
170140 |
Texto del exchange en el mensaje de la orden: «Order value exceeded lower limit» | El monto de la orden spot es menor que el mínimo | Aumente el volumen |
170032 |
Texto del exchange en el mensaje de la orden: «Network error, please try again later» | Fallo temporal del lado de Bybit, no relacionado con el saldo | Repita la orden en unos segundos |
110001 |
Nada | La orden que se cancela ya no existe: fue ejecutada o cancelada | No hay que hacer nada |
170213 |
Nada | Lo mismo para una orden spot | No hay que hacer nada |
110043 |
Nada | El apalancamiento ya está establecido en ese valor | No hay que hacer nada |
Cómo solucionar problemas frecuentes
El exchange rechazó la clave
Verifique que la clave exista y no haya expirado
Abra la administración de API en el perfil de Bybit. La clave pudo haber sido eliminada. Además, Bybit limita la vigencia de las claves sin vinculación a IP: si la clave dejó de funcionar por sí sola, revise su vigencia.
Copie la clave y el secret de nuevo
Bybit muestra el secret solo al crear la clave; si no se guardó, cree una clave nueva. En Ajustes → Conexiones, pegue los valores en API Key y API Secret sin espacios en los extremos.
Verifique la vinculación a IP
Si la clave tiene una lista de IP, debe incluir la dirección externa de su computadora. Si trabaja a través de un proxy (sección Proxy en la tarjeta de conexión), agregue la dirección del proxy.
Después de corregirlo, el terminal se reconectará solo en el siguiente intento.
La clave no tiene permisos
El código 10005 significa que la clave fue aceptada, pero no tiene permiso para la acción. Abra la clave en la administración de API del sitio de Bybit y verifique:
- la clave se creó con permiso de lectura y escritura, no solo de lectura;
- está activado el trading para los mercados donde opera: spot y/o derivados, según los interruptores Spot y Futuros de la conexión en el terminal.
Normalmente no es necesario volver a crear la clave: los permisos se cambian en la configuración de la clave existente.
Fondos insuficientes
En spot (170131), el dinero bloqueado por órdenes abiertas no está disponible para una orden nueva. Cancele las órdenes innecesarias o reduzca el volumen.
En la cuenta de trading unificada (110007), la orden requiere margen considerando el apalancamiento y las posiciones ya abiertas. Reduzca el volumen, cancele órdenes o recargue la cuenta.
Al cerrar una posición spot con una venta, el faltante suele deberse a la comisión cobrada en la moneda comprada. El terminal lo tiene en cuenta: compara el volumen con la wallet y, si es rechazado, repite la venta con un volumen ligeramente menor. Después puede quedar «polvo» en la wallet, menor que el paso de volumen, que no puede venderse con una orden.
Se superó el límite de solicitudes
Bybit responde 403 cuando hay demasiadas solicitudes desde una misma IP; el terminal también considera la respuesta 429 como superación del límite. El terminal muestra la hora hasta la que espera y, hasta entonces, no envía solicitudes a ese exchange. La hora está en UTC: en México, reste seis horas; en Bogotá o Lima, reste cinco; en Buenos Aires o Santiago, reste tres. Si las restricciones se repiten, reduzca el número de ventanas y paneles con Bybit en una misma computadora.
Cuenta en modo de cobertura
LootX trabaja con posiciones de futuros en modo unidireccional: una posición por moneda. Si en Bybit está activado el modo de cobertura para el contrato (largo y corto por separado), el exchange rechazará las órdenes del terminal y las posiciones se mostrarán incorrectamente. Cambie el modo de posición a unidireccional en la configuración de derivados del sitio de Bybit.