Bots de Rule Builder
Crea reglas de entrada SI-ENTONCES sin código: 9 condiciones nativas, lógica Y/O, modo solo-alerta y graduación paper→live.
El Rule Builder es una plantilla de bot que te deja escribir tu propia lógica de entrada como reglas IF-THEN explícitas: sin código, sin caja negra. Tú eliges las condiciones, el bot solo entra cuando se cumplen, y cada operación te dice exactamente qué condiciones se dispararon. Este documento cubre lo que el builder puede expresar, lo que deliberadamente no puede, y cómo se comporta en los casos límite.
## Dónde vive
Ve a **Bots → Create** y elige la plantilla **Rule Builder**. A diferencia de las plantillas prearmadas (ARB Hunter, Whale Copier, etc.), que traen lógica fija y unas cuantas perillas, el Rule Builder empieza vacío: la regla de entrada la armas tú.
## El modelo de reglas: IF-THEN
Una regla es un conjunto de **condiciones** más una **acción**. En cada ciclo de evaluación, el bot escanea los mercados elegibles, verifica tus condiciones contra cada uno y ejecuta la acción en los mercados que pasan. Puedes combinar **hasta 10 condiciones** en una sola regla.
Las condiciones se unen mediante uno de dos modos:
- **TODAS (Y)** — todas las condiciones deben ser verdaderas. Cada condición que agregas hace la regla *más estricta*: menos entradas, mayor convicción.
- •**CUALQUIERA (O)** — al menos una condición debe ser verdadera. Cada condición que agregas hace la regla *más laxa*: más entradas, menor calidad promedio.
No hay anidamiento mixto de Y/O dentro de una misma regla. Es un límite deliberado: los árboles booleanos anidados son el punto donde los usuarios dejan de poder predecir el comportamiento de su propio bot. Si necesitas "A Y (B O C)", construye dos reglas como dos bots: cada uno sigue siendo auditable.
## Las 9 condiciones nativas
1. **Edge de IA ≥ X pp** — la probabilidad de la IA de Predite menos el precio del mercado, en puntos porcentuales. 2. **Precio de YES ≤ X¢** — entrada solo por debajo de un techo de precio (longshots baratos, o "el mercado todavía no se puso al día"). 3. **Precio de YES ≥ X¢** — entrada solo por encima de un piso de precio (favoritos, convergencia tardía). 4. **Volumen ≥ $X** — volumen mínimo del mercado, tu filtro de liquidez. 5. **Resuelve en ≤ X horas** — solo mercados cercanos a la resolución. 6. **Resuelve en ≥ X horas** — solo mercados con tiempo por delante. 7. **Ballena entró con ≥ $X** — se detectó en este mercado una posición de ballena de al menos $X. Esto lee el feed real de ballenas on-chain: refleja movimientos recientes efectivamente observados on-chain, no un espejo en vivo de cada wallet. 8. **El título contiene el término** — coincidencia simple de subcadena en el título del mercado. 9. **La categoría es X** — restringe a una sola categoría (Política, Cripto, Deportes, …).
## Acciones: YES, NO o Seguir IA
La acción es lo que el bot compra cuando las condiciones pasan: **YES**, **NO** o **Seguir IA**. Seguir IA compra el lado que el motor de probabilidades de Predite favorece para ese mercado.
Aquí importa un caso límite honesto: si un mercado pasa tus condiciones pero **no hay un call de la IA** para él, una regla de Seguir IA **no entra**. El bot jamás inventa una dirección. A veces esto te costará una entrada que "querías" — y ese es el trade-off correcto, porque una entrada de cara o cruz disfrazada de señal de IA sería peor.
## Cada operación se explica sola
Cada operación que abre la regla registra una **razón de la operación** que lista exactamente qué condiciones coincidieron (p. ej. "edge 12.4pp ≥ 10pp; resuelve en 41h ≤ 72h; ballena $31k ≥ $25k"). Cuando revisas el bot una semana después, no tienes que reconstruir por qué se disparó: la operación te lo dice. Esta es la razón principal para preferir el Rule Builder sobre estrategias opacas: las malas reglas se vuelven visibles, y corregibles, rápido.
## Las salidas son los controles estándar del bot
El Rule Builder solo decide **entradas**. Las salidas usan los mismos controles estándar de bot que cualquier otra plantilla: stop-loss, take-profit, trailing stop, breakeven y la salida pre-resolución (cerrar antes de que el mercado resuelva en lugar de atravesar el settlement). Esta separación es intencional: la lógica de entrada es específica de cada estrategia, pero la gestión de riesgo no debería reinventarse regla por regla.
## Solo alertar: valida antes de automatizar
Toda regla tiene una casilla **"Solo alertar"**. Con la casilla marcada, la regla no opera en absoluto: cuando las condiciones coinciden, recibes una notificación (campana, Telegram y push) en lugar de una posición. Las alertas se deduplican a **una alerta por mercado cada 24 horas**, así que un mercado rondando tu umbral no te va a bombardear.
Úsalo como una pasada de validación barata: corre la regla en modo solo-alertar durante una semana y revisa si los mercados que marca son los que de verdad querrías entrar. Es retroalimentación más rápida que el paper trading y no cuesta nada.
## Comportamiento ante fallos
Si un conjunto de reglas es inválido o se corrompe (p. ej. una condición referencia un valor que ya no se puede parsear), el bot **nunca abre posiciones** con él. Fallar cerrado es el único default aceptable para algo que gasta dinero: una regla rota produce cero operaciones, no operaciones indefinidas.
## Publicar y forkear
Los bots de Rule Builder funcionan con el marketplace de estrategias como cualquier otro bot: puedes **publicar** el tuyo y otros pueden **forkearlo**. Forkear copia la configuración —el conjunto completo de reglas, condiciones y acción— a la cuenta de quien lo forkea, donde puede editarla libremente. Tus posiciones en vivo, saldos e historial de operaciones nunca se comparten.
## Límites que conviene conocer
- Máximo 10 condiciones por regla, un solo modo de combinación (TODAS o CUALQUIERA), sin anidamiento.
- •La condición de ballena refleja las detecciones recientes del feed de ballenas on-chain, no una vista en tiempo real garantizada de cada wallet.
- •Seguir IA omite los mercados sin call de la IA — por diseño.
- •La ejecución en vivo (vs. paper) está además gateada por el sistema de graduación y topes de la plataforma — ver [Trading en vivo en el CLOB](/docs/live-trading).
## Documentos relacionados
- [Descripción general del Bot Builder](/docs/bot-overview)
- •[Motor de Ejecución de Bots](/docs/bot-execution)
- •[Stop-Loss y Take-Profit](/docs/stop-loss)
- •[Marketplace y biblioteca de estrategias](/docs/strategy-marketplace)