cafci-fondos-comunes-argentina

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CAFCI Fondos Comunes Argentina

CAFCI 阿根廷共同投资基金

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

使用Anduin的只读端点为终端用户查询共同投资基金（FCI）数据。

API Overview

API 概述

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

基础URL：
```
https://anduin.ferminrp.com
```
身份验证：无需验证
响应格式：JSON
文档来源：
```
https://anduin.ferminrp.com/docs
```

Endpoints de Lectura

只读端点列表

1) Fondos (listado)

1) 基金列表

```
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:

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'

```
GET /api/v1/fci
```
筛选参数：
- ```
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
```
  ）

示例：

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

2) 单支基金详情

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

Ejemplo:

bash

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

```
GET /api/v1/fci/{nombre}
```
可选查询参数：
```
fecha
```

示例：

bash

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

3) Historico de fondo

3) 基金历史数据

```
GET /api/v1/fci/{nombre}/historico
```

Query opcionales:

desde

hasta

intervalo

(

diario

semanal

mensual

limit

Ejemplo:

bash

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

```
GET /api/v1/fci/{nombre}/historico
```

可选查询参数：

desde

hasta

intervalo

（频率：

diario

semanal

mensual

）,

limit

示例：

bash

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

4) Rendimiento de fondo

4) 基金收益数据

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

Ejemplo:

bash

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

```
GET /api/v1/fci/{nombre}/rendimiento
```
可选查询参数：
```
periodo
```
（周期：
```
1d
```
,
```
7d
```
,
```
30d
```
,
```
90d
```
,
```
ytd
```
,
```
1y
```
）,
```
fecha_base
```

示例：

bash

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

5) Comparar fondos

5) 基金对比

```
GET /api/v1/fci/comparar
```

Query:

```
fondos
```
(requerido, coma-separado, max 10)
```
desde
```
,
```
hasta
```
```
metrica
```
(
```
vcp
```
,
```
patrimonio
```
,
```
rendimiento
```
)

Ejemplo:

bash

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

```
GET /api/v1/fci/comparar
```
必要查询参数：
- ```
fondos
```
  （必填，逗号分隔，最多10支）

可选查询参数：

desde

hasta

metrica

（指标：

vcp

patrimonio

rendimiento

）

示例：

bash

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

6) Rankings

6) 收益排名

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

Ejemplo:

bash

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

```
GET /api/v1/fci/rankings
```
常用查询参数：
```
periodo
```
,
```
categoria_id
```
,
```
orden
```
,
```
limit
```

示例：

bash

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

7) Categorias

7) 基金类别

```
GET /api/v1/fci/categorias
```
```
GET /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 '.'

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

示例：

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

8) 统计数据与可用日期

```
GET /api/v1/fci/stats
```
```
GET /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 '.'

```
GET /api/v1/fci/stats
```
```
GET /api/v1/fci/fechas
```

示例：

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

9) 基金完整详情页

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

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 '.'

```
GET /api/v1/fci/detalle/{identifier}
```
```
identifier
```
支持数字类型的
```
claseId
```
或URL编码后的基金名称。

示例：

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:
- ```
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

通用响应结构：
- ```
success
```
  （请求状态）
- ```
data
```
  （返回数据）
- ```
timestamp
```
  （时间戳）

基金常用字段：

fondoNombre

slug

categoriaId

categoriaNombre

horizonte

vcp

patrimonio

fecha

历史数据字段：
- ```
registros[]
```
  数组，包含
```
fecha
```
  ,
```
vcp
```
  ,
```
ccp
```
  ,
```
patrimonio
```

收益数据字段：

variacionPorcentual

variacionAbsoluta

vcpInicial

vcpFinal

fechaInicial

fechaFinal

排名数据字段：

posicion

fondoNombre

categoriaNombre

rendimiento

完整详情页字段：
- 基金类别、费率、投资组合及收益数据（取决于源数据可用性）

Workflow

工作流程

Detectar intencion del usuario:
- Listado
- Detalle
- Historico
- Rendimiento
- Comparacion
- Ranking
- Ficha
Validar inputs minimos (
```
nombre
```
,
```
fondos
```
, fechas, periodo).
Ejecutar request con
```
curl -s
```
y parsear con
```
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
```
).

识别用户意图：
- 列表查询
- 单支基金详情
- 历史数据
- 收益数据
- 基金对比
- 排名查询
- 完整详情页
验证必要输入参数（如
```
nombre
```
,
```
fondos
```
, 日期, 周期）。
使用
```
curl -s
```
发起请求并通过
```
jq
```
解析结果。
先返回简短快照，再展示对比表格。
在基金对比/排名场景中，优先按收益排序并标注日期上下文。
若基金名称包含空格，需使用URL编码（例如
```
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.

HTTP请求失败：
- 告知用户错误代码及所请求的端点。
success: false
：
- 若存在
```
error.message
```
  则直接返回该信息。
404或基金未找到：
- 返回清晰提示，并建议先通过
```
GET /api/v1/fci
```
  进行搜索。
非预期JSON格式：
- 返回最少量的原始可用数据，并提示数据格式异常。
网络/超时错误：
- 最多重试2次，每次间隔短时间。

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.

推荐格式：
- 先展示执行摘要（如周期内表现最佳/最差的基金）
- 再展示包含相关列的简洁表格
始终包含时间范围（
```
fecha
```
,
```
desde/hasta
```
,
```
fechaFinal
```
）。
不提供投资建议；仅展示数据。

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

同步/状态类操作端点：

```
/api/v1/fci/sync/status
```
```
/api/v1/fci/sync/categories
```
```
POST /api/v1/fci/sync*
```
```
POST /api/v1/fci/detalle/sync
```

数据写入或刷新操作
投资建议

OpenAPI Spec

OpenAPI 规范

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

查看本地快照文件 references/openapi-spec.json。