Loading...
Loading...
Compare original and translation side by side
api.pub.cafci.org.ar/tipo-renta/fondo/{id}/estadisticas/.../pb_get/consulta-de-fondos.json/pb_getdefuddle.md/.../fondos/{F}?clase={C}.../fondos/{F}?clase={C}api.pub.cafci.org.ar/tipo-renta/fondo/{id}/estadisticas/.../pb_get/consulta-de-fondos.json/pb_getdefuddle.md/.../fondos/{F}?clase={C}.../fondos/{F}?clase={C}| Script | Descripcion |
|---|---|
| fetch_cafci.py | Script principal: todos los endpoints + funciones de consulta |
pip install openpyxl| 脚本 | 描述 |
|---|---|
| fetch_cafci.py | 主脚本:包含所有端点调用及查询功能 |
pip install openpyxlundefinedundefined
---
---| Modo | Data | URL |
|---|---|---|
| Catalogo: 1152 fondos, 4615 clases, IDs, honorarios, metadata | |
| Snapshot diario: VCP, patrimonio, market share, variaciones | |
| Ficha markdown: rendimientos TNA por periodo | |
| Composicion de cartera (top activos + %) | |
| Buscar fondos por nombre parcial | (local, sobre catalogo) |
| Resolver fondoId/claseId desde nombre | (local, sobre catalogo) |
| Top N por patrimonio en una categoria | (local, sobre diario) |
| Ficha completa todo-en-uno (combina los 4 endpoints) | (local + 4 requests) |
| Snapshot catalogo + diario | (local + 2 requests) |
| 模式 | 数据内容 | URL |
|---|---|---|
| 完整目录:1152只基金、4615个份额类别,包含ID、费用、元数据 | |
| 每日快照:VCP、资产规模、市场份额、涨跌幅 | |
| Markdown详情页:各时间段TNA收益率 | |
| 投资组合构成(顶级资产 + 占比) | |
| 根据基金名称模糊搜索 | (本地,基于目录缓存) |
| 通过基金名称解析fondoId/claseId | (本地,基于目录缓存) |
| 按类别查询资产规模Top N的基金 | (本地,基于每日快照缓存) |
| 完整基金详情(整合4个端点数据) | (本地缓存 + 4次请求) |
| 目录+每日快照组合快照 | (本地缓存 + 2次请求) |
$TMP/cafci-catalog-YYYY-MM-DD.json (~2.7 MB)
$TMP/cafci-daily-YYYY-MM-DD.json (~1-2 MB)C:\Users\<user>\AppData\Local\Temp\/tmp/--no-cache$TMP/cafci-catalog-YYYY-MM-DD.json (~2.7 MB)
$TMP/cafci-daily-YYYY-MM-DD.json (~1-2 MB)C:\Users\<user>\AppData\Local\Temp\/tmp/--no-cache| Tipo | Cantidad fondos |
|---|---|
| Renta Fija | 542 |
| Renta Mixta | 271 |
| Mercado de Dinero | 96 |
| Renta Variable | 76 |
| PyMes | 65 |
| Retorno Total | 42 |
| Infraestructura | 23 |
| Fondos Cerrados | 22 |
| ASG | 10 |
| RG900 | 5 |
| 类型 | 基金数量 |
|---|---|
| 固定收益 | 542 |
| 混合类 | 271 |
| 货币市场 | 96 |
| 权益类 | 76 |
| 中小企业 | 65 |
| 总回报 | 42 |
| 基础设施 | 23 |
| 封闭式基金 | 22 |
| ASG | 10 |
| RG900 | 5 |
toptoptipo_renta + moneda + region| Categoria | Cobertura |
|---|---|
| Acciones argentinas |
| Money Market $ |
| Bonos $ |
| Bonos USD argentinos |
| Fondos mixtos $ |
| Total return $ |
Para ver lista completa:py scripts/fetch_cafci.py diario -q | jq '.categorias'
收益类型 + 货币 + 地区| 类别 | 覆盖范围 |
|---|---|
| 阿根廷本土股票 |
| 阿根廷比索货币市场 |
| 阿根廷比索债券 |
| 阿根廷美元计价债券 |
| 阿根廷比索混合类基金 |
| 阿根廷比索总回报类基金 |
查看完整类别列表:py scripts/fetch_cafci.py diario -q | jq '.categorias'
catalogocatalogo| Campo | Descripcion |
|---|---|
| Timestamp ISO del catalogo. |
| Contadores. |
| Catalogos de enums: |
| Array de fondos. |
fondos[]clases[]⚠️son strings (no floats). Castear conhonorarios.*antes de comparar.float()
| 字段 | 描述 |
|---|---|
| 目录生成的ISO时间戳。 |
| 统计数量。 |
| 枚举目录: |
| 基金数组。 |
fondos[]clases[]⚠️字段为字符串类型(非浮点数)。比较前需用honorarios.*转换类型。float()
diariodiario{
"fecha_reporte": "2026-06-04",
"categorias": ["Renta Variable Peso Argentina", ...],
"fondos": [
{
"nombre": "Allaria Equity Selection - Clase A",
"categoria": "Renta Variable Peso Argentina",
"moneda": "ARS",
"region": "Arg",
"horizonte": "Cor",
"fecha": "2026-06-04",
"vcp_actual": 1642.85,
"vcp_anterior": 1628.345,
"variacion_dia_pct": 0.891,
"vcp_reexp_pesos": 1642.85,
"variacion_mes_pct": -1.181,
"variacion_ytd_pct": 11.939,
"variacion_12m_pct": 61.542,
"cantidad_cuotapartes": 1276470413.29,
"patrimonio": 2097049572.01,
"market_share": 0.107,
"depositaria": "Banco Comafi S.A.",
"codigo_cnv": "1603"
}
]
}{
"fecha_reporte": "2026-06-04",
"categorias": ["Renta Variable Peso Argentina", ...],
"fondos": [
{
"nombre": "Allaria Equity Selection - Clase A",
"categoria": "Renta Variable Peso Argentina",
"moneda": "ARS",
"region": "Arg",
"horizonte": "Cor",
"fecha": "2026-06-04",
"vcp_actual": 1642.85,
"vcp_anterior": 1628.345,
"variacion_dia_pct": 0.891,
"vcp_reexp_pesos": 1642.85,
"variacion_mes_pct": -1.181,
"variacion_ytd_pct": 11.939,
"variacion_12m_pct": 61.542,
"cantidad_cuotapartes": 1276470413.29,
"patrimonio": 2097049572.01,
"market_share": 0.107,
"depositaria": "Banco Comafi S.A.",
"codigo_cnv": "1603"
}
]
}carteracartera{
"fondo_id": 304,
"clase_id": 308,
"fecha_cartera": "15/05/2026",
"composicion": [
{"nombre": "Cta Cte $ Rem Bco Credico", "porcentaje": 17.4},
{"nombre": "Pzo Fi $ Bco Nacion", "porcentaje": 14.8},
...
{"nombre": "Resto de Activos", "porcentaje": 29.2}
]
}CAFCI publica solo los top ~14 activos +agrupado. La fecha de cartera tiene delay de ~2-3 semanas vs el diario."Resto de Activos"
{
"fondo_id": 304,
"clase_id": 308,
"fecha_cartera": "15/05/2026",
"composicion": [
{"nombre": "Cta Cte $ Rem Bco Credico", "porcentaje": 17.4},
{"nombre": "Pzo Fi $ Bco Nacion", "porcentaje": 14.8},
...
{"nombre": "Resto de Activos", "porcentaje": 29.2}
]
}CAFCI仅公布前14左右的顶级资产 + 合并后的(其他资产)。 投资组合的日期比每日快照延迟约2-3周。"Resto de Activos"
fondofondo{
"meta": { ...del catalogo... },
"diario": { ...del XLSX... },
"ficha_md": "...markdown defuddle...",
"cartera": { ...composicion... }
}{
"meta": { ...del catalogo... },
"diario": { ...del XLSX... },
"ficha_md": "...markdown defuddle...",
"cartera": { ...composicion... }
}top "<categoria>" --limit Nnombreresolvefondo_id, clase_idcatalogoclases[].nombreresolve "<query>"fondo FONDO_ID CLASE_IDbuscarresolvetop "<类别>" --limit Nresolvefondo_id, clase_idcatalogoclases[].nombreresolve "<查询关键词>"fondo FONDO_ID CLASE_IDbuscarresolve| Flag | Descripcion |
|---|---|
| Cantidad de resultados ( |
| Forzar refetch de catalogo/diario (ignorar cache local) |
| Guardar output a archivo JSON o markdown |
| Modo silencioso (solo JSON/markdown, sin logs) |
| 参数 | 描述 |
|---|---|
| 设置返回结果数量(仅 |
| 强制重新获取目录/每日快照数据(忽略本地缓存) |
| 将输出保存为JSON或Markdown文件 |
| 静默模式(仅输出JSON/Markdown,不显示日志) |
defuddle.mddefuddle.md| Status | Causas tipicas |
|---|---|
| 200 | OK |
403 | Path discontinuado de la API REST anterior |
403 (en | Faltan headers de browser (Origin, Referer) — el script ya los envia |
| 404 | URL mal formada o IDs inexistentes |
Timeout en | Proxy externo lento — reintentar |
| 状态码 | 常见原因 |
|---|---|
| 200 | 请求成功 |
403 | 旧版REST API的路径已停用 |
403(针对 | 缺少浏览器请求头(Origin、Referer)——脚本已自动添加这些头 |
| 404 | URL格式错误或ID不存在 |
| 外部代理响应缓慢——请重试 |
?ensure_ascii=False?ensure_ascii=Falseskills/cafci/
├── SKILL.md # Este archivo (guia rapida)
├── references/
│ └── REFERENCE.md # Documentacion completa de los 4 endpoints + cache
└── scripts/
└── fetch_cafci.py # Script principalDocumentacion detallada: Consultar references/REFERENCE.md para schemas JSON completos, tablas de campos exhaustivas, codigos de tipo_renta/region/horizonte/moneda, cache local, manejo de errores y consideraciones tecnicas.
Inspirado en: ferminrp/agent-skills/cafci-fondos-comunes-argentina — esta implementacion porta el mismo diseño de 4 fuentes a la arquitectura SKILL.md / references/REFERENCE.md / scripts/fetch_*.py del repo.
skills/cafci/
├── SKILL.md # 本文件(快速指南)
├── references/
│ └── REFERENCE.md # 4个端点及缓存的完整文档
└── scripts/
└── fetch_cafci.py # 主脚本详细文档: 请查看references/REFERENCE.md,获取完整JSON Schema、详尽字段表、收益类型/地区/投资期限/货币代码、本地缓存说明、错误处理及技术细节。
灵感来源: ferminrp/agent-skills/cafci-fondos-comunes-argentina — 本实现将原有的4数据源设计移植到了本仓库的SKILL.md / references/REFERENCE.md / scripts/fetch_*.py架构中。