Ambientes da Bybit e erros comuns
A maioria das falhas de conexão com a Bybit não é causada pela chave de API. A causa costuma ser uma incompatibilidade entre a chave, o ambiente selecionado e as permissões que a chave realmente tem.
O que é esta seção
Este artigo explica como a SteadyEdge usa os ambientes da Bybit e como diagnosticar os erros de validação mais comuns.
Quando usar
Consulte este artigo se:
- você estiver conectando uma conta da Bybit
- uma conta da Bybit não for aprovada na validação
- a plataforma informar um problema com as permissões ou o ambiente da Bybit
Antes de começar
Comportamento importante:
- a SteadyEdge permite conectar a Bybit em main , testnet ou demo
- o ambiente selecionado deve corresponder ao local em que a chave foi criada
- a SteadyEdge valida a chave consultando os dados da conta e as informações de API do usuário
- a validação rejeita chaves somente para leitura ou sem permissão para operar
Entre os domínios oficiais documentados atualmente pela Bybit estão:
- REST do ambiente principal: https://api.bybit.com
- REST da rede de teste: https://api-testnet.bybit.com
- REST de demonstração do ambiente principal: https://api-demo.bybit.com
Passo a passo
Passo 1: Escolha o ambiente correto
Selecione o ambiente em que a chave foi criada:
- Principal
- Rede de teste
- Demonstração
Uma chave válida usada em outro ambiente se comporta como uma conexão inválida.
Passo 2: Use uma chave de API com permissão para operar
Ao criar a chave na Bybit, conceda a ela permissões reais de negociação.
A validação da SteadyEdge rejeita chaves somente para leitura. As permissões específicas do produto também são importantes:
- as contas à vista precisam de permissão para negociar à vista
- as contas de futuros precisam de permissão para negociar contratos
Não ative saques, transferências de ativos, gerenciamento de subcontas nem outras permissões administrativas. A SteadyEdge não as utiliza.
Passo 3: Consulte o resultado da validação na SteadyEdge
A SteadyEdge valida a conta imediatamente depois que ela é salva. Consulte:
- a situação da validação
- a mensagem do erro de validação
- o horário da última validação concluída, quando disponível
Se a conta não for válida, corrija o ambiente ou as permissões antes de tentar usá-la em um robô.
Passo 4: Interprete corretamente os erros comuns da Bybit
Dois códigos da API da Bybit são especialmente importantes:
- 10003 : a chave de API e o domínio não correspondem
- 10005 : permissão negada
Se aparecer 10003 , verifique primeiro o ambiente selecionado.
Se aparecer 10005 , verifique:
- as permissões de negociação da chave
- as restrições da lista de endereços IP permitidos
- se o ambiente selecionado corresponde ao domínio da chave
Passo 5: Repita a validação depois de cada alteração na Bybit
Depois de alterar as permissões, a lista de endereços IP ou o ambiente, execute novamente a validação na SteadyEdge em vez de esperar que a conta se recupere automaticamente.
O que você deve ver
Uma conta da Bybit configurada corretamente deve mostrar:
- o ambiente correto
- uma situação válida
- nenhum erro de validação ativo
- disponibilidade na lista de contas do editor de robôs
Erros comuns
- criar uma chave de teste ou demonstração e conectá-la como Principal
- ignorar as restrições de endereços IP definidas na Bybit
- supor que um erro de permissão significa que a chave secreta está errada
- tentar corrigir o editor de robôs antes de resolver a validação da conta
- criar a chave no modo de demonstração da Bybit e depois usar um domínio que não seja de demonstração
Artigos relacionados
- Conectar uma conta de corretora
- Ambientes da Binance e erros comuns
- Campos principais do robô: corretora, símbolo, direção, alavancagem e tamanho