Integrato 3 fonti ma da finire binance. Fatto una struttura con i signers per i servizi.

docs/Market_Data_Implementation_Plan.md

@@ -0,0 +1,96 @@
+# 🚀 Piano di Implementazione - Market Data Enhancement
+
+## 📋 Roadmap Implementazioni
+
+### **Fase 1: Binance Mock Provider** 
+**Obiettivo**: Aggiungere terzo provider per test aggregazione
+- ✅ Creare `binance_signer.py` con mock data
+- ✅ Integrare nel MarketAgent
+- ✅ Testare detection automatica provider
+- **Deliverable**: 3 provider funzionanti (Coinbase, CryptoCompare, Binance)
+
+### **Fase 2: Interrogazione Condizionale**
+**Obiettivo**: Auto-detection credenziali e interrogazione intelligente
+- ✅ Migliorare detection chiavi API nel MarketAgent
+- ✅ Skip provider se credenziali mancanti (no errori)
+- ✅ Logging informativo per provider disponibili/non disponibili
+- ✅ Gestione graceful degradation
+- **Deliverable**: Sistema resiliente che funziona con qualsiasi combinazione di provider
+
+### **Fase 3: Interrogazione Asincrona + Aggregazione JSON**
+**Obiettivo**: Performance boost e formato dati professionale
+
+#### **3A. Implementazione Asincrona**
+- ✅ Refactor MarketAgent per supporto `async/await`
+- ✅ Chiamate parallele a tutti i provider disponibili
+- ✅ Timeout management per provider lenti
+- ✅ Error handling per provider che falliscono
+
+#### **3B. Aggregazione Dati Intelligente**
+- ✅ Calcolo `confidence` basato su concordanza prezzi
+- ✅ Analisi `spread` tra provider
+- ✅ Detection `price_divergence` per anomalie
+- ✅ Volume trend analysis
+- ✅ Formato JSON strutturato:
+
+```json
+{
+  "aggregated_data": {
+    "BTC_USD": {
+      "price": 43250.12,
+      "confidence": 0.95,
+      "sources_count": 4
+    }
+  },
+  "individual_sources": {
+    "coinbase": {"price": 43245.67, "volume": "1.2M"},
+    "binance": {"price": 43255.89, "volume": "2.1M"},
+    "cryptocompare": {"price": 43248.34, "volume": "0.8M"}
+  },
+  "market_signals": {
+    "spread_analysis": "Low spread (0.02%) indicates healthy liquidity",
+    "volume_trend": "Volume up 15% from 24h average", 
+    "price_divergence": "Max deviation: 0.05% - Normal range"
+  }
+}
+```
+
+**Deliverable**: Sistema asincrono con analisi avanzata dei dati di mercato
+
+## 🎯 Benefici Attesi
+
+### **Performance**
+- ⚡ Tempo risposta: da ~4s sequenziali a ~1s paralleli
+- 🔄 Resilienza: sistema funziona anche se 1-2 provider falliscono
+- 📊 Qualità dati: validazione incrociata tra provider
+
+### **Professionalità**
+- 📈 Confidence scoring per decisioni informate
+- 🔍 Market signals per trading insights
+- 📋 Formato standardizzato per integrazioni future
+
+### **Scalabilità**
+- ➕ Facile aggiunta nuovi provider
+- 🔧 Configurazione flessibile via environment
+- 📝 Logging completo per debugging
+
+## 🧪 Test Strategy
+
+1. **Unit Tests**: Ogni provider singolarmente
+2. **Integration Tests**: Aggregazione multi-provider
+3. **Performance Tests**: Confronto sync vs async
+4. **Resilience Tests**: Fallimento provider singoli
+5. **E2E Tests**: Full workflow con UI Gradio
+
+## 📅 Timeline Stimata
+
+- **Fase 1**: ~1h (setup Binance mock)
+- **Fase 2**: ~1h (detection condizionale)  
+- **Fase 3**: ~2-3h (async + aggregazione)
+- **Testing**: ~1h (validation completa)
+
+**Total**: ~5-6h di lavoro strutturato
+
+---
+*Documento creato: 2025-09-23*
+*Versione: 1.0*