Architettura Sistema

Documentazione Completa del Processo

Panoramica del Sistema

Il sistema di trading automatico e composto da tre livelli principali che lavorano in sinergia:

Portfolio Brain

Meta-AI strategico che decide cosa tradare, quanto allocare e il risk profile globale

Watchdog

Monitor real-time che sorveglia ogni crypto, calcola indicatori e triggera l'AI

Claude AI

Intelligenza artificiale che analizza mercato e prende decisioni BUY/SELL/HOLD

Flusso Operativo Completo

Input Ricevuti

  • Budget Totale: Unico parametro esterno (es. €5000)
  • Stato Mercato: BTC 24h%, volatilita, sentiment
  • Posizioni Attive: Tutte le posizioni aperte
  • Performance: P&L giornaliero e totale

Decisioni Output

  • Risk Profile: conservative/moderate/aggressive/degen
  • Target Giornaliero: % obiettivo (es. 2%)
  • Stop Loss Giornaliero: % limite perdita (es. -3%)
  • Crypto da Tradare: Lista assets (max 6)
  • Allocazione: Come distribuire il budget (equal/weighted)

⚠️ Nota: La LEVA non viene decisa dal Brain. Viene decisa dal singolo bot AI al momento dell'apertura della posizione.

Crypto Universe Disponibili

BTCETHSOLADALINKDOTAVAXMATICXRPDOGE

Un Watchdog per ogni crypto. Ogni istanza monitora UN solo simbolo (es. ADA) e ha i propri file di stato separati per exchange e mode.

Loop Continuo (ogni 5 sec)

  • Fetch Prezzo: Da Kraken Futures API
  • Calcolo Volatilita: Std dev dei cambi %
  • Check SL/TP: Verifica stop loss e take profit
  • Trailing Stop: Protegge profitti automaticamente

Trigger per AI

  • NEAR_SL/TP: 70% verso stop loss o take profit
  • PRICE_JUMP: Movimento >0.5% improvviso
  • HIGH_VOLATILITY: 2x volatilita normale
  • TIMER_EXPIRED: Intervallo AI scaduto

Indicatori Tecnici Calcolati

Trend
SMA 20/50, EMA 12/26
Momentum
RSI, Stoch RSI, MACD
Volatilita
Bollinger, ATR
Volume
VWAP, OBV, Vol Ratio

Economy Mode: Usa Claude Haiku (10x piu economico di Sonnet) con intervalli ottimizzati per ridurre i costi API.

Contesto Ricevuto

  • Prezzo attuale e variazioni
  • Tutti gli indicatori tecnici
  • Posizione attuale (se presente)
  • Risk profile e vincoli
  • Ora e giorno (contesto temporale)

Decisioni Output

  • ACTION: BUY / SHORT / SELL / COVER / HOLD
  • CONFIDENCE: 1-10 (min richiesto dal risk profile)
  • STOP_LOSS: % basato sul risk profile
  • TAKE_PROFIT: % basato sul risk profile
  • LEVERAGE: Deciso dinamicamente (fino al max exchange)
  • NEXT_INTERVAL: Quando richiamare AI

Budget Tier Strategies

Il Brain alloca automaticamente il budget tra le crypto in base al capitale disponibile. Strategie diverse per budget diversi garantiscono un approccio ottimale.

MICRO
$500 - $1,500
Posizioni:2 max
Min/pos:$250
BTC, ETH
SMALL
$1,500 - $3,000
Posizioni:3 max
Min/pos:$400
BTC, ETH, SOL
MEDIUM
$3,000 - $7,000
Posizioni:4 max
Min/pos:$500
BTC, ETH, SOL, ADA, LINK
LARGE
$7,000 - $15,000
Posizioni:5 max
Min/pos:$800
+ AVAX
WHALE
$15,000+
Posizioni:6 max
Min/pos:$1,500
+ DOT, XRP

La leva NON è definita dal tier. Viene decisa dinamicamente dal bot AI al momento dell'apertura, fino ai limiti dell'exchange.

Bot Manager e Auto-Restart

Il sistema include un Bot Manager centralizzato che previene duplicati e un Supervisor che riavvia automaticamente i bot crashati.

Bot Manager

  • Registry centrale di tutti i bot attivi
  • Anti-duplicati: controlla prima di avviare
  • Sync automatico con processi reali
  • Traccia stop intenzionali (AI/manuale)

Bot Supervisor

  • Gira ogni minuto via cron
  • Auto-riavvia bot crashati
  • NON riavvia stop intenzionali
  • Max 5 restart/ora per bot

File di Configurazione

bot_registry.json - Registro bot attivi
bot_stop_history.json - Stop intenzionali

Auto-Allocazione e Ribilanciamento

Auto-Allocazione Budget

Quando imposti il budget, il Brain alloca automaticamente TUTTO il capitale alle migliori crypto disponibili.

Seleziona crypto in base al budget tier
Calcola opportunity score per ogni crypto
Alloca budget pesato per score
Rispetta min per posizione del tier

Ribilanciamento Giornaliero

Ogni giorno il Brain rivaluta il portafoglio e sostituisce bot underperforming.

Analizza opportunita mercato attuali
Valuta performance bot (win rate, P&L)
Sostituisce bot se <30% win rate o migliore alternativa
MAI ferma bot con posizioni aperte

Sistema di Scoring Opportunita

Ogni crypto riceve uno score da 0 a 100 basato su:

📊
Volatilita
0.5-2% = ottimale
+20 punti
📈
Trend 24h
>2% movimento
+15/25 punti
💰
Volume
>$100M
+10 punti
⚠️
Crash
<-10% = penalita
-20 punti

Risk Profiles

Conservative
  • Stop Loss1-2%
  • Take Profit2-4%
  • Min Confidence7/10

Prudente, pochi trade, protezione capitale prioritaria

Moderate
  • Stop Loss2-3%
  • Take Profit4-6%
  • Min Confidence6/10

Equilibrato tra rischio e reward

Aggressive
  • Stop Loss3-5%
  • Take Profit6-10%
  • Min Confidence5/10

Cerca grandi movimenti, accetta piu rischio

Degen
  • Stop Loss5-10%
  • Take Profit10-25%
  • Min Confidence4/10

Alto rischio, alto reward - YOLO mode

Leva Dinamica

La leva NON è fissa per risk profile. Il bot AI decide la leva ottimale al momento dell'apertura della posizione, considerando volatilità, trend e condizioni di mercato. Può usare fino al massimo consentito dall'exchange (es. BTC: 50x, ADA: 10x).

Sistema Trailing Stop

Il Trailing Stop protegge i profitti automaticamente. L'AI decide i parametri per ogni posizione:

TRAIL_ACTIVATION

A che % di profitto attivare il trailing (es: +1.5%)

+1.0% ~ +3.0%

TRAIL_DISTANCE

Quanto puo scendere dal max prima di chiudere (es: 0.8%)

0.5% ~ 1.5%

MAX_PROFIT_PCT

Traccia il massimo profitto raggiunto dalla posizione

Dinamico

Esempio Pratico

  1. Entry a $100, trail_activation: 1.5%, trail_distance: 0.8%
  2. Prezzo sale a $102 (+2%) → trailing attivo, max_profit = 2%
  3. Prezzo sale a $103 (+3%) → max_profit = 3%
  4. Prezzo scende a $102.2 (+2.2%) → ancora OK (3% - 2.2% = 0.8%)
  5. Prezzo scende a $102.1 (+2.1%) → TRAILING STOP! (3% - 2.1% = 0.9% > 0.8%)

Indicatori Tecnici Utilizzati

📈 Trend

  • SMA 20/50 - Simple Moving Average
  • EMA 12/26 - Exponential Moving Average
  • Trend Direction - bullish/bearish/neutral

⚡ Momentum

  • RSI 14 - 1h e 15m
  • Stochastic RSI - con signal line
  • MACD - line, signal, histogram
  • MACD Cross - bullish/bearish

📉 Volatilita

  • Bollinger Bands - upper/middle/lower
  • BB Position - 0-100%
  • ATR 14 - Average True Range
  • ATR % - rispetto al prezzo

📊 Volume

  • Volume Ratio - vs media 20
  • VWAP - Volume Weighted Avg Price
  • OBV Trend - On-Balance Volume
  • Support/Resistance - livelli chiave

Costi e Fee (Simulazione Realistica)

Trading Fee
0.04%
Taker fee per trade
Slippage
0.02%
Per esecuzione
Funding Fee
0.01%
Ogni 8 ore
Round-Trip
~0.12%
Costo totale per trade

Questi costi vengono applicati in paper mode per simulare condizioni reali di trading su Kraken Futures. In live mode, i costi effettivi dipendono dall'exchange e dal tier del tuo account.

Limiti Leva Kraken Futures

BTC
50x
ETH
50x
SOL
25x
XRP
25x
LTC
25x
LINK
10x
ADA
10x
AVAX
10x
DOT
10x
DOGE
10x
MATIC
10x
ATOM
10x

Questi sono i limiti massimi dell'exchange. Il bot AI decide la leva ottimale dinamicamente al momento dell'apertura della posizione, valutando volatilità, trend e condizioni di mercato. Può usare qualsiasi valore fino al limite massimo.

Comandi Utili

# Vedere bot attivi
ps aux | grep "watchdog.py" | grep -v grep
# Stato servizio Next.js
sudo systemctl status trad-cuttalo.service
# Log watchdog per simbolo
tail -f /var/www/html/trading-agents/data/log_BTC_kraken_paper.txt
# Fermare tutti i bot
sudo pkill -9 -f "watchdog.py"
# Avviare bot manualmente
cd /var/www/html/trading-agents && ./venv/bin/python3 watchdog.py --symbol BTC --amount 500 --risk moderate --exchange kraken --mode paper
# Comandi Portfolio Brain
# Auto-allocazione budget (alloca TUTTO il budget)
./venv/bin/python3 portfolio_brain.py --budget 3000 --action auto_allocate --exchange kraken --mode paper
# Ribilanciamento giornaliero (valuta e sostituisce bot)
./venv/bin/python3 portfolio_brain.py --budget 3000 --action rebalance --exchange kraken --mode paper
# Vedere opportunita di mercato e score
./venv/bin/python3 portfolio_brain.py --budget 3000 --action opportunities --exchange kraken --mode paper
# Stato portfolio brain
./venv/bin/python3 portfolio_brain.py --action status --exchange kraken --mode paper
# Comandi Bot Manager
# Stato bot e registry
./venv/bin/python3 bot_manager.py --action status
# Sincronizza registry con processi reali
./venv/bin/python3 bot_manager.py --action sync
# Termina bot duplicati
./venv/bin/python3 bot_manager.py --action kill-duplicates
# Esegui supervisor manualmente
./venv/bin/python3 bot_supervisor.py --verbose