El rendimiento comienza con instantáneas almacenadas de la cartera
Un saldo actual no puede reconstruir el camino que siguió una cartera. Los registros de servicio agregan instantáneas en conexión, sincronización y eliminación, y luego devuelve puntos para un rango solicitado. El primer punto rastreado es un límite explícito: el API no afirma un rendimiento histórico durante periodos previos a que existan datos fiables.
Los depósitos y retiradas no son retorno de inversión
Los flujos de caja externos cambian el valor de la cartera sin representar el beneficio o la pérdida. El historial de proveedores soportado se importa y se valora cerca de la fecha del evento, por lo que las contribuciones netas pueden separarse del rendimiento del mercado. Las transferencias cuyo historial o precio de USD no está disponible reducen la cobertura en lugar de clasificarse silenciosamente como ganancia.
El Dietz modificado tiene en cuenta el tiempo
El API utiliza una estimación de Dietz modificada cuando existen suficientes datos. Cada flujo externo se pondera según el tiempo que estuvo presente en el periodo seleccionado, produciendo un retorno más significativo que dividir P&L por el valor de apertura. Sigue siendo una estimación que depende del espaciado de instantáneas, el historial del proveedor y la calidad de los precios.
La cobertura forma parte del resultado
Los estados completos, parciales, iniciados por seguimiento y sin datos impiden que un porcentaje que parece exacto supere a su evidencia. La interfaz del producto debería mostrar la etiqueta de cobertura cerca de P&L y devolver, explicar permisos o ventanas que faltan, y evitar clasificar a los usuarios o activar alertas de una cifra parcial como si fuera un rendimiento auditado.
Solicita el rango que el usuario está viendo
Los rangos de siete días, treinta días, noventa días, un año y todos los tiempos tienen diferentes puntos de inicio pero comparten las mismas reglas de cobertura. Obtén un nuevo rango cuando el usuario lo seleccione en lugar de descargar cada instantánea con antelación. Caché brevemente en el BFF solo si la sincronización invalida la serie almacenada en caché de forma previsible.