CAFCI Fondos Comunes Argentina

Consulta datos de Fondos Comunes de Inversion (FCI) para usuarios finales con endpoints read-only de Anduin.

API Overview

• Base URL: https://anduin.ferminrp.com
• Auth: None required
• Response format: JSON
• Docs source: https://anduin.ferminrp.com/docs

Endpoints de Lectura

1) Fondos (listado)

• GET /api/v1/fci
• Filtros:
  • fecha (YYYY-MM-DD)
  • categoria_id (2-11)
  • horizonte (COR, MED, LAR, FLEX)
  • search
  • patrimonio_min
  • limit, offset
  • order_by (nombre, vcp, patrimonio, fecha)
  • order (asc, desc)

Ejemplos:

curl -s "https://anduin.ferminrp.com/api/v1/fci?limit=20&order_by=patrimonio&order=desc" | jq '.'
curl -s "https://anduin.ferminrp.com/api/v1/fci?categoria_id=3&horizonte=MED&limit=10" | jq '.data.fondos'

2) Fondo puntual

• GET /api/v1/fci/{nombre}
• Query opcional: fecha

Ejemplo:

curl -s "https://anduin.ferminrp.com/api/v1/fci/1810%20Ahorro" | jq '.'

3) Historico de fondo

• GET /api/v1/fci/{nombre}/historico
• Query opcionales: desde, hasta, intervalo (diario, semanal, mensual), limit

Ejemplo:

curl -s "https://anduin.ferminrp.com/api/v1/fci/1810%20Ahorro/historico?intervalo=mensual&limit=12" | jq '.'

4) Rendimiento de fondo

• GET /api/v1/fci/{nombre}/rendimiento
• Query opcionales: periodo (1d, 7d, 30d, 90d, ytd, 1y), fecha_base

Ejemplo:

curl -s "https://anduin.ferminrp.com/api/v1/fci/1810%20Ahorro/rendimiento?periodo=30d" | jq '.'

5) Comparar fondos

• GET /api/v1/fci/comparar
• Query:
  • fondos (requerido, coma-separado, max 10)
  • desde, hasta
  • metrica (vcp, patrimonio, rendimiento)

Ejemplo:

curl -s "https://anduin.ferminrp.com/api/v1/fci/comparar?fondos=1810%20Ahorro,Adcap%20Balanceado&metrica=rendimiento" | jq '.'

6) Rankings

• GET /api/v1/fci/rankings
• Query tipicos: periodo, categoria_id, orden, limit

Ejemplo:

curl -s "https://anduin.ferminrp.com/api/v1/fci/rankings?periodo=30d&limit=10" | jq '.'

7) Categorias

• GET /api/v1/fci/categorias
• GET /api/v1/fci/categorias/{id}

Ejemplos:

curl -s "https://anduin.ferminrp.com/api/v1/fci/categorias" | jq '.'
curl -s "https://anduin.ferminrp.com/api/v1/fci/categorias/3" | jq '.'

8) Estadisticas y fechas

• GET /api/v1/fci/stats
• GET /api/v1/fci/fechas

Ejemplos:

curl -s "https://anduin.ferminrp.com/api/v1/fci/stats" | jq '.'
curl -s "https://anduin.ferminrp.com/api/v1/fci/fechas" | jq '.'

9) Ficha / detalle de fondo

• GET /api/v1/fci/detalle/{identifier}
• identifier admite claseId numerico o nombre de fondo URL-encoded.

Ejemplos:

curl -s "https://anduin.ferminrp.com/api/v1/fci/detalle/4538" | jq '.'
curl -s "https://anduin.ferminrp.com/api/v1/fci/detalle/1810%20Ahorro" | jq '.'

Campos clave

• Estructura general de respuesta:
  • success
  • data
  • timestamp
• Campos frecuentes de fondos:
  • fondoNombre, slug, categoriaId, categoriaNombre, horizonte, vcp, patrimonio, fecha
• Historico:
  • registros[] con fecha, vcp, ccp, patrimonio
• Rendimiento:
  • variacionPorcentual, variacionAbsoluta, vcpInicial, vcpFinal, fechaInicial, fechaFinal
• Rankings:
  • posicion, fondoNombre, categoriaNombre, rendimiento
• Ficha/detalle:
  • clases, honorarios, cartera y rendimientos segun disponibilidad de origen

Workflow

1. Detectar intencion del usuario:
   • Listado
   • Detalle
   • Historico
   • Rendimiento
   • Comparacion
   • Ranking
   • Ficha
2. Validar inputs minimos (nombre, fondos, fechas, periodo).
3. Ejecutar request con curl -s y parsear con jq.
4. Entregar primero snapshot breve y luego tabla comparativa.
5. En comparaciones/rankings, priorizar orden por rendimiento y contexto de fechas.
6. Si el nombre del fondo tiene espacios, usar URL-encoding (por ejemplo 1810%20Ahorro).

Error Handling

• HTTP no exitoso:
  • Informar codigo y endpoint consultado.
• success: false:
  • Propagar error.message si existe.
• 404 o fondo no encontrado:
  • Dar mensaje claro y sugerir busqueda previa con GET /api/v1/fci.
• JSON inesperado:
  • Mostrar minimo crudo util y advertir inconsistencia.
• Red/timeout:
  • Reintentar hasta 2 veces con espera corta.

Presenting Results

• Formato recomendado:
  • Resumen ejecutivo primero (quien rindio mejor/peor en el periodo)
  • Tabla breve luego con columnas relevantes
• Incluir siempre marco temporal (fecha, desde/hasta, fechaFinal).
• No emitir asesoramiento financiero; solo informar datos.

Out of Scope

• Endpoints operativos de sync/status:
  • /api/v1/fci/sync/status
  • /api/v1/fci/sync/categories
  • POST /api/v1/fci/sync*
  • POST /api/v1/fci/detalle/sync
• Escritura o refresh de datos
• Recomendaciones de inversion

OpenAPI Spec

Ver snapshot local en references/openapi-spec.json.