O problema
Quem opera em exchanges de apostas costuma trabalhar com planilhas e intuição. Não há um lugar seguro para testar uma estratégia antes de colocar dinheiro de verdade, nem um registro único de stakes, limites e resultados. Havia ainda um limite rígido: durante os testes, a Betfair Itália recusou as requisições de aposta enviadas pela sua API a partir de servidores em datacenter.
O que eu construí
Construí o BetPilot AI, uma plataforma web instalável de análise, controle de risco e simulação, em que toda estratégia começa em paper trading.
- Construtor visual de estratégias — as estratégias são salvas como um blueprint declarativo, verificado contra uma whitelist rigorosa. Nenhum código do usuário é executado, nunca.
- Assistente de estratégias com IA — o usuário descreve uma estratégia com palavras simples e o Claude (Anthropic) a transforma em blueprint, ou melhora uma já existente. Se a resposta não passa na validação, o erro volta ao modelo para uma nova tentativa.
- Motor de simulação — backtests, replays e comparações rodam como jobs em segundo plano. O motor de matching modela liquidez, correspondências parciais, slippage e latência, e é determinístico: as mesmas entradas geram o mesmo resultado.
- Motor de risco e sinais — limites de orçamento (faixa de stake, perda máxima diária e semanal, faixa de odds) e um consultor de stake: um quarto de Kelly, limitado a 5% da banca, quando há uma probabilidade informada; caso contrário, a regra dos 2%. Cada sinal mostra a odd justa e o valor esperado.
- Diário real — o usuário registra cada aposta real com um clique; banca, P&L, ROI e taxa de acerto ficam sempre atualizados.
- Dados ao vivo — estatísticas das partidas da API-Football e preços da exchange vindos de um agente somente leitura no computador do usuário.
- Segurança e registros — login com dois fatores, segredos criptografados, isolamento dos dados por usuário, log de auditoria, relatórios em PDF, CSV e XLSX, notificações por e-mail, push e webhook.
Os números
- Uma suíte de testes automatizados, incluindo um teste que prova que o motor de simulação não consegue enviar ordens reais.
- 18 módulos de back-end e 42 modelos de dados no schema do banco.
- 7 esportes e 6 métodos de dimensionamento de stake suportados pelo formato de estratégia.
Com o que foi feito
Front-end em Next.js, React e TypeScript com Tailwind CSS e Recharts, exportado como arquivos estáticos. Back-end em NestJS com Clean Architecture, módulos orientados a domínio e CQRS, sobre PostgreSQL via Prisma. Redis e BullMQ cuidam da fila de jobs, com fallback em PostgreSQL. Integrações: a API da Anthropic, a API-Football e a API somente leitura da Betfair.
Por que foi feito assim
Quando a exchange bloqueou as apostas feitas a partir do servidor, mudei o modelo. O BetPilot analisa, dimensiona a stake e mantém as contas; quem faz a aposta é a pessoa. Para os dados de mercado, escrevi um agente local que chama apenas os métodos de leitura da Betfair e mantém as credenciais no PC do usuário. Os métodos de aposta ficam bloqueados por construção, e assim o software continua sendo uma ferramenta de apoio à decisão.
