TARGETHIT!

Mais

Comunidade

Tema

Idioma

Escola de trading quantitativo/Automação/Tratamento de erros em bots de trading: quando algo dá errado
Automação10 min de leitura

Tratamento de erros em bots de trading: quando algo dá errado

Como montar sistemas que falham de forma controlada

Aceite o caos

No trading ao vivo, as coisas vão dar errado. Redes falham. Corretoras saem do ar. Seu código tem bugs. A diferença entre um sistema resiliente e um desastre está em como você trata os erros.

Categorias de erro

Erros transitórios: falhas temporárias (timeouts de rede, limites de requisições). Resposta: retry com backoff.

Erros persistentes: não se resolvem sozinhos (credenciais inválidas, saldo insuficiente). Resposta: disparar um alerta e parar.

Erros de dados: dados inesperados ou inválidos (resposta malformada, campos ausentes). Resposta: registrar no log, disparar um alerta e usar um fallback.

Erros de lógica: bugs no seu código. Resposta: alerta imediato e programação defensiva.

O padrão de retry

Use backoff exponencial com jitter aleatório. Se a corretora está sobrecarregada, todo mundo tentando de novo na mesma hora só piora a situação. Espalhar as novas tentativas no tempo ajuda na recuperação. O jitter evita tempestades de retries sincronizados.

Circuit breakers

Quando os erros se acumulam, pare de tentar. O padrão circuit breaker (um disjuntor de software, não a paralisação do pregão da B3): Fechado (normal) --> erros demais --> Aberto (falha rápida) --> timeout --> Meio-aberto (em teste) --> sucesso retorna a Fechado, falha retorna a Aberto.

Use um circuit breaker por corretora. Se a Binance está falhando, não deixe isso afetar as operações na Bybit.

Degradação controlada

Quando componentes falham, faça o sistema degradar de forma controlada em vez de cair por completo:

  • Não consegue dados em tempo real? Recorra ao polling (consultas periódicas).
  • A execução está falhando? Coloque os sinais em fila para depois.
  • O banco de dados caiu? Registre em arquivos temporariamente.

O objetivo: continuar de pé e preservar o capital até você conseguir resolver o problema.

Dead letter queues (filas de mensagens mortas)

Quando uma mensagem não pode ser processada mesmo depois dos retries, não a perca. Mova-a para uma dead letter queue para investigar depois.

Idempotência

Torne as operações seguras para retry. Se você processar o mesmo sinal duas vezes, não deve acabar abrindo duas posições. Use IDs únicos de sinal e verifique se ele já foi processado antes de executar.

Health checks

Verifique ativamente a saúde do sistema com checagens de liveness (o processo está rodando?), de readiness (ele dá conta do tráfego?) e de dependências (os bancos de dados e as corretoras estão acessíveis?).

Rode os health checks em horários programados e dispare um alerta quando eles falharem.

Estratégia de alertas

Nem todo erro merece uma ligação às 3 da manhã. Classifique:

Crítico (acionar na hora): divergência de posição, PnL fora do normal, sistema totalmente fora do ar.

Alto (alerta em minutos): falhas de execução, problemas no feed de dados, avisos de saldo.

Médio (alerta em horas): avisos de limite de requisições, erros menores, queda de desempenho.

Baixo (resumo diário): eventos informativos, avisos menores.

Boas práticas de log de erros

Inclua: timestamp, tipo de erro, stack trace completo, contexto relevante (detalhes da ordem, estado do mercado) e um ID único de requisição para correlação.

Formato: use logs estruturados (JSON) para poder consultar e analisar.

Procedimentos de recuperação

Documente como se recuperar das falhas mais comuns:

  • Chave de API da corretora expirada: gere uma nova chave, atualize a configuração e reinicie
  • Divergência de posição: rode o script de reconciliação, verifique e ajuste
  • Circuit breaker aberto: confira o status da corretora e faça o reset se o problema estiver resolvido

Ter procedimentos documentados evita erros cometidos no pânico.

Programação defensiva

Parta do princípio de que tudo o que é externo não é confiável:

  • Valide todos os dados de entrada
  • Verifique valores null/undefined
  • Use timeouts em todas as chamadas externas
  • Limite o uso de recursos (memória, conexões)

Lição principal

Erros não são exceções - são esperados. Projete seu sistema para lidar com eles de forma controlada. O objetivo não é evitar todos os erros; é conter o raio de impacto deles e se recuperar rápido.