Este guia aborda problemas de conexão de API para desafios da Upcomers no ambiente de demo da Bybit.
Checklist rápido
Usando Bybit Demo, não Live
Chave API = Read/Write, Unified, Assets
Sem restrições de IP na chave
Ao vincular uma nova chave API, a subconta deve ser nova, sem negociações anteriores ou movimentos de saldo
Nenhuma posição aberta ou ordens limit pendentes
Chave API não editada, rotacionada ou excluída após o vínculo
A chave é exclusiva para cada fase do desafio, não reutilizada em outro lugar
Chaves copiadas via botão Copy, não digitadas
Problemas comuns e soluções
1) Conectado ao ambiente errado
Sintoma: Conta não sincroniza ou mostra saldos vazios.
Causa: API Live usada em vez de Demo.
Solução: Crie uma chave API de subconta Demo na Bybit e reconecte na Upcomers.
2) Permissões necessárias ausentes
Sintoma: Dados parciais, ordens não registram.
Causa: API não definida para Read/Write, Unified, Assets.
Solução: Regenerar a API com Read/Write + Unified + Assets habilitados, depois religar.
3) Restrições de IP ativadas
Sintoma: Conexão negada ou expirada.
Causa: API criada com whitelist de IP.
Solução: Criar a chave com No IP restrictions e conectar essa chave.
4) Chaves copiadas incorretamente
Sintoma: “Invalid key” ou “Signature error.”
Causa: Digitação manual, espaços extras ou caracteres faltando.
Solução: Usar o botão Copy da Bybit para a API Key e o Secret. Reconectar.
5) API modificada ou excluída após o vínculo
Sintoma: Conexão para de funcionar repentinamente.
Causa: Edição de permissões, rotação ou remoção da chave.
Solução: Criar uma nova chave com as configurações corretas e religar na Upcomers.
6) Ordens abertas ou pendentes bloqueiam o vínculo
Sintoma: O vínculo falha ou mostra erro genérico.
Causa: Posições ativas ou ordens limit no lado da Bybit.
Solução: Fechar todas as posições e cancelar todas as ordens abertas, depois conectar a API.
7) Chave API reutilizada em várias fases de desafio e/ou contas diferentes
Sintoma: Conflitos entre contas ou dados incorretos mostrados, incapacidade de vincular chaves a uma conta.
Causa: Mesma chave vinculada a outro desafio anteriormente.
Solução: Gerar uma chave API nova para cada fase do desafio e vinculá-la apenas lá.