Contrato de la solicitud

GET /api/v1/portfolio. Agrega todas las carteras sincronizadas de la cuenta API autenticada en una única respuesta actual. 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

La respuesta contiene el valor total en USD, las posiciones por activo, las tenencias con su procedencia y campos de 24 horas derivados del mercado. 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

Los campos de 24 horas no representan el P&L acumulado basado en transacciones. Utiliza el endpoint de rendimiento para consultar resultados históricos registrados. 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.