Errores de Bybit

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.

Mensajes de error

Dónde muestra el terminal los errores y cómo leerlos.

Conexión de exchanges

Cómo crear una clave y agregar una conexión en LootX.

Errores de OKX

Códigos de OKX: clave, passphrase, IP, saldo.