Contrato de la solicitud

GET /api/v1/portfolios/{portfolioId}/balances. Consulta los últimos saldos normalizados de una cuenta de plataforma conectada. Envía el token personal mediante X-API-Key y mantenlo fuera del código del navegador y de los registros públicos.

Respuesta y consumo

Cada elemento identifica el activo, el tipo de cartera y las cantidades disponibles o bloqueadas sin exponer el modelo de transporte del proveedor. Las respuestas correctas con consumo publican X-Credit-Cost y X-Credits-Remaining para registrar el uso sin realizar otra solicitud.

Comportamiento en producción

El endpoint lee el estado sincronizado almacenado. Inicia una sincronización aparte cuando el producto necesite datos más recientes del proveedor. Gestiona los errores application/problem+json mediante su código estable, conserva el identificador de correlación y no repitas una mutación salvo que el flujo sea idempotente.