MangoLabsDOCS
Lancia

Capire i Nodi

I nodi sono i mattoni che trascinerai sulla canvas per creare strategie di trading. Ogni nodo ha un lavoro specifico — alcuni recuperano dati, altri prendono decisioni, alcuni eseguono calcoli e alcuni eseguono trade. Esploriamo cosa fa ciascuno e quando usarlo.

8 min di letturaPrincipianteGiugno 2026

Cosa imparerai

  • ▸Il ruolo di ogni nodo strategia: Fonte Dati, Condizione, Logica, Math, Super-Nodo, Azione, Commento, Imposta Variabile, e il pannello Parametri (θ) per le costanti con nome
  • ▸Come configurare nodi con input e output appropriati
  • ▸Quando usare i Super-Nodi per calcoli riutilizzabili e logica condivisa
  • ▸Nodi Input e Output — i due tipi di nodo che esistono solo dentro i template Super-Nodo
  • ▸Best practice per organizzare nodi ed evitare errori comuni

Pensa ai Nodi Come Mattoncini LEGO

Ogni nodo è un pezzo che puoi connettere agli altri. Un nodo Fonte Dati fornisce informazioni (come "qual è l'RSI attuale?"), un nodo Condizione prende una decisione ("l'RSI è sotto 30?"), e un nodo Azione esegue il trade ("compra ora!"). Uniscili per costruire la tua strategia.

Nodi per Costruire Strategie#

Questi sono gli otto tipi di nodo che userai sulla canvas della tua strategia principale, insieme al pannello Parametri (θ) per dichiarare costanti numeriche con nome. Insieme ti permettono di accedere ai dati di mercato, confrontare valori, combinare condizioni, eseguire calcoli, persistere stato, pacchettizzare logica riutilizzabile ed eseguire trade.

Fonte Dati

Il punto di partenza di ogni strategia — fornisce dati di mercato live e indicatori

Cosa Fa:

Fornisce accesso ai dati di mercato OHLCV (open, high, low, close, volume), indicatori tecnici e stato portfolio. Una strategia ha bisogno di almeno un nodo Fonte Dati — è il punto di ingresso che alimenta il resto del grafo.

COME USARLO
  1. 1. Trascinalo sulla canvas dalla palette
  2. 2. Apri il pannello proprietà e scegli un simbolo (default BTCUSDT) e un timeframe (default 1m)
  3. 3. Nel campo Colonne, elenca i dati di cui hai bisogno: OHLCV base (open, high, low, close, volume), nomi feature (rsi:p=14, ema:p=20, ...), e campi portfolio (entry_price, side, size, cash)
  4. 4. Connetti l'output ad altri nodi che necessitano dati di mercato
DATI DISPONIBILI
  • • Base OHLCV: open, high, low, close, volume, timestamp
  • • Indicatori Tecnici: Referenziati tramite nome canonico — esempi: sma:p=20, ema:p=50, rsi:p=14, atr:p=14, vwap:p=20. Gli indicatori multi-output usano un suffisso #sub: bollinger:p=20,std=2#bb_upper, macd:fast=12,sig=9,slow=26#macd_signal.
  • • Stato Portfolio: entry_price, side (LONG, SHORT o null), size, cash, entry_timestamp

Esempio:

Per una strategia RSI ipervenduto, aggiungi un nodo Fonte Dati e inserisci le colonne close (prezzo attuale) e rsi:p=14 (RSI a 14 periodi). Questi valori fluiscono al resto della tua strategia per prendere decisioni.

Condizione

Confronta due valori e restituisce vero o falso

Cosa Fa:

Confronta due input usando un operatore scelto e restituisce un risultato booleano. Questo è il nodo primario per la logica decisionale di entrata e uscita.

COME USARLO
  1. 1. Trascinalo sulla canvas dalla palette
  2. 2. Connetti una Fonte Dati (o un altro output numerico) all'input sinistro — Input A
  3. 3. Nel pannello, scegli la colonna da confrontare (ad esempio rsi:p=14)
  4. 4. Scegli un operatore: >, <, >=, <=, ==, !=
  5. 5. Connetti un secondo input numerico all'Input B, oppure digita un valore fisso nel pannello (ad esempio 30 per un controllo ipervenduto)
  6. 6. Connetti l'output booleano a un nodo Logica o Azione
CONFRONTI COMUNI
  • • rsi:p=14 < 30 → condizione ipervenduto
  • • rsi:p=14 > 70 → condizione ipercomprato
  • • close > sma:p=200 → prezzo sopra la media di lungo termine
  • • Crossover MACD (rialzista): usa due nodi Condizione — (macd > macd_signal) AND (macd:lag=1 <= macd_signal:lag=1) — combinati con un nodo Logica AND. La colonna lag=1 legge il valore della candela precedente, quindi l'AND scatta solo sulla candela del crossover.

Esempio:

Per rilevare condizioni Bitcoin ipervenduto: connetti Fonte Dati a un nodo Condizione, scegli rsi:p=14 come Input A, seleziona l'operatore <, e digita 30 come valore. Il nodo restituisce true quando l'RSI scende sotto 30.

Math

Esegue calcoli aritmetici su due input numerici (+, −, ×, ÷)

Cosa Fa:

Prende due input numerici e restituisce il risultato di un'operazione aritmetica scelta: addizione, sottrazione, moltiplicazione o divisione. I nodi Math sono disponibili sia sulla canvas della strategia sia dentro i template Super-Nodo — ovunque serva un calcolo rapido tra due numeri.

COME USARLO
  1. 1. Trascinalo sulla canvas dalla palette
  2. 2. Connetti un output numerico (una colonna da una Fonte Dati, un parametro, o un altro nodo Math) all'Input A
  3. 3. Connetti un secondo input numerico all'Input B
  4. 4. Nel pannello, scegli l'operatore: + (somma), − (sottrazione), × (moltiplicazione), o ÷ (divisione). Per la divisione puoi anche impostare un valore di fallback da usare quando l'Input B è zero
  5. 5. Connetti il risultato a qualsiasi nodo che lo consuma

Esempio:

Per calcolare la percentuale di profitto su una posizione long: usa un nodo Math per sottrarre entry_price da close, un secondo nodo Math per dividere quel risultato per entry_price, e un terzo per moltiplicare per 100. L'output è la percentuale di profitto che puoi confrontare con un target.

Parametri (θ)

Costanti numeriche con nome per la tua strategia

Cosa Fa:

Le costanti vengono dichiarate una sola volta nel pannello Parametri (θ) a livello superiore della strategia, non come nodo separato sulla canvas. Ogni parametro ha un nome e un valore numerico. Gli input dei nodi che richiedono un numero fisso — dimensioni ordine, soglie, moltiplicatori — vengono collegati a un parametro per nome. Questo rende ogni costante visibile e modificabile in un unico posto, e mantiene la canvas libera da nodi costante sparsi.

COME USARLO
  1. 1. Apri il pannello Parametri (θ) dalla toolbar della strategia
  2. 2. Clicca "Aggiungi parametro", dagli un nome (ad esempio position_size o rsi_threshold), e imposta il suo valore
  3. 3. Su qualsiasi input di nodo che accetta un numero, clicca il binding picker e scegli il parametro per nome

Esempio:

Per un'entrata RSI ipervenduto con una dimensione trade fissa, aggiungi un parametro chiamato position_size con valore 0.001. Nell'input size del nodo Azione, collegalo a position_size. La strategia esegue con 0.001 BTC per trade, e puoi cambiare la dimensione in un unico posto senza toccare il cablaggio della canvas.

Logica (AND/OR)

Combina più condizioni in una decisione

Cosa Fa:

Combina due o più input booleani usando logica AND o OR. Usa AND quando ogni condizione deve essere vera, usa OR quando basta che una singola condizione sia vera.

Logica AND: Restituisce true solo se ogni input è true
Logica OR: Restituisce true se qualsiasi input è true
COME USARLO
  1. 1. Trascinalo sulla canvas dalla palette
  2. 2. Nel pannello, scegli il tipo di logica: AND o OR
  3. 3. Connetti due o più output booleani (da nodi Condizione o altri nodi Logica) ai suoi input
  4. 4. Connetti l'output a un nodo Azione, un altro nodo Logica, o un nodo Imposta Variabile
PATTERN COMUNI
  • • Entrata multi-filtro: rsi:p=14 < 30 AND close > sma:p=200 (ipervenduto ma in trend rialzista)
  • • Trigger uscita multipli: profit% > 2 OR time_in_position > 24h
  • • Conferma rischio: segnale entrata AND volume > volume medio

Esempio:

Per una golden cross con conferma RSI: usa due nodi Condizione (sma:p=20 > sma:p=200 AND rsi:p=14 > 50), connetti entrambi a un nodo Logica impostato su AND, poi connetti a un'azione BUY.

Azione

Esegue un ordine di mercato quando attivata

Cosa Fa:

Invia un ordine di mercato — BUY, SELL o CLOSE — quando il suo input trigger diventa true. Questo è il punto finale di esecuzione: una strategia ha bisogno di almeno un nodo Azione per piazzare trade.

Tipo di Azione: BUY (apre una posizione long), SELL (apre una posizione short o chiude una long), CLOSE (chiude la posizione aperta indipendentemente dalla direzione)
COME USARLO
  1. 1. Trascinalo sulla canvas dalla palette
  2. 2. Nel pannello, scegli il tipo di azione: BUY, SELL o CLOSE
  3. 3. Connetti un trigger booleano da un nodo Condizione o Logica
  4. 4. Facoltativamente connetti un valore numerico all'input size — se lasciato non connesso, la strategia usa la dimensione predefinita
COMPORTAMENTO ESECUZIONE
  • • L'azione scatta sulla candela dove il trigger passa da false a true
  • • Se il trigger rimane true per più candele di fila, l'azione scatta solo sulla prima
  • • La dimensione è interpretata nell'asset base del simbolo (per BTCUSDT, quello è BTC)

Esempio:

Per un'entrata RSI ipervenduto: connetti un nodo Condizione (rsi:p=14 < 30) all'input trigger di un nodo Azione, imposta l'azione su BUY, e collega un parametro position_size all'input size. La strategia acquista la dimensione dichiarata in BTC sulla candela in cui l'RSI scende per la prima volta sotto 30.

Super-Nodo

Sub-strategia o calcolo riutilizzabile impacchettato come singolo nodo

Cosa Fa:

Un Super-Nodo è un template salvato contenente un grafo di nodi interni. Metti un Super-Nodo sulla canvas e si comporta come un singolo blocco con porte di input e un output. Un template può dichiarare più di una porta di input, ognuna con il proprio nome e tipo (DATA, NUMERIC o BOOLEAN), così un singolo Super-Nodo può accettare più stream contemporaneamente.

COME USARLO
  1. 1. Trascina un Super-Nodo sulla canvas dalla palette
  2. 2. Nel pannello, scegli quale template usare tra i template salvati
  3. 3. Connetti gli input richiesti — il pannello mostra il nome e il tipo di ogni porta dichiarata dal template
  4. 4. Usa la porta di output come l'output di qualsiasi altro nodo
LAVORARE CON I TEMPLATE
  • • Riutilizzo: lo stesso template può essere inserito in molte strategie
  • • Modifica una volta: aggiornare il template propaga la modifica a ogni strategia che lo usa
  • • Costruisci il tuo: apri l'editor Super-Nodo per progettare un nuovo template con nodi Input, Output, Math, Condizione e Logica
  • • Input multipli:

Esempio:

Costruisci una volta un calcolatore di percentuale profitto come template Super-Nodo — i suoi input sono entry_price e close, il suo output è la percentuale di profitto. Poi inserisci quel Super-Nodo in qualsiasi strategia e collega il suo output a un nodo Condizione per confrontarlo con un target.

Commento

Aggiunge una nota di testo libero ovunque sulla canvas

Cosa Fa:

Le strategie diventano complesse rapidamente. I nodi Commento ti permettono di aggiungere una nota di testo ovunque — "questo controlla condizioni ipervenduto", "la logica di uscita inizia qui". Non hanno input, né output, né effetto sull'esecuzione. Sono puramente per i lettori umani.

Pro Tip:

Aggiungi commenti prima di dimenticare. Il tuo io futuro ti ringrazierà quando tornerai a ottimizzare una strategia da 50 nodi e non ricorderai cosa fa ogni sezione.

Imposta Variabile

Memorizza un valore in una variabile di strategia con nome quando si attiva una condizione

Cosa Fa:

Il nodo Imposta Variabile salva un valore in una variabile a livello di strategia ogni volta che il suo input condizione è true (oppure ad ogni tick quando conditionMode è impostato su 'always'). Non ha porta di output — è un nodo a effetto collaterale. Altre parti della strategia possono leggere la variabile memorizzata come colonna su una Fonte Dati, permettendo alla logica a valle di ricordare un valore di un momento precedente nel tempo. La porta value accetta un valore NUMERIC costante oppure può essere connessa a una colonna DATA tramite il selettore valueColumn nel pannello.

COME USARLO
  1. 1. Trascinalo sulla canvas dalla palette (etichetta: Imposta Variabile)
  2. 2. Apri il pannello e dai un nome alla variabile, ad esempio entry_rsi
  3. 3. Connetti un segnale booleano alla porta input condizione — questo determina quando il valore viene catturato. Imposta conditionMode su 'always' per scrivere ad ogni tick indipendentemente dalla condizione
  4. 4. Connetti una Fonte Dati alla porta value e scegli una colonna tramite valueColumn, oppure digita un valore NUMERIC fisso
  5. 5. I nodi a valle possono referenziare la variabile per nome come colonna sulla Fonte Dati per leggere l'ultimo valore catturato

Esempio:

Vuoi ricordare il valore RSI nel momento in cui si attiva la tua condizione di entrata. Connetti un nodo Condizione (rsi:p=14 < 30) alla porta condizione, connetti la colonna rsi:p=14 alla porta value, e nomina la variabile entry_rsi. Su ogni candela dove l'RSI scende sotto 30, la lettura RSI corrente viene memorizzata. Un nodo Condizione successivo può confrontare entry_rsi con un altro valore — ad esempio per verificare se l'RSI all'entrata era più estremo di una soglia prima di consentire un'uscita.

Nodi Dentro i Super-Nodi#

Quando apri l'editor Super-Nodo per costruire il tuo template, due nodi extra sono disponibili che non esistono sulla canvas della strategia: Input e Output. Definiscono le porte che il tuo template espone all'esterno. Dentro il template puoi usare anche nodi Math, Condizione e Logica — sono gli stessi nodi disponibili sulla canvas della strategia, riutilizzati nel grafo interno.

Consiglio Principianti: Non hai bisogno dei Super-Nodi per lanciare una strategia funzionante. Inizia con la canvas della strategia, avvia un backtest, poi torna qui quando ti ritrovi a copiare lo stesso blocco di logica tra strategie.

Input

Porta dati dentro il tuo Super-Nodo

Dentro un template Super-Nodo, ogni porta di input che il template dichiara è rappresentata da un nodo Input. Quando il Super-Nodo viene inserito su una canvas strategia, tutto ciò che si connette a quella porta fluisce nel grafo interno attraverso questo nodo. Ogni Input ha un nome (l'etichetta mostrata sulla porta esterna) e un tipo (DATA, NUMERIC o BOOLEAN).

Output

Invia il risultato fuori dal tuo Super-Nodo

Dopo che tutti i nodi interni hanno svolto il loro lavoro, il nodo Output porta il valore finale alla porta di output esterna del Super-Nodo. Ogni template Super-Nodo ha esattamente un nodo Output, con un nome e un tipo (DATA, NUMERIC o BOOLEAN).

Consigli per Iniziare#

Inizia Semplice

La tua prima strategia può essere solo tre nodi: Fonte Dati → Condizione (rsi:p=14 < 30) → Azione (BUY). Prendi confidenza con le basi prima di aggiungere complessità.

Ogni Strategia Ha Bisogno Di...

  • • Almeno un nodo Fonte Dati che fornisce le colonne che legge
  • • Almeno un nodo Azione configurato come BUY
  • • Almeno un nodo Azione configurato come SELL (così la strategia può anche uscire)
  • • Condizioni collegate a quelle azioni affinché si attivino davvero

Errori Comuni dei Principianti

  • • Dimenticare di aggiungere la colonna referenziata in un nodo Condizione all'elenco colonne della Fonte Dati
  • • Usare OR quando si intendeva AND, o viceversa
  • • Nessuna logica di uscita — pianifica sempre come la strategia esce da una posizione
  • • Digitare nomi feature a mano — copiali dal catalogo così il nome canonico è corretto

Pro Tip

Usa liberamente i nodi Commento. Quando hai più di venti nodi sulla canvas, commenti come "logica entrata" e "gestione rischio" rendono molto più facile navigare il grafo in seguito.

Pronto a Costruire?

Costruisci la Tua Prima Strategia (Step-by-Step)

Segui il tutorial per principianti per creare una strategia RSI mean reversion. Ogni nodo, ogni connessione, e il ragionamento dietro ogni parte.

Tutorial Strategia RSI

Costruisci una strategia RSI completa da zero, fai backtest, e impara come leggere i risultati. Un percorso pratico per chi impara visivamente.

Avanzato: Costruisci Super-Nodi

Una volta che ti senti a tuo agio con le strategie regolari, impara come impacchettare la logica ricorrente in template Super-Nodo riutilizzabili ovunque.