Bot Rule Builder

Il Rule Builder è un template di bot che ti fa scrivere la logica di ingresso con le tue mani, come regole IF-THEN esplicite — niente codice, niente scatola nera. Le condizioni le scegli tu, il bot entra solo quando sono soddisfatte, e ogni operazione ti dice esattamente quali condizioni sono scattate. Questo documento copre cosa il builder può esprimere, cosa deliberatamente non può, e come si comporta nei casi limite.

## Dove si trova

Vai su **Bot → Crea** e scegli il template **Rule Builder**. A differenza dei template pre-costruiti (ARB Hunter, Whale Copier, ecc.), che arrivano con logica fissa e qualche manopola, il Rule Builder parte vuoto: la regola di ingresso la assembli tu.

## Il modello delle regole: IF-THEN

Una regola è un insieme di **condizioni** più una **azione**. A ogni ciclo di valutazione, il bot scansiona i mercati idonei, verifica le tue condizioni su ciascuno ed esegue l'azione sui mercati che passano. Puoi combinare **fino a 10 condizioni** in una singola regola.

Le condizioni si combinano in una di due modalità:

Non esiste annidamento misto E/O dentro una singola regola. È un limite deliberato: gli alberi booleani annidati sono il punto in cui gli utenti smettono di saper prevedere il comportamento del proprio bot. Se ti serve "A E (B O C)", costruisci due regole come due bot — ciascuno resta verificabile.

## Le 9 condizioni native

1. **Edge AI ≥ X pp** — la probabilità AI di Predite meno il prezzo di mercato, in punti percentuali. 2. **Prezzo YES ≤ X¢** — ingresso solo sotto un tetto di prezzo (longshot economici, o "il mercato non si è ancora aggiornato"). 3. **Prezzo YES ≥ X¢** — ingresso solo sopra un prezzo minimo (favoriti, convergenza tardiva). 4. **Volume ≥ $X** — volume minimo del mercato, il tuo filtro di liquidità. 5. **Si risolve entro ≤ X ore** — solo mercati vicini alla risoluzione. 6. **Si risolve tra ≥ X ore** — solo mercati con tempo davanti. 7. **Whale entrata con ≥ $X** — in questo mercato è stata rilevata una posizione whale di almeno $X. Legge il vero feed whale on-chain — riflette mosse recenti effettivamente osservate on-chain, non uno specchio live di ogni wallet. 8. **Il titolo contiene il termine** — semplice match di sottostringa sul titolo del mercato. 9. **La categoria è X** — restringe a una sola categoria (Politica, Crypto, Sport, …).

## Azioni: YES, NO o Segui IA

L'azione è ciò che il bot compra quando le condizioni passano: **YES**, **NO** o **Segui IA**. Segui IA compra il lato che il motore di probabilità di Predite favorisce per quel mercato.

Qui conta un caso limite, detto onestamente: se un mercato passa le tue condizioni ma **non c'è una call AI** per quel mercato, una regola Segui IA **non entra**. Il bot non si inventa mai una direzione. Ogni tanto ti costerà un ingresso che "volevi" — ed è il trade-off giusto, perché un ingresso a testa o croce travestito da segnale AI sarebbe peggio.

## Ogni operazione si spiega da sola

Ogni operazione aperta dalla regola registra un **motivo dell'operazione** che elenca esattamente quali condizioni hanno fatto match (es. "edge 12.4pp ≥ 10pp; si risolve in 41h ≤ 72h; whale $31k ≥ $25k"). Quando riesamini il bot una settimana dopo, non devi ricostruire perché è scattato — te lo dice l'operazione stessa. È la ragione principale per preferire il Rule Builder alle strategie opache: le regole sbagliate diventano visibili, e correggibili, in fretta.

## Le uscite sono i controlli standard del bot

Il Rule Builder decide solo gli **ingressi**. Le uscite usano gli stessi controlli standard di ogni altro template: stop-loss, take-profit, trailing stop, breakeven e l'uscita pre-risoluzione (chiudere prima che il mercato si risolva invece di attraversare il settlement). La separazione è intenzionale — la logica di ingresso è specifica della strategia, ma la gestione del rischio non va reinventata regola per regola.

## Solo avvisare: valida prima di automatizzare

Ogni regola ha una casella **"Solo avvisare"**. Quando è attiva, la regola non trada affatto — quando le condizioni fanno match ricevi una notifica (campanella, Telegram e push) invece di una posizione. Gli avvisi sono deduplicati a **un avviso per mercato ogni 24 ore**, così un mercato che oscilla intorno alla tua soglia non ti riempie di notifiche.

Usala come passaggio di validazione a costo zero: fai girare la regola in modalità solo-avviso per una settimana e verifica se i mercati che segnala sono davvero quelli in cui vorresti entrare. È un feedback più rapido del paper trading e non costa niente.

## Comportamento in caso di errore

Se un set di regole è invalido o si corrompe (es. una condizione fa riferimento a un valore che non si lascia più interpretare), il bot **non apre mai posizioni** su di esso. Fallire chiuso è l'unico default accettabile per qualcosa che spende denaro: una regola rotta produce zero operazioni, non operazioni indefinite.

## Pubblicare e fare fork

I bot Rule Builder funzionano con il marketplace delle strategie come qualsiasi altro bot: puoi **pubblicare** il tuo, e gli altri possono farne un **fork**. Il fork copia la configurazione — il set di regole completo, le condizioni e l'azione — nell'account di chi lo esegue, dove può modificarla liberamente. Le tue posizioni live, i saldi e lo storico delle operazioni non vengono mai condivisi.

## Limiti da conoscere

## Documenti correlati