En resumen
- Conectas un exchange vía API de solo lectura desde la pestaña Connections del perfil.
- Obtienes una vista unificada: valor total, P&L, precio medio de compra, asignación, gráfico histórico.
- Los datos de precio vienen del backend API, no del store real-time de los pulses.
- Saturia nunca custodia fondos y no puede ejecutar operaciones por ti.
En detalle
Cómo se recopilan los datos
Saturia nunca custodia fondos. El módulo Portfolio lee saldos y transacciones desde las fuentes que tú autorizas, exclusivamente en solo lectura:
- Exchange → conectas una API key desde el área Connections en ajustes. Al generar la API key en el exchange, debes deshabilitar los permisos de trade, withdrawal y future/margin. Saturia solo requiere "read only".
Las API keys se almacenan cifradas en el backend. Nunca se comparten con terceros ni se usan para operar en el mercado.
Qué exchanges
El soporte para exchanges individuales depende del estado del backend. Al momento de escribir esta guía, la conexión principal confirmada es Binance a través de la pestaña Connections del perfil. A medida que se añaden otros exchanges, los encuentras en la misma pestaña — verifica directamente ahí para la lista actualizada.
P&L, precio medio de compra, asignación
Para tu portfolio ves:
- Valor total y variación en los periodos de referencia.
- Precio medio de compra calculado sobre el historial de transacciones importadas.
- P&L neto (agregado).
- Asignación por activo (distribución sobre el total).
- Gráfico histórico del valor del portfolio en el tiempo.
El cálculo del precio medio depende de la integridad del historial importado: si faltan algunas transacciones, el cálculo puede ser aproximado.
Una regla fundamental: los precios vienen del backend
Es una elección arquitectónica importante. Los precios usados para valorar el portfolio vienen siempre del backend API, nunca del store real-time de los pulses. La razón: el store pulses es un canal de alta frecuencia pensado para alimentar las señales, no para cálculos estables de valoración.
Mantener las dos cosas separadas garantiza que:
- El valor del portfolio no "tiembla" al ritmo del stream real-time.
- El risk score y el P&L se calculan sobre datos coherentes y reproducibles.
- Las métricas se mantienen estables aunque el canal pulses tenga retrasos o interrupciones.
Privacidad
Los datos de tu portfolio son privados y visibles solo para ti. No se usan para alimentar datasets agregados mostrados a otros usuarios. Puedes desconectar una API key en cualquier momento desde la misma pestaña desde la que la añadiste.
Buenas prácticas
- Usa siempre API read-only. Si un servicio te pide permisos de trade o withdrawal para "tracking", abandónalo.
- Etiqueta las API keys en el exchange con un nombre claro ("Saturia-Read"), para que sepas qué revocar en caso de duda.
- Verifica las asignaciones con regularidad, no obsesivamente.
Próximo paso
Continúa con el risk score para entender cómo Saturia evalúa el riesgo de tu portfolio.