Bots de Rule Builder

O Rule Builder é um template de bot que permite escrever sua própria lógica de entrada como regras IF-THEN explícitas — sem código, sem caixa-preta. Você escolhe as condições, o bot só entra quando elas são atendidas, e cada trade diz exatamente quais condições dispararam. Este documento cobre o que o builder consegue expressar, o que ele deliberadamente não consegue e como ele se comporta nos casos-limite.

## Onde ele fica

Vá em **Bots → Criar** e escolha o template **Rule Builder**. Ao contrário dos templates prontos (ARB Hunter, Whale Copier etc.), que vêm com lógica fixa e alguns ajustes, o Rule Builder começa vazio: você mesmo monta a regra de entrada.

## O modelo de regra: IF-THEN

Uma regra é um conjunto de **condições** mais uma **ação**. A cada ciclo de avaliação, o bot varre os mercados elegíveis, testa suas condições contra cada um e executa a ação nos mercados aprovados. Você pode combinar **até 10 condições** em uma única regra.

As condições se combinam em um de dois modos:

Não existe aninhamento misto de E/OU dentro de uma mesma regra. É um limite deliberado: árvores booleanas aninhadas são o ponto em que os usuários deixam de conseguir prever o comportamento do próprio bot. Se você precisa de "A E (B OU C)", monte duas regras como dois bots — cada um continua auditável.

## As 9 condições nativas

1. **Edge da IA ≥ X pp** — a probabilidade da IA do Predite menos o preço do mercado, em pontos percentuais. 2. **Preço do YES ≤ X¢** — entrada só abaixo de um teto de preço (longshots baratos, ou "o mercado ainda não acordou"). 3. **Preço do YES ≥ X¢** — entrada só acima de um piso de preço (favoritos, convergência tardia). 4. **Volume ≥ $X** — volume mínimo do mercado, seu filtro de liquidez. 5. **Resolve em ≤ X horas** — só mercados perto da resolução. 6. **Resolve em ≥ X horas** — só mercados com tempo pela frente. 7. **Baleia entrou com ≥ $X** — uma posição de baleia de pelo menos $X foi detectada nesse mercado. Isso lê o feed real de baleias on-chain — reflete movimentos recentes efetivamente observados on-chain, não um espelho ao vivo de todas as carteiras. 8. **Título contém o termo** — busca simples de substring no título do mercado. 9. **Categoria é X** — restringe a uma categoria (Política, Cripto, Esportes, …).

## Ações: YES, NO ou Seguir IA

A ação é o que o bot compra quando as condições passam: **YES**, **NO** ou **Seguir IA**. Seguir IA compra o lado que o motor de probabilidade do Predite favorece para aquele mercado.

Um caso-limite honesto importa aqui: se um mercado passa nas suas condições mas **não há chamada da IA** para ele, uma regra Seguir IA **não entra**. O bot nunca inventa uma direção. Isso vai, às vezes, custar uma entrada que você "queria" — e é o trade-off correto, porque uma entrada de cara-ou-coroa fantasiada de sinal de IA seria pior.

## Cada trade se explica

Cada trade que a regra abre registra um **motivo do trade** listando exatamente quais condições bateram (ex.: "edge 12.4pp ≥ 10pp; resolve em 41h ≤ 72h; baleia $31k ≥ $25k"). Quando você revisar o bot uma semana depois, não precisa reconstruir por que ele disparou — o próprio trade conta. Essa é a principal razão para preferir o Rule Builder a estratégias opacas: regras ruins ficam visíveis, e corrigíveis, rápido.

## As saídas são os controles padrão do bot

O Rule Builder decide apenas **entradas**. As saídas usam os mesmos controles padrão de bot de qualquer outro template: stop-loss, take-profit, trailing stop, breakeven e a saída pré-resolução (fechar antes de o mercado resolver em vez de atravessar a liquidação). Essa separação é intencional — lógica de entrada é específica de cada estratégia, mas gestão de risco não deveria ser reinventada regra a regra.

## Só alertar: valide antes de automatizar

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

Use isso como um passe barato de validação: rode a regra em modo só-alertar por uma semana e verifique se os mercados que ela sinaliza são mercados em que você de fato entraria. É feedback mais rápido que paper trading e não custa nada.

## Comportamento em falha

Se um conjunto de regras é inválido ou fica corrompido (ex.: uma condição referencia um valor que não parseia mais), o bot **nunca abre posições** com ele. Falhar fechado é o único padrão aceitável para algo que gasta dinheiro: uma regra quebrada produz zero trades, não trades indefinidos.

## Publicar e forkar

Bots de Rule Builder funcionam com o marketplace de estratégias como qualquer outro bot: você pode **publicar** o seu, e outras pessoas podem **forkar**. O fork copia a configuração — o conjunto completo de regras, condições e ação — para a conta de quem forkou, onde ela pode editar tudo livremente. Suas posições ao vivo, saldos e histórico de trades nunca são compartilhados.

## Limites que vale conhecer

## Documentos relacionados