Sentinel è un bot di trading algoritmico modulare scritto in Python. Progettato con un'architettura enterprise-grade, utilizza Alpaca Markets API per l'esecuzione degli ordini (attualmente in modalità Paper Trading) e Pandas per l'analisi quantitativa dei dati di mercato.
Il progetto non è un semplice script lineare, ma è strutturato seguendo il principio della Single Responsibility e utilizza pattern moderni:
- Core Settings (
app/core/): Gestione tipizzata degli ambienti (Development, Production, Testing) tramite Pydantic. Fail-fast garantito in caso di variabili d'ambiente mancanti. - Services (
app/services/): *MarketDataService: Modulo disaccoppiato per il download dei dati storici (OHLCV) tramite feed IEX.MovingAverageStrategy: Motore logico basato su Pandas per il calcolo dei segnali operativi.OrderExecutor: Gestore dell'esecuzione degli ordini con controlli di sicurezza pre-trade (previene lo short selling accidentale).
La versione attuale implementa una SMA Crossover (Incrocio di Medie Mobili Semplici):
- Media Veloce (Fast SMA): 9 periodi.
- Media Lenta (Slow SMA): 21 periodi.
- Genera un segnale di
COMPRA(Golden Cross) oVENDI(Death Cross) basandosi sull'incrocio delle medie sul prezzo di chiusura giornaliero.
- Python 3.10+
- Un account gratuito su Alpaca Markets (Paper Trading attivato).
git clone [https://github.com/TUO-NOME-UTENTE/sentinel.git](https://github.com/TUO-NOME-UTENTE/sentinel.git)
cd sentinel