API de fondos mutuos chilenos.
Valores cuota diarios, TAC, métricas de riesgo, carteras y estadísticas de administradoras, construidos a partir de la información pública de la CMF. Autenticación por header, respuestas JSON.
curl https://api.buscafondos.com/api/all-funds \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Los endpoints de datos requieren el header X-Api-Key. Solo /health es público.
Operaciones documentadas
33
en 31 rutas del snapshot
GET con API key
19
de 24 operaciones GET
Modelos publicados
15
schemas en components
Contrato
v1.0.0
OpenAPI 3.1.0
Qué se construye con la API
Los mismos endpoints sirven a quien programa un producto y a quien analiza fondos. Cada caso enlaza a las operaciones que usa.
Programadores y equipos de producto
Aplicaciones para inversionistas
Comparadores, alertas de precio, simuladores de ahorro y paneles de seguimiento con valores cuota diarios y variaciones del mercado.
/api/all-funds/api/real_assets/{asset_id}/days/api/market-summaryAnalistas y gestores de inversión
Análisis de carteras
Composición por tipo de instrumento, holdings ordenados por peso y métricas de riesgo de cada serie para revisar exposición y concentración.
/api/funds/{run}/cartera/resumen/api/funds/{run}/cartera/holdings/api/real_assets/{asset_id}/risk_metricsAsesores de inversión
Selección y comparación de fondos
TAC por serie y su historial mensual, benchmark comparable por familia y declaración del artículo 107 para justificar una recomendación.
/api/real_assets/{asset_id}/expense_ratio/api/benchmarks/api/funds/{run}/article107Investigación y reportes
Estudios de industria
Ranking y evolución mensual de patrimonio y partícipes por administradora, más los fondos que más cambiaron su TAC mes a mes.
/api/agf_stats/ranking/api/agf_stats/evolution/api/reports/tac-changes
Qué expone el contrato
Áreas y conteos se leen del snapshot OpenAPI versionado en el repositorio, el mismo del que se genera la referencia.
| Área | Descripción | Operaciones |
|---|---|---|
| API Key | Abre el registro gratuito, verifica tu email y guarda la key cuando aparezca. Después úsala en el header X-Api-Key. | 1 |
| Health | Estado del servicio y última fecha scrapeada. | 1 |
| Asset Providers | Administradoras Generales de Fondos (AGF). | 1 |
| Conceptual Assets | Fondos mutuos (identificados por RUN). | 1 |
| Real Assets | Series de fondos, valores cuota diarios, TAC y riesgo. | 5 |
| AGF Stats | Rankings y evolución de patrimonio/partícipes por administradora. | 2 |
| All Funds | Vista consolidada de todos los fondos del mercado con variaciones. | 1 |
| Market Summary | Resumen de mercado: familias AFM como índices y top movers, con outliers filtrados. | 2 |
| Cartera | Cartera de inversiones (holdings) por fondo. | 2 |
| Benchmarks | Benchmarks de mercado (ETF/índice) por familia comparable y sus precios crudos. | 2 |
| Article 107 | Declaración del reglamento vigente sobre el artículo 107 de la LIR. | 1 |
| Account | Cuenta mínima, Mis Fondos y preferencias de alertas TAC. | 13 |
| Reports | Sin descripción en el contrato. | 1 |
Cómo empezar
Registro, autenticación y manejo de cuota. Cada paso enlaza a su guía.
Obtén una key gratuita
El registro verifica tu email y muestra la key una sola vez. Guárdala en el gestor de secretos del servidor.
Emisión y consumoEnvía el header X-Api-Key
Es el único security scheme declarado en OpenAPI. Verifica la key con /api/key/info; esa llamada no descuenta cuota.
AutenticaciónLee la cuota en los headers
Cada respuesta informa límite, remanente y timestamp de reset. Reintenta 429 y 5xx respetando Retry-After.
Cuotas y errores
La referencia se genera desde el contrato OpenAPI del backend.
El portal versiona un snapshot de /openapi.json, lo valida en cada build y produce desde él la referencia y el playground. El build no depende de que la API esté disponible.