📚 SimClaude — Documentazione

← Portale

Guida unica al sistema: architettura, flusso, strategia in pseudocodice, costi/tasse reali, regole e domande frequenti. Tutto in paper/testnet (soldi virtuali): stesso codice del live, si passa a soldi veri cambiando un flag.

1. Cos'è

SimClaude è un sistema di trading automatico con due mercati:

Un portale unico (questa pagina) le raccoglie ed espone in rete tramite Tailscale Funnel. Tutto riparte da solo dopo un riavvio del PC.

2. Architettura — il flow

RIAVVIO PC | v [ Cartella Esecuzione automatica ] --lancia--> trading-sim\avvia-boot.bat | +--> python app.py (Azioni · porta 5004) +--> python app.py (Crypto · porta 5005) +--> python portal.py(Portale · porta 5006) +--> tailscale funnel --bg 5006 | v https://dario.tail549254.ts.net (link pubblico) | +-----------+-----------+-----------+ v v v v /alpaca /crypto /security /docs (5004) (5005) (log) (questa pagina)

Il portale è un reverse proxy: /alpaca/* → 5004, /crypto/* → 5005. Le app non sono esposte direttamente: passi sempre dal portale.

3. Login e chiavi API (primo avvio)

apri l'app --> sei loggato? --no--> pagina LOGIN (password) |si v chiavi API presenti? --no--> WIZARD: inserisci chiavi |si (Alpaca / Binance) -> salva in .env v DASHBOARD operativa

4. Strategia — pseudocodice

Nucleo comune mean-reversion per azioni e crypto (si scommette sul ritorno verso la media dopo un eccesso), ma con filtri diversi: le azioni aggiungono il controllo shortable e la prudenza sul limite PDT; la crypto aggiunge il boost da sentiment/BTC e un veto LLM sugli ingressi. Entrambe fanno LONG e SHORT.

# CICLO CONTINUO
#   Azioni : ogni 60s, solo a mercato aperto (9:30-16:00 ET)
#   Crypto : ogni 12s, 24/7
per ogni simbolo nel batch:
    prezzi = ultime ~220 candele da 1 minuto
    rsi    = RSI(prezzi)                  # 0..100 (ipercomprato / ipervenduto)
    ml     = modello_logistico(prezzi)    # prob. di DISCESA  [0..1]  (live: soglia 0.52)
    sent   = FinBERT(news)                # sentiment [-1..+1]  (per entrare lo usa solo la crypto)

    # ---------- APERTURA (se simbolo libero e ci sono slot, max 10) ----------
    soglia_rsi = 65 ; se posizioni_aperte < 2:  soglia_rsi = 60   # "reclutamento" più aggressivo
    se rsi >= soglia_rsi      e  ml     >= ml_min:   candidato SHORT  # ipercomprato + atteso calo
    se rsi <= 100-soglia_rsi  e  (1-ml) >= ml_min:   candidato LONG   # ipervenduto + attesa salita

    # boost — SOLO CRYPTO: abbassa le soglie (rsi 60/40, ml 0.20) se c'è conferma
    se sent <= -0.25  oppure  BTC -1.5% in 30m:   sblocca uno SHORT anche moderato
    se sent >= +0.25  oppure  BTC +1.5% in 30m:   sblocca un LONG anche moderato

    # filtri prima di aprire davvero
    AZIONI: apri SHORT solo se il titolo è "shortable" (Regulation T)
    CRYPTO: veto LLM Gemma — se prevede la direzione OPPOSTA con conf >= 85%, salta

    # ---------- CHIUSURA (su ogni posizione aperta) ----------
    gain = variazione a favore della posizione
    se gain <= -3%:                          chiudi  (STOP-LOSS)  # sempre, anche stesso giorno
    se gain >= +4%:                          chiudi  (TAKE-PROFIT)
    se SHORT e rsi <= 35:                     chiudi  (rientro, trend esaurito)
    se LONG  e rsi >= 65:                     chiudi  (rientro, trend esaurito)
    # AZIONI: TP e rientro-RSI sono sospesi NEL GIORNO di apertura, per non bruciare
    #         un "day trade" sotto il limite PDT — lo stop-loss invece scatta comunque

addebita costi (commissioni, slippage, spread, funding/borrow fee)
alla chiusura in PROFITTO: trattieni la tassa (azioni 26% · crypto 33%)
salva lo stato su disco        # così sopravvive a un riavvio
ParametroAzioniCrypto
Leva×4×5
% budget per trade8%8%
Max posizioni1010
Take-profit / Stop-loss+4% / -3%+4% / -3%
Soglia RSI (short/long)65 / 3565 / 35 · 60 / 40 col boost
Soglia ML0.300.30 testnet · 0.52 live
Boost sentiment / BTCsì (news + momentum BTC)
Veto LLM (Gemma)sì (blocca se conf ≥ 85%)
Filtro shortable (Reg-T)
Prudenza PDT (no TP/RSI intraday)sì (< $25k)

5. Costi, commissioni e tasse (allineati al LIVE)

I costi sono simulati con i valori reali che pagheresti in live: passando a soldi veri i numeri non cambiano.

VoceAzioni (Alpaca)Crypto (Binance Futures)
Commissione trading$0 (Alpaca è commission-free)0,05% taker per lato (apertura + chiusura)
Fee regolamentariSEC + FINRA TAF sulle vendite (centesimi)
Borrow fee (short)~1,5%/anno sul nozionale
Funding fee~0,03%/giorno (perpetui)
Slippage + spread0,10% + 0,05% per lato0,10% + 0,05% per lato
Tassa plusvalenze (Italia)26%33% dal 01/01/2026 (era 26%)
Nota fiscale 2026: la Legge di Bilancio 2025 ha portato la tassa sulle plusvalenze crypto dal 26% al 33% dal 1° gennaio 2026 ed eliminato la franchigia di 2.000€. Le azioni/strumenti finanziari restano al 26%. La tassa è trattenuta solo sui trade chiusi in profitto; le perdite non riducono l'imponibile nel modello (semplificazione conservativa).

6. Regole di mercato da conoscere

7. Avvio automatico dopo riavvio

8. FAQ

Il bot fa guadagnare di sicuro ogni giorno?

No. Nessun bot garantisce profitti giornalieri. È una strategia mean-reversion che può anche perdere, specie in trend forti e prolungati. Per questo si parte in paper/testnet: per misurare i risultati reali prima di rischiare denaro vero.

Sono soldi veri?

No, ora è tutto virtuale (Alpaca Paper + Binance Testnet). Il passaggio al live è un flag (ALPACA_PAPER=false / BINANCE_TESTNET=false) e va fatto solo dopo settimane di risultati positivi, con limiti di rischio.

Fa sia long che short?

Sì, entrambe le app aprono sia LONG sia SHORT, in modo speculare: short su ipercomprato (RSI≥65), long su ipervenduto (RSI≤35), con conferma del modello ML e del sentiment.

Che ruolo hanno gli LLM locali (Ollama)?

Sono un overlay di sentiment/conferma sopra i segnali tecnici (RSI + ML + news FinBERT). Non predicono i prezzi e non decidono da soli: aiutano a filtrare. Modelli installati: dolphin-mistral, dolphin-phi, gemma2:2b.

Come accedo da fuori casa?

Dal link pubblico Tailscale del portale, poi login con la password dell'app. Le app non sono raggiungibili se non passi dal portale.

Cosa succede se il PC si spegne?

Al riavvio l'eseguibile riparte da solo (cartella Esecuzione automatica), riattiva il funnel e ogni app ricarica lo stato salvato su disco.

Posso cambiare la password?

Sì. Per le app: VIEW_PASSWORD nel rispettivo .env. Per la security dashboard: variabile SECURITY_PASSWORD (o nel codice del portale).

Perché la soglia ML è diversa tra testnet e live?

Il Binance Testnet usa prezzi sintetici e il modello non raggiunge mai 0.52, quindi solo lì si abbassa a 0.30 per restare operativi. In live torna automaticamente a 0.52: il parametro reale è quello.

SimClaude · paper/testnet · zero rischio finanziario · documentazione generata per rispondere alle domande più comuni.