Por Que Meu Bot Pausou ou Parou?

#Por Que Meu Bot Pausou ou Parou?

Quando um bot deixa de fazer o que você espera, quase sempre é por uma de poucas causas que têm solução — normalmente algo do lado da exchange, como fundos ou permissões de API. Este guia percorre cada uma delas, da mais comum à menos comum.

Não é a mesma coisa que um bot que não está abrindo operações. Se o seu bot está rodando bem, mas ainda não entrou em uma posição, isso geralmente tem a ver com as condições de entrada — veja Por Que Meu Bot Não Está Operando?. Este artigo é sobre um bot que pausou, parou ou entrou em erro.

---

#Os Status do Bot em Resumo

• Ativo — ao vivo e observando o mercado em busca das suas condições de entrada; nenhuma posição aberta ainda.
• Acionando — as condições de entrada foram atendidas; o bot está abrindo sua posição.
• Em Execução — uma posição está aberta e o bot está gerenciando o deal (ordens de segurança, take profit, saídas).
• Pausado — você o pausou; ele não abrirá novas posições até que você o retome.
• Aguardando Pausa — você o pausou enquanto uma posição estava aberta; ele termina de lidar com essa posição com segurança e então passa para Pausado.
• Erro — ele tentou agir, mas a exchange ou uma verificação rejeitou; ele para e sinaliza o problema.
• Fechando / Fechado — o bot está concluindo o deal; uma vez finalizado, o deal é salvo no seu histórico.

(Para a referência completa de status com a distinção entre ATIVO e EM EXECUÇÃO, veja Por Que Meu Bot Não Está Operando?.)

Quando um bot encontra um problema do qual não consegue se recuperar, ele passa para um estado de erro e você recebe uma notificação de “bot com falha” (se você configurou notificações) para que possa corrigir rapidamente.

#A Causa Mais Comum: Saldo ou Margem Insuficiente

De longe, o motivo mais frequente para um bot parar de colocar ordens é saldo insuficiente (spot) ou margem insuficiente (futuros) na sua conta da exchange. Seu bot tentou colocar uma ordem — uma ordem base, uma ordem de média ou um take profit — e a exchange recusou porque os fundos não estavam lá.

Correção: certifique-se de que sua conta da exchange tem saldo/margem livre suficiente para cobrir todo o plano do bot — incluindo cada ordem de média na sua grade. (É por isso que financiar a grade inteira importa; veja Ordens de Entrada e a Grade.)

#Problemas com a Chave API

Se a Freya não puder mais agir em seu nome, o bot para. Causas comuns ligadas à chave API:

• Chave inválida, revogada ou regenerada — se você apagou ou rotacionou a chave na exchange, a cópia da Freya deixa de funcionar.
• Permissões erradas — a chave precisa de permissões de leitura e trade (nunca de saque). Uma chave somente-leitura não consegue colocar ordens.
• Bloqueio de IP na whitelist — se você restringiu a chave a IPs específicos, os IPs dos servidores da Freya precisam estar liberados (eles são exibidos quando você conecta a exchange).

Correção: reconecte com uma chave nova de leitura-e-trade. Veja Como Conectar Sua Exchange e Gerenciando Suas Chaves API.

#Ordem Pequena Demais

Toda exchange tem um tamanho mínimo de ordem (um valor notional mínimo). Se o valor da sua ordem — ou uma ordem individual da grade — ficar abaixo dele, a exchange rejeita a ordem.

Correção: aumente seu valor de trading (ou o volume por ordem) para que cada ordem ultrapasse o mínimo da exchange.

#Específico de Futuros: Alavancagem e Modo de Posição

Em futuros, duas configurações podem bloquear ordens:

• Alavancagem alta demais — a alavancagem que você definiu excede o que a exchange permite para aquele par. Reduza para um nível permitido.
• Incompatibilidade de modo de posição — sua conta da exchange está em um modo de posição diferente (hedge vs one-way) do que o bot espera. Alinhe o modo de posição na exchange com a forma como o bot opera.

#Problemas Temporários da Exchange

Alguns erros não são culpa sua e muitas vezes se resolvem sozinhos:

• Rate limits — requisições demais em uma janela curta de tempo.
• Timeouts / erros de rede — um problema momentâneo de conexão com a exchange.
• Erros de timestamp — um problema de sincronização de relógio entre os sistemas e a exchange.
• Exchange ocupada / em manutenção — a própria exchange está sobrecarregada ou fora do ar.

Correção: estes normalmente se resolvem sozinhos. Se um bot entrou em erro por causa de um deles, você geralmente pode retomá-lo assim que a exchange voltar a responder normalmente.

#O Que Fazer: Um Checklist Rápido

1. Verifique seu saldo/margem na exchange — a causa número um. Recarregue se estiver baixo.
2. Verifique sua chave API — ainda válida, com permissões de leitura-e-trade e os IPs da Freya liberados.
3. Verifique o tamanho da ordem — acima do mínimo da exchange.
4. Em futuros, confirme se a alavancagem está dentro dos limites e se o modo de posição corresponde.
5. Se foi um erro temporário, aguarde a exchange se recuperar e retome o bot.
6. Ainda travado? Entre em contato com o [email protected].

#Perguntas Frequentes

#Por que meu bot pausou ou parou?

Na maioria das vezes porque a exchange rejeitou uma ordem — geralmente saldo ou margem insuficiente, um problema com a chave API ou uma ordem abaixo do tamanho mínimo da exchange. Em futuros, configurações de alavancagem ou modo de posição também podem bloquear ordens. Problemas temporários da exchange (rate limits, timeouts) também podem parar um bot, mas esses normalmente se resolvem sozinhos.

#O que significa quando meu bot está em estado de erro?

Ele tentou agir, mas algo rejeitou a ação, então ele parou e sinalizou o problema em vez de continuar às cegas. Você receberá uma notificação de “bot com falha” (se as notificações estiverem ativadas). Corrija a causa subjacente — normalmente saldo ou chave API — e você pode colocá-lo para rodar de novo.

#Meu bot diz saldo insuficiente — o que eu faço?

Adicione fundos à sua conta da exchange para que haja saldo livre suficiente (spot) ou margem (futuros) para cobrir as ordens do bot, incluindo sua grade de ordens de média. O bot não conseguiu colocar uma ordem porque os fundos não estavam disponíveis na exchange.

#A minha chave API pode ser o problema?

Sim — uma causa comum. Se a chave foi apagada, regenerada ou configurada como somente-leitura, ou se ela tem restrição de IP e os IPs dos servidores da Freya não estão liberados, o bot não consegue operar. Reconecte com uma chave nova que tenha permissões de leitura e trade (nunca de saque).

#Meu bot de futuros não coloca ordens — pode ser a alavancagem ou o modo de posição?

Sim. Se sua alavancagem está maior do que a exchange permite para aquele par, ou se o modo de posição da sua conta (hedge vs one-way) não corresponde à forma como o bot opera, as ordens são rejeitadas. Reduza a alavancagem para um nível permitido e alinhe o modo de posição na exchange.

#Serei notificado se meu bot falhar?

Sim — se você configurou notificações, a Freya envia um alerta de “bot com falha” quando um bot entra em estado de erro, para que você possa agir rapidamente. Veja Como Configurar Notificações.

#Meu bot está rodando, mas não abriu nenhuma operação — isso é a mesma coisa?

Não. Um bot rodando que não entrou em uma posição normalmente só ainda não atendeu às suas condições de entrada — isso é abordado em Por Que Meu Bot Não Está Operando?. Este artigo é sobre um bot que pausou, parou ou entrou em erro.