In breve
- Colleghi un exchange via API in sola lettura dalla scheda Connections del profilo.
- Ottieni una vista unificata: valore totale, P&L, prezzo medio di carico, allocazione, grafico storico.
- I dati di prezzo arrivano dal backend API, non dallo store real-time dei pulses.
- Saturia non custodisce mai fondi e non può eseguire operazioni al posto tuo.
Approfondimento
Come vengono raccolti i dati
Saturia non custodisce mai fondi. Il modulo Portfolio legge i saldi e le transazioni dalle fonti che tu autorizzi, esclusivamente in sola lettura:
- Exchange → colleghi una API key dall'area Connections nelle impostazioni. Al momento di generare la API key sull'exchange, devi disabilitare i permessi di trade, withdrawal e future/margin. Saturia richiede solo "read only".
Le API key sono archiviate cifrate lato backend. Non vengono mai condivise con terze parti e non vengono usate per operare sul mercato.
Quali exchange
Il supporto per i singoli exchange dipende dallo stato del backend. Al momento di scrittura di questa guida, la connessione principale confermata è Binance tramite la scheda Connections del profilo. Man mano che vengono aggiunti altri exchange, li trovi nella stessa scheda — verifica direttamente lì per avere l'elenco aggiornato.
P&L, prezzo medio di carico, allocazione
Per il tuo portafoglio vedi:
- Valore totale e variazione sui periodi di riferimento.
- Prezzo medio di carico calcolato sullo storico delle transazioni importate.
- P&L netto (aggregato).
- Allocazione per asset (distribuzione sul totale).
- Grafico storico del valore del portafoglio nel tempo.
Il calcolo del prezzo medio dipende dalla completezza dello storico importato: se alcune transazioni non sono disponibili, il calcolo può essere approssimato.
Una regola fondamentale: i prezzi arrivano dal backend
Questa è una scelta architetturale importante. I prezzi usati per valutare il portafoglio arrivano sempre dal backend API, mai dallo store real-time dei pulses. Il motivo: lo store pulses è un canale ad alta frequenza pensato per alimentare i segnali, non per calcoli stabili di valorizzazione.
Tenere separate le due cose garantisce che:
- Il valore del portafoglio non "tremola" al ritmo dello stream real-time.
- Il risk score e il P&L sono calcolati su dati coerenti e riproducibili.
- Le metriche restano stabili anche se il canale pulses ha ritardi o interruzioni.
Privacy
I dati del tuo portafoglio sono privati e visibili solo a te. Non vengono usati per alimentare dataset aggregati mostrati ad altri utenti. Puoi scollegare una API key in ogni momento dalla stessa scheda da cui l'hai aggiunta.
Best practice
- Usa sempre API read-only. Se un servizio ti chiede permessi di trade o withdrawal per "tracking", abbandona.
- Etichetta le API key sull'exchange con un nome chiaro ("Saturia-Read"), così sai cosa revocare in caso di dubbio.
- Verifica le allocazioni con regolarità, non ossessivamente.
Prossimo passo
Continua con il risk score per capire come Saturia valuta il rischio del tuo portafoglio.