Rule Builder: de Regras IF-THEN à Automação Segura

A maior parte da automação de trading falha de um de dois jeitos: a lógica é uma caixa-preta que você não consegue auditar, ou as proteções são um detalhe de última hora que você descobre no meio de um drawdown. O Rule Builder do Predite é a nossa tentativa de consertar os dois de uma vez — lógica de entrada que você mesmo escreve como regras IF-THEN simples, embrulhada em um sistema de execução onde cada dólar de dinheiro real precisa ser conquistado antes no paper trading. Este guia percorre o caminho inteiro: montar uma regra, validá-la com alertas, compor as saídas e graduá-la da simulação para o CLOB de verdade.

O que é o Rule Builder

Abra Bots → Criar e escolha o template Rule Builder. Enquanto os outros templates (ARB Hunter, Whale Copier, Mean Reversion…) vêm com lógica fixa e alguns ajustes, o Rule Builder te entrega uma regra vazia: um conjunto de condições, um modo de combinação e uma ação. A cada ciclo de avaliação, o bot varre os mercados elegíveis, testa suas condições contra cada um e age nos mercados que passam.

O objetivo do design é auditabilidade. Você deve conseguir olhar para qualquer trade que o seu bot fez — mesmo semanas depois — e ver exatamente por que ele aconteceu. Por isso cada entrada registra um motivo do trade listando as condições específicas que bateram, com os valores reais ("edge 12.4pp ≥ 10pp; resolve em 41h ≤ 72h; baleia $31k ≥ $25k"). Se uma regra está se comportando mal, os próprios trades são o log de debug.

As nove condições

Uma regra combina até 10 condições, tiradas de nove tipos nativos:

TODAS vs QUALQUER: acerte isso primeiro

As condições se combinam em um de dois modos, e a diferença é a fonte mais comum de usuários surpresos:

TODAS (E) significa que todas as condições precisam valer. Cada condição adicionada torna a regra mais restrita — menos entradas, com mais convicção. QUALQUER (OU) significa que uma condição basta. Cada condição adicionada torna a regra mais frouxa — mais entradas, qualidade média menor. Uma regra QUALQUER com 5 condições não é uma regra "sofisticada"; são cinco gatilhos sensíveis dividindo o mesmo bot.

Não há aninhamento misto ("A E (B OU C)") dentro de uma regra, de propósito: lógica booleana aninhada é onde as pessoas perdem a capacidade de prever o próprio bot. Se você precisa de lógica composta, divida em dois bots — cada um continua legível, e a atribuição continua limpa.

Um exemplo completo: o sniper de convergência tardia

Aqui vai uma regra real que você monta em dois minutos. A tese: nos dias finais antes da resolução, mercados com um edge persistente da IA e interesse fresco de baleias tendem a convergir para a probabilidade da IA — e a janela curta de tempo limita quanto tempo o seu capital fica preso.

Defina o modo de combinação como TODAS e adicione:

1. Edge da IA ≥ 10 pp — só nos interessa uma discordância significativa entre o modelo e o mercado.
2. Resolve em ≤ 72 horas — a janela de convergência. Limitar o tempo do trade também limita o tempo do risco.
3. Baleia entrou com ≥ $25,000 — alguém com tamanho (e possivelmente informação melhor) já se comprometeu com esse mercado on-chain.

Ação: Seguir IA — compra o lado que a IA favorece.

Leia o que essa regra realmente diz: "quando o modelo e pelo menos uma baleia discordam da multidão, e saberemos a resposta em até três dias, fique do lado do modelo". Cada condição merece o lugar que ocupa. Filtros de volume e categoria são adições razoáveis, mas comece minimalista — dá para apertar uma regra que dispara demais; você não aprende nada com uma regra que nunca dispara.

Um comportamento para conhecer: Seguir IA nunca inventa uma direção. Se um mercado passa nas suas condições mas não tem chamada da IA, a regra simplesmente não entra. De vez em quando você vai "perder" uma entrada por causa disso. É o comportamento correto — uma entrada sem sinal é um cara-ou-coroa com etapas extras.

Valide com Só alertar antes de operar

Toda regra tem uma caixa "Só alertar". Marcada, a regra nunca opera — em vez disso, quando as condições batem, você recebe notificação no sino, no Telegram e por push. Os alertas são deduplicados para um por mercado a cada 24 horas, então um mercado oscilando em volta do seu limiar não te enche de avisos.

Este é o loop de validação mais barato da plataforma, e você deveria usá-lo antes de qualquer regra nova chegar perto da execução. Rode a regra do sniper em só-alertar por uma semana. Cada alerta é uma pergunta: "eu faria esse trade manualmente?". Se a resposta continua sendo não, suas condições estão erradas — conserte agora, enquanto o custo de estar errado é uma notificação, e não uma posição. O só-alertar também funciona como modo permanente: alguns usuários rodam regras puramente como scanners personalizados e nunca as automatizam.

Saídas: onde mora a gestão de risco de verdade

O Rule Builder decide apenas as entradas. As saídas vêm dos controles padrão de proteção do bot, e elas se compõem — você pode armar várias ao mesmo tempo:

A saída pré-resolução merece atenção especial em mercados de previsão, por causa do gap de liquidação 0/1. Uma ação que vai contra você cai 5%; uma share de mercado de previsão que resolve contra você vai a zero. Não existe crédito parcial na liquidação — YES paga $1.00 ou $0.00. Um stop-loss não consegue te proteger através da resolução, porque resolução não é um movimento de preço do qual você pode sair; é uma descontinuidade. Se a sua estratégia não tem opinião sobre o resultado final — como o sniper de convergência, que aposta na *deriva*, não na resposta — arme a saída pré-resolução e esteja fora antes de a moeda cair.

As proteções são gerenciadas como um grupo OCO (one-cancels-other) estrito: quando uma dispara, as irmãs são canceladas, e fechar uma posição manualmente cancela as proteções pendentes dela. Você nunca vai levar uma saída dupla por dois gatilhos correndo entre si.

Paper primeiro: os portões de graduação

Bots novos de Rule Builder operam com dinheiro de paper, e isso não é uma sugestão — é um portão. A execução ao vivo para automação é controlada por flag e paper-first: um bot precisa completar pelo menos 10 trades em paper antes de ficar elegível para graduar para dinheiro real. A página Trading Real mostra um checklist de graduação de 5 passos, então você sempre sabe onde uma estratégia está no caminho da simulação até o CLOB.

Dez trades não provam significância estatística — nenhuma plataforma honesta alegaria isso. O que eles provam é correção *mecânica*: a regra dispara nos mercados que você pretendia, os motivos dos trades batem com a sua tese, as saídas disparam do jeito que você configurou. Confiança estatística leva mais tempo; mantenha o bot no paper pelo tempo que precisar. O portão é um piso, não uma meta.

Indo ao vivo: caps, exposição e o kill switch

Quando uma regra entra com dinheiro real, ela não ganha um cheque em branco. Toda entrada automatizada ao vivo passa pelo mesmo caminho de execução guardado que todo o resto no Predite:

Esses limites vão, de vez em quando, parar um trade que você queria. É esse o acordo: o mesmo teto que limita o entusiasmo de uma regra boa limita o estrago de uma regra quebrada, e às 3 da manhã, com um conjunto de regras corrompido, é o teto que você quer. Aliás — um conjunto de regras inválido ou corrompido nunca abre posição nenhuma. O Rule Builder falha fechado.

Publicar e forkar

Quando uma regra tiver um histórico do qual você se orgulha, você pode publicá-la no marketplace de estratégias, e outros usuários podem forkar. O fork copia a configuração — condições, modo de combinação, ação, ajustes de saída — para a conta de quem forkou. Seu capital, suas posições e seu histórico continuam privados. Bots forkados começam do início do caminho de graduação como qualquer bot novo: seus 10 trades em paper não se transferem, porque o dono do fork ainda não verificou nada.

O loop, de ponta a ponta

Monte a regra em Bots → Criar → Rule Builder → rode em modo só-alertar por uma semana e confira com calma o que ela sinaliza → passe para paper e deixe-a operar dinheiro simulado → leia os motivos dos trades e ajuste as condições → complete o checklist de graduação → vá ao vivo dentro dos caps de automação, com a saída pré-resolução armada se a sua tese termina antes do mercado. Em cada etapa, o sistema te diz exatamente o que fez e por quê — que é justamente o sentido de escrever as próprias regras em vez de confiar na caixa-preta de outra pessoa.