Skip to main content
Voltar à Documentação
🤖Construtor de Bots

Bots de Rule Builder

Monte regras de entrada SE-ENTÃO sem código: 9 condições nativas, lógica E/OU, modo só-alerta e graduação paper→live.

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:

  • TODAS (E) — todas as condições precisam ser verdadeiras. Cada condição adicionada torna a regra *mais restrita*: menos entradas, mais convicção.
  • QUALQUER (OU) — pelo menos uma condição precisa ser verdadeira. Cada condição adicionada torna a regra *mais frouxa*: mais entradas, qualidade média menor.

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

  • Máximo de 10 condições por regra, um único modo de combinação (TODAS ou QUALQUER), sem aninhamento.
  • A condição de baleia reflete as detecções recentes do feed de baleias on-chain, não uma visão garantida em tempo real de todas as carteiras.
  • Seguir IA pula mercados sem chamada da IA — por design.
  • A execução ao vivo (vs. paper) passa, adicionalmente, pelo sistema de graduação e caps da plataforma — veja Live Trading no CLOB.

Documentos relacionados