Errores de Bitget
Códigos de error de Bitget en LootX: firma 40009, clave y passphrase, permisos e IP, cuenta de trading unificada 40085, corredor de precio y fondos insuficientes.
Bitget informa de errores con los campos code y msg: "00000" — éxito; cualquier otro número de cinco dígitos — rechazo. El texto suele estar en inglés, pero algunos mensajes llegan en chino independientemente del idioma de la cuenta — por ejemplo, «订单不存在» («la orden no existe»). Si el terminal no reconoce el código, en el mensaje emergente después de «Order:» aparece la respuesta del exchange tal cual: Bitget POST /api/v2/…: HTTP 400 {"code":"43012","msg":"Insufficient balance",…} o más corto — Bitget error 43012: Insufficient balance.
Para algunos códigos, el terminal añade tras la respuesta del exchange una breve explicación en inglés — qué ha ocurrido y dónde corregirlo. Está en inglés a propósito: así se lee igual con cualquier idioma de la interfaz. Todas estas explicaciones están traducidas a continuación. El procedimiento general para analizar errores está en la página Mensajes de error: cómo leerlos; la configuración de claves, en Conexiones de exchanges y API keys.
Qué explica el propio terminal
| Situación | Códigos | Qué verás |
|---|---|---|
| El exchange rechazó la clave o la passphrase | 40006, 40012, 40037; al entrar en el flujo — 30011, 30012 |
Etiqueta con el nombre de la conexión: «…: el exchange rechazó la API key o el secret — revísalos en la configuración de la conexión». En Configuración → Conexiones, en la conexión aparece la sugerencia «El exchange rechazó la API key o el secret». Explicación: «Bitget did not accept the API key or its passphrase…» — la clave o la passphrase no fueron aceptadas; una clave eliminada se rechaza de la misma manera |
| Firma no verificada | 40009 |
Al conectar — la misma etiqueta; en la orden — «Orden rechazada: API key o secret incorrectos». Explicación: «Bitget could not verify the request with this secret key…» — ver Firma no verificada |
| La clave no tiene permiso | 40014 |
Texto del exchange con la explicación «the API key lacks a permission…» — activa para la clave el trading en spot o futuros |
| IP fuera de la lista de la clave | 40018 |
Texto del exchange con la explicación «this IP address is outside the IP list bound to the key…» — añade la IP a la lista de la clave o quita la restricción; a través de un proxy se considera la dirección del proxy |
| Cuenta migrada a cuenta de trading unificada | 40085 |
Texto del exchange con la explicación «the Bitget account has been switched to Unified Trading Account (UTA) mode…» — ver Cuenta migrada a UTA |
| Precio fuera del corredor del exchange | 41117, 41118 |
«Bitget: precio fuera del corredor permitido (…). El libro de órdenes podría estar desactualizado (flap WS) — actualiza los datos y vuelve a colocar el precio.» |
| Demasiadas solicitudes | HTTP 429 | «⚠ … límite de solicitudes excedido (429), restricción hasta el 30.09.2026 12:01:00 UTC». El propio terminal respeta la pausa |
| Relojes desincronizados | 40005 |
El rechazo no se considera un error de clave; la conexión no se corta. El terminal sincroniza la hora con el exchange al conectar y una vez por minuto |
| Entradas al flujo demasiado frecuentes | 30006, 30007 |
Nada: el terminal se reconecta con pausa; la clave no se marca como incorrecta |
| La orden ya no existe | 43001, 43025 |
Nada: la cancelación se considera realizada |
| Nada que cancelar | 22001 |
Nada: la cancelación masiva se considera realizada |
| Modo de posiciones en futuros | 40774 |
El terminal detecta el modo de posiciones de la cuenta al conectar y construye la orden según ese modo. Si cambiaste el modo en el sitio web mientras el terminal estaba funcionando y las órdenes se rechazan — reconecta Bitget |
| Faltaron monedas al cerrar una posición spot | 43012, 45117, 50067, 40762 |
El terminal repite la venta con un volumen reducido por el importe de la comisión. Si no funcionó — muestra el texto del exchange |
| Nada que cerrar en spot | — | «Bitget SOLUSDT: no hay nada que vender — saldo SOL = 0, la posición ya está cerrada». La orden no se envía al exchange |
| El exchange suspendió el trading por API de esta moneda | por palabras en la respuesta | «El trading por API no está disponible para esta moneda — restricción del exchange» |
Códigos frecuentes
| Código | Cómo se ve | Causa | Qué hacer |
|---|---|---|---|
40006 |
Etiqueta «el exchange rechazó la API key o el secret» | La clave es incorrecta | Copia la clave de nuevo en API Key |
40012 |
La misma etiqueta | Clave o passphrase incorrectas | Verifica la Passphrase — es la contraseña establecida al crear la clave |
40037 |
La misma etiqueta | Esa clave no existe — lo más probable es que la hayan eliminado | Crea una clave nueva en el sitio web de Bitget |
30011, 30012 |
La misma etiqueta | Al entrar en el flujo privado: clave o passphrase incorrectas | Igual que para 40006 y 40012 |
40009 |
Etiqueta o «Orden rechazada: API key o secret incorrectos» | La firma no coincide | Ver Firma no verificada |
40014 |
Texto del exchange en el mensaje de la orden con explicación sobre permisos | La clave no tiene permiso para la acción | Activa para la clave el trading en el mercado necesario en la gestión de API |
40018 |
Texto del exchange en el mensaje de la orden con explicación sobre IP | La solicitud llegó desde una IP que no está en la lista de la clave | Añade la IP (o la dirección del proxy) a la lista de la clave |
40085 |
Texto del exchange en el mensaje de la orden con explicación sobre UTA | La cuenta fue migrada a cuenta de trading unificada | Ver Cuenta migrada a UTA |
40005 |
Texto del exchange en el mensaje de la orden | El reloj del ordenador se desincronizó con el exchange, normalmente después de salir de la suspensión | Repite la orden en un minuto. Si se repite — activa la sincronización de hora en Windows |
| HTTP 429 | «límite de solicitudes excedido (429), restricción hasta …» | Límite de solicitudes excedido | Espera hasta la hora indicada, cierra las ventanas sobrantes con Bitget |
43012, 43011 |
Texto del exchange en el mensaje de la orden: «Insufficient balance» | En futuros no hay fondos suficientes para la orden | Reduce el volumen o el apalancamiento, cancela órdenes sobrantes, deposita en la cuenta de futuros |
45117, 50067, 40762 |
Texto del exchange en el mensaje de la orden | En spot no hay fondos suficientes | Verifica el saldo libre — los fondos bajo órdenes abiertas están bloqueados |
41117, 41118 |
Mensaje del terminal «precio fuera del corredor permitido» o texto del exchange «…price cannot be…» | El precio de la orden límite está demasiado lejos del mercado: 41117 — venta por debajo de lo permitido, 41118 — compra por encima |
Verifica que el libro de órdenes se actualiza y vuelve a colocar el precio más cerca del mercado |
22002 |
Texto del exchange en el mensaje de la orden: «No position to close» | La orden es «solo reducción» y la posición ya no existe — se cerró en el exchange o con un stop loss | Espera a que se actualicen las posiciones en el terminal |
43001, 43025 |
Nada | La orden que se cancela ya no existe | No hay que hacer nada |
Cómo corregir problemas frecuentes
Firma no verificada (40009)
Este rechazo tiene tres causas frecuentes:
- El secret no se copió completo. Pega de nuevo el API Secret en Configuración → Conexiones, sin espacios en los extremos.
- Clave con un par RSA creado por ti mismo. Bitget permite crear una clave de dos maneras: la del sistema (HMAC) y una RSA propia. El terminal firma las solicitudes solo con la clave del sistema: crea una clave generada por Bitget.
- Moneda con caracteres no latinos en el nombre. Si el rechazo llega solo para esa moneda y las demás funcionan, la clave es correcta y no sirve de nada volver a emitirla. El terminal ajusta por sí mismo la forma de firma para esos caracteres y repite la solicitud.
Cuenta migrada a UTA (40085)
Bitget dividió su API en dos tipos: la clásica y la de cuenta de trading unificada (UTA). LootX funciona con la clásica. En cuanto la cuenta principal se migra a UTA, el exchange responde 40085 a cada solicitud del terminal — el trading simplemente deja de funcionar, aunque la clave sea correcta.
Qué hacer ahora: opera desde una subcuenta que funcione en modo clásico. Transfiere fondos a ella, crea una API key para esa subcuenta y añade esa clave en Configuración → Conexiones.
Clave no aceptada
Verifica que la clave existe
Abre la gestión de API en el sitio web de Bitget. El código 40037 significa que la clave no existe — crea una nueva.
Verifica los tres campos
En Configuración → Conexiones pega de nuevo la API Key, el API Secret y la Passphrase. La passphrase es la contraseña que estableciste al crear la clave, no la contraseña de la cuenta.
Verifica los permisos y la IP
La clave debe tener activado el trading en los mercados marcados con los interruptores Spot y Futuros. Si la clave está vinculada a una IP, en la lista debe estar la dirección externa de tu ordenador o el proxy (sección Proxy en la tarjeta de la conexión).
Tras la corrección, el terminal se reconectará solo en el siguiente intento.
Precio fuera del corredor (41117, 41118)
Bitget no acepta órdenes límite con un precio demasiado alejado del actual: una venta claramente por debajo del mercado y una compra claramente por encima. Lo más frecuente es que el libro de órdenes del terminal se haya quedado atrás respecto al mercado, por ejemplo tras un corte de conexión. El terminal no mueve tu precio por sí mismo — eso no sería seguro. Asegúrate de que el libro de órdenes se actualiza y vuelve a colocar la orden.
Fondos insuficientes
En spot, los fondos bajo órdenes abiertas están bloqueados — cancela las órdenes sobrantes o reduce el volumen. En futuros, para la orden se necesita margen teniendo en cuenta el apalancamiento: reduce el volumen o el apalancamiento, o transfiere fondos a la cuenta de futuros.
Al cerrar una posición spot, parte de las monedas puede haberse ido en comisiones. El terminal repetirá la venta con un volumen ligeramente menor y, después, en la wallet puede quedar «polvo» por debajo del paso de volumen — no se puede vender con una orden.