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. Incluye fondos de inversión y ETF con valores libro 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
41
en 39 rutas del snapshot
GET con API key
27
de 32 operaciones GET
Modelos publicados
48
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. Fondos de inversión y ETF suman valores libro CMF.
/api/all-funds/api/real_assets/{asset_id}/days/api/fi/instruments/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
Screener del universo publicado, comparación de hasta diez series en un mismo corte, rentabilidades por ventana, TAC y declaración del artículo 107 para justificar una recomendación.
/api/screener/api/compare/api/real_assets/{asset_id}/returns/api/real_assets/{asset_id}/expense_ratio/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. | 6 |
| Fund Returns | Comparación de rentabilidades y búsqueda de series del universo publicado, con filtros, paginación y esferas CMF. | 2 |
| 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 correo. | 13 |
| Investment Funds | Sin descripción en el contrato. | 5 |
| 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. El tier free permite 300 requests al día; para más, escribe a api@buscafondos.com.
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.