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.