Contrato de la solicitud
GET /api/v1/portfolios. Enumera las carteras de plataformas de la cuenta API autenticada sin devolver las credenciales cifradas del proveedor. 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 incluye los metadatos de las cuentas y el estado de paginación. Un límite de hasta 50 cuesta un crédito; de 51 a 100, dos. 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 identificadores de cartera son recursos opacos y cada operación comprueba su pertenencia a la cuenta API autenticada. 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.