Do edge à execução
Você tem edges (vantagens estatísticas) validados. Você tem regras de position sizing (definir o tamanho da posição). Você tem orçamentos de risco. Agora vem a pergunta que todo trader sistemático acaba enfrentando: como transformar essas regras em código que executa operações enquanto você dorme?
Esta aula destrincha a arquitetura de um bot de trading - não o código específico, mas os blocos conceituais que você precisa entender antes de escrever uma única linha.
Os quatro componentes essenciais
Todo bot de trading, seja qual for a complexidade, precisa destes quatro componentes:
1. Coleta de dados - Levar os dados de mercado para dentro do seu sistema. Isso inclui os feeds de preço, os dados do livro de ofertas e quaisquer dados alternativos que os seus edges exijam.
2. Geração de sinais - A lógica que decide quando operar. É aqui que os seus edges moram, implementados como código que processa os dados que chegam e gera decisões de trading.
3. Execução de ordens - Transformar sinais em ordens reais na corretora. Isso inclui definir o tamanho da posição, escolher o tipo de ordem e tratar as respostas da corretora.
4. Gestão de estado - Acompanhar as posições, as ordens pendentes e a saúde do sistema. É a fonte da verdade sobre o que o seu bot tem e o que ele deve.
Arquitetura da coleta de dados
Os dados vêm em dois tipos: históricos e em tempo real.
Dados históricos são usados para fazer backtesting e calcular indicadores que precisam de uma janela de dados passados. Normalmente você armazena esses dados em arquivos (Parquet, CSV) ou em bancos de dados (PostgreSQL, MongoDB).
Dados em tempo real chegam continuamente durante o trading. Normalmente eles vêm por conexões WebSocket com as corretoras.
O padrão de arquitetura que recomendamos: o WebSocket da corretora alimenta uma fila de mensagens (Redis), que alimenta ao mesmo tempo um processador de dados para a geração de sinais e um armazenamento histórico para a persistência. A fila de mensagens desacopla a chegada dos dados do processamento - se o seu gerador de sinais estiver lento, as mensagens ficam em buffer em vez de se perderem.
Arquitetura da geração de sinais
É aqui que os seus edges viram código. O gerador de sinais recebe dados e gera decisões de trading.
Abordagem single-thread: processe os dados em sequência. É simples de implementar e de depurar. Funciona bem se os seus sinais não exigem velocidade extrema.
Abordagem orientada a eventos: reaja a eventos do mercado (novo candle, limiar de preço, gatilho de indicador). É mais complexa, mas lida com vários edges de forma eficiente.
Abordagem agendada: rode em intervalos fixos (a cada minuto, a cada 5 minutos). É previsível e fácil de monitorar.
Recomendamos fortemente um acoplamento fraco entre a geração de sinais e a execução. Um bug na execução não deve impedir você de gerar sinais, e vice-versa.
Arquitetura da execução de ordens
Este componente faz a interface com as corretoras. É aqui que a maioria dos bugs faz você perder dinheiro real.
As ordens passam por estados: pendente, enviada, parcial, executada, cancelada. O seu motor de execução precisa acompanhar esses estados e tratar as transições.
Crítico: nunca presuma que uma ordem funcionou só porque você não recebeu um erro. Sempre verifique as execuções de forma independente.
Arquitetura da gestão de estado
A gestão de estado é a parte sem glamour que evita desastres.
Que estado acompanhar: posições atuais, ordens abertas, saldos da conta, saúde do sistema.
Fonte da verdade: o seu estado local vai divergir do estado na corretora. Recomendamos estado local com sincronização periódica - reconciliação na inicialização, depois de erros e em um intervalo agendado.
Persistência: o seu estado precisa sobreviver a reinicializações. Use um banco de dados para o estado crítico.
Princípios-chave de arquitetura
1. Separação de responsabilidades - Cada componente faz uma coisa só.
2. Isolamento de falhas - Falhas em um componente não se propagam em cascata.
3. Observabilidade - Todo componente registra as próprias ações em log.
4. Degradação controlada - Quando algo dá errado, falhe com segurança.
5. Configuração acima do código - Parâmetros dos edges, tamanhos de posição e limites de risco devem ser configuráveis sem mudar o código.
Erros comuns de arquitetura
Erro 1: design monolítico - Tudo em um único script. Quando algo quebra, tudo quebra.
Erro 2: sem persistência - O estado vive só na memória. Uma reinicialização apaga tudo o que o bot sabia sobre as posições.
Erro 3: tudo síncrono - Esperar cada chamada à corretora bloqueia todo o resto.
Erro 4: confiar no estado local - Presumir que o seu controle de posições está sempre certo.
Erro 5: sem kill switch (botão de desligamento de emergência) - Nenhum jeito de parar de operar na hora.
Conclusão
Construir um bot de trading não se resume a programar a sua estratégia. É projetar um sistema resiliente, capaz de lidar com falhas, manter um estado preciso e executar com confiabilidade.
As decisões de arquitetura que você toma agora vão determinar quantas emergências às 3 da manhã você vai enfrentar depois.