Esta guía cubre problemas de conexión API para los desafíos de Upcomers en el entorno de demo de Bybit.
Lista de verificación rápida
Usando Bybit Demo, no Live
Clave API = Read/Write, Unified, Assets
Sin restricciones de IP en la clave
Al vincular una nueva clave API, la subcuenta debe ser nueva, sin operaciones previas ni movimientos de saldo
Sin posiciones abiertas ni órdenes limit pendientes
Clave API no editada, rotada ni eliminada después del enlace
La clave es única para cada fase del desafío, no reutilizada en otro lugar
Claves copiadas con el botón Copy, no escritas manualmente
Problemas comunes y soluciones
1) Conectado al entorno equivocado
Síntoma: La cuenta no se sincroniza o muestra saldos vacíos.
Causa: API Live usada en lugar de Demo.
Solución: Crear una clave API de subcuenta Demo en Bybit y volver a conectarla en Upcomers.
2) Faltan permisos requeridos
Síntoma: Datos parciales, órdenes no registradas.
Causa: API no configurada en Read/Write, Unified, Assets.
Solución: Regenerar la API con Read/Write + Unified + Assets habilitados, luego volver a vincular.
3) Restricciones de IP habilitadas
Síntoma: Conexión denegada o tiempo de espera agotado.
Causa: API creada con whitelist de IP.
Solución: Crear la clave con No IP restrictions y conectar esa clave.
4) Claves copiadas incorrectamente
Síntoma: “Invalid key” o “Signature error.”
Causa: Escritura manual, espacios extra o caracteres faltantes.
Solución: Usar el botón Copy de Bybit para la API Key y el Secret. Reconectar.
5) API modificada o eliminada después de vincular
Síntoma: La conexión deja de funcionar repentinamente.
Causa: Edición de permisos, rotación o eliminación de la clave.
Solución: Crear una nueva clave con la configuración correcta y volver a vincularla en Upcomers.
6) Operaciones abiertas u órdenes pendientes bloquean el enlace
Síntoma: El enlace falla o muestra un error genérico.
Causa: Posiciones activas u órdenes limit en Bybit.
Solución: Cerrar todas las posiciones y cancelar todas las órdenes abiertas, luego conectar la API.
7) Clave API reutilizada en varias fases de desafío y/o cuentas diferentes
Síntoma: Conflictos entre cuentas o datos erróneos mostrados, incapacidad para vincular claves.
Causa: Misma clave vinculada a otro desafío previamente.
Solución: Generar una nueva clave API para cada fase de desafío y vincularla solo allí.