cafci-fondos-comunes-argentina
Original:🇺🇸 English
Translated
Consulta fondos comunes de inversion de Argentina (CAFCI) usando endpoints de lectura de Anduin. Usar cuando el usuario pida fondos por categoria, historico de un fondo, rendimiento por periodo, comparacion entre fondos, rankings de rendimiento, categorias, stats agregadas, fechas disponibles o ficha/detalle de un fondo.
10installs
Sourceferminrp/agent-skills
Added on
NPX Install
npx skill4agent add ferminrp/agent-skills cafci-fondos-comunes-argentinaTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →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 - (2-11)
categoria_id - (
horizonte,COR,MED,LAR)FLEX searchpatrimonio_min- ,
limitoffset - (
order_by,nombre,vcp,patrimonio)fecha - (
order,asc)desc
Ejemplos:
bash
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:
bash
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),mensuallimit
Ejemplo:
bash
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),1yfecha_base
Ejemplo:
bash
curl -s "https://anduin.ferminrp.com/api/v1/fci/1810%20Ahorro/rendimiento?periodo=30d" | jq '.'5) Comparar fondos
GET /api/v1/fci/comparar- Query:
- (requerido, coma-separado, max 10)
fondos - ,
desdehasta - (
metrica,vcp,patrimonio)rendimiento
Ejemplo:
bash
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,ordenlimit
Ejemplo:
bash
curl -s "https://anduin.ferminrp.com/api/v1/fci/rankings?periodo=30d&limit=10" | jq '.'7) Categorias
GET /api/v1/fci/categoriasGET /api/v1/fci/categorias/{id}
Ejemplos:
bash
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/statsGET /api/v1/fci/fechas
Ejemplos:
bash
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}- admite
identifiernumerico o nombre de fondo URL-encoded.claseId
Ejemplos:
bash
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:
successdatatimestamp
- Campos frecuentes de fondos:
- ,
fondoNombre,slug,categoriaId,categoriaNombre,horizonte,vcp,patrimoniofecha
- Historico:
- con
registros[],fecha,vcp,ccppatrimonio
- Rendimiento:
- ,
variacionPorcentual,variacionAbsoluta,vcpInicial,vcpFinal,fechaInicialfechaFinal
- Rankings:
- ,
posicion,fondoNombre,categoriaNombrerendimiento
- Ficha/detalle:
- clases, honorarios, cartera y rendimientos segun disponibilidad de origen
Workflow
- Detectar intencion del usuario:
- Listado
- Detalle
- Historico
- Rendimiento
- Comparacion
- Ranking
- Ficha
- Validar inputs minimos (,
nombre, fechas, periodo).fondos - Ejecutar request con y parsear con
curl -s.jq - Entregar primero snapshot breve y luego tabla comparativa.
- En comparaciones/rankings, priorizar orden por rendimiento y contexto de fechas.
- 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 si existe.
error.message
- Propagar
- 404 o fondo no encontrado:
- Dar mensaje claro y sugerir busqueda previa con .
GET /api/v1/fci
- Dar mensaje claro y sugerir busqueda previa con
- 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/categoriesPOST /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.