MangoLabsDOCS
Lancia

Super Nodes

I Super Nodes sono sub-strategie riutilizzabili che incapsulano logica complessa in singoli componenti modulari. Impara come creare e usare Super Nodes per costruire strategie di trading mantenibili senza ripeterti.

I Super Nodes Sono Privati (Eccetto Template Pubblici)

Importante: I Super Nodes che crei sono privati per il tuo account e non possono essere condivisi con altri utenti. Tuttavia, ci sono alcuni Super Nodes pubblici creati dagli admin di MangoLabs (come "Size 1000" e "calcolatori PNL") che tutti possono usare. Questi template pubblici sono ottimi punti di partenza per calcoli comuni.

Cosa Sono i Super Nodes?

I Super Nodes sono template che impacchettano multipli nodi e connessioni in un singolo componente riutilizzabile. Pensali come funzioni nella programmazione - definisci una volta, usa molte volte nelle TUE strategie. Rendono la logica complessa più facile da costruire, testare e mantenere.

Perché Usare Super Nodes?

Riutilizzabilità

Costruisci logica complessa una volta, usala in multiple strategie. Per esempio, crea un Super Node "Trend Filter" e usalo in tutte le tue strategie.

Manutenibilità

Aggiorna la logica in un posto e tutte le strategie che usano quel Super Node sono aggiornate automaticamente. Non serve modificare manualmente 10 strategie diverse.

Semplificazione

Collassa 20+ nodi in un singolo Super Node. Rende la tua canvas più pulita e più facile da capire a colpo d'occhio.

Privacy & Isolamento

I tuoi Super Nodes sono privati per il tuo account. Testa e itera senza influenzare altri. Usa template admin pubblici per esigenze comuni.

Pattern comuni

I Super-Nodi non hanno "tipi" espliciti all'interno del sistema — ogni template ha semplicemente un output tipizzato. Tre pattern ricorrono però abbastanza spesso da meritare un nome:

Filtri booleani

L'output è BOOLEAN. Il Super-Nodo combina più input in un singolo segnale vero/falso. Utile per filtri di trend, controlli di volatilità e conferme sul volume.

Esempio: Super Node "Strong Uptrend"

  • • Inputs: close (NUMERIC), sma:p=50 value, sma:p=200 value
  • • Inner logic: close > fast SMA AND fast SMA > slow SMA
  • • Output: BOOLEAN (true when uptrend confirmed)

Calcolatori numerici

L'output è NUMERIC. Il Super-Nodo esegue operazioni aritmetiche sui suoi input. Utile per indicatori personalizzati, dimensionamento delle posizioni e calcoli di percentuale di profitto.

Esempio: Super Node "Position Size Calculator"

  • • Inputs: cash (NUMERIC), risk_pct (NUMERIC), stop_distance (NUMERIC)
  • • Inner logic: (cash × risk_pct) ÷ stop_distance
  • • Output: NUMERIC (position size in base asset units)

Segnali compositi

L'output è BOOLEAN, costruito da una catena di condizioni e porte logiche che insieme rappresentano una decisione completa di entrata o uscita.

Esempio: Super Node "Mean Reversion Entry"

  • • Inputs: close, rsi:p=14, bollinger:p=20,std=2#bb_lower
  • • Inner logic: rsi < 30 AND close ≤ lower Bollinger band
  • • Output: BOOLEAN (entry signal)

Creare Super Nodes

1

Creazione Step-by-Step

  1. Naviga al Super Nodes Manager: Clicca "Super Nodes" nella sidebar (o accedi dallo Strategy Builder)
  2. Clicca "Create New Super Node": Apre l'editor canvas Super Node
  3. Definisci Inputs & Outputs: Inputs: parametri personalizzabili ogni volta che usi il Super Node. Outputs: cosa ritorna il Super Node
  4. Costruisci Logica Interna: Aggiungi nodi e connessioni come costruire strategia regolare
  5. Testa il Super Node: Esegui validazione e testa con diversi valori input
  6. Salva & Nomina: Dai un nome descrittivo e descrizione opzionale

Esempio: Costruire un Super Node "Trend Filter"

Questo Super Node determina se il mercato è in forte uptrend. Può essere riusato in qualsiasi strategia per filtrare trade.

Inputs dichiarati dal template:
  • close (NUMERIC) — il prezzo corrente
  • fast_sma (NUMERIC) — una media mobile semplice veloce
  • slow_sma (NUMERIC) — una media mobile semplice lenta
Grafo interno:
1. Condition A: close > fast_sma
2. Condition B: fast_sma > slow_sma
3. Nodo Logic: A AND B
4. Il nodo Output riceve il risultato booleano
Output: BOOLEAN (vero quando entrambe le condizioni sono soddisfatte)

Sul canvas di una strategia, inserisci un Data Source con le colonne close, sma:p=50, sma:p=200. Inserisci il Super-Nodo Trend Confirmation. Connetti close alla porta close, sma:p=50 a fast_sma, sma:p=200 a slow_sma. L'output booleano confluisce nella tua logica di entrata.

Usare Super Nodes nelle Strategie

Inserirlo sulla canvas

  1. Apri o crea una strategia nello Strategy Builder.
  2. Dalla palette, trascina la voce Super-Nodo sulla canvas.
  3. Apri il pannello proprietà e scegli un template dal menu a tendina.
  4. Il nodo si ridisegna con una porta di input per ogni input dichiarato dal template, più una porta di output. Ogni porta mostra il tag del suo tipo (D, N, B).
  5. Connetti ogni porta di input al nodo upstream corrispondente — i tipi devono corrispondere (le porte DATA accettano DATA, NUMERIC accetta NUMERIC, BOOLEAN accetta BOOLEAN).
  6. Connetti la porta di output a qualsiasi nodo che consuma il suo risultato a valle.

Porte di Input Multiple

Un template può dichiarare più di una porta di input. Ogni porta ha il proprio nome e tipo — DATA, NUMERIC o BOOLEAN. Il numero e i tipi di porte sono fissati dal template; non si aggiungono o rimuovono porte sull'istanza del canvas, ma si modificano editando il template stesso. Quando si inserisce il Super-Nodo, sul lato sinistro appare una porta di input per ogni input dichiarato.

Un template "Divergence Detector" dichiara due input: price (DATA) e rsi_value (NUMERIC), più un output booleano. Sul canvas, il Super-Nodo inserito mostra due porte di input — price [D] e rsi_value [N] — e una porta di output [B]. Connetti la colonna close di un Data Source a price, la colonna rsi:p=14 a rsi_value, e alimenta l'output booleano nella tua condizione di entrata.

Best Practices

Mantieni Super Nodes Focalizzati

Un Super Node dovrebbe fare una cosa ben fatta. Non provare a impacchettare intera strategia in un Super Node.

Usa Nomi Descrittivi

Nomina Super Nodes chiaramente così sai cosa fanno mesi dopo. "Trend Filter SMA 50/200" è meglio di "Filter1".

Documenta Inputs

Aggiungi descrizioni ai tuoi parametri input così ricordi cosa significano quando li usi dopo.

Testa Accuratamente

Testa Super Nodes con vari input prima di usarli in strategie live. Bug in Super Node influenzano tutte le strategie che lo usano.

Cronologia Revisioni

Ogni salvataggio di un Super-Nodo crea uno snapshot della sua definizione. Puoi sfogliare la cronologia completa dall'interno dell'editor e ripristinare qualsiasi versione precedente. Il ripristino di una revisione precedente crea una nuova revisione invece di sovrascrivere l'ultima, quindi nessun salvataggio va mai perso. Vedi la pagina Cronologia Revisioni per la guida completa.

Passo Successivo

Riferimento Tipi di Nodo

Un riferimento completo per ogni nodo disponibile sul canvas strategia e all'interno dei template Super-Nodo.

Cronologia Revisioni

Come i salvataggi vengono registrati automaticamente e come ripristinare una versione precedente di qualsiasi strategia o template.

Tutorial Prima Strategia

Costruisci una strategia completa di mean-reversion su RSI passo dopo passo — incluso un Super-Nodo per il position sizing.