Referencia API
Generada desde el snapshot versionado de api.buscafondos.com/openapi.json (OpenAPI 3.1.0). Descripciones, parámetros y ejemplos se muestran tal como los declara el contrato; nada se completa a mano.
API Key
1. Obtén tu API key
Abre el registro gratuito, verifica tu email y guarda la key cuando aparezca. Después úsala en el header X-Api-Key.
/api/key/infoAPI key2. Verifica tu API key
Después de obtener tu API key, envíala en el header X-Api-Key para confirmar su tier, cuota y consumo del día.
curl "https://api.buscafondos.com/api/key/info" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Health
Estado del servicio y última fecha scrapeada.
/healthPúblicoHealth check
Retorna el estado del servicio, la última fecha scrapeada y el total de registros en la base de datos.
curl "https://api.buscafondos.com/health"Respuestas
Asset Providers
Administradoras Generales de Fondos (AGF).
/api/asset_providersAPI keyListar administradoras
Retorna todas las Administradoras Generales de Fondos (AGF) registradas.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
scope | query | string | nullall | Sin descripción. |
curl "https://api.buscafondos.com/api/asset_providers" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Conceptual Assets
Fondos mutuos (identificados por RUN).
/api/asset_providers/{provider_id}/conceptual_assetsAPI keyListar fondos de una administradora
Retorna todos los fondos mutuos vigentes de una administradora, incluyendo categoría y moneda.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
provider_idrequerido | path | integer | ID numérico de la administradora (CRC32) |
curl "https://api.buscafondos.com/api/asset_providers/{provider_id}/conceptual_assets" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Real Assets
Series de fondos, valores cuota diarios, TAC y riesgo.
/api/real_assets/{asset_id}/returnsAPI keyRentabilidades de una serie
Ocho ventanas en fracción decimal, con fechas y motivos de ausencia.
Moneda contable por defecto; CLP y real UF requieren habilitación explícita.
Total agrega factores y canjes verificados sólo en ventanas con cobertura.
FI/ETF acepta UUID y usa valores libro CMF (quota_source=cmf_valor_libro);
sin factores verificados sólo admite return_basis=price.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
asset_idrequerido | path | string | CRC32 de FM o UUID estable de FI/ETF |
as_of_date | query | string | null | Corte YYYY-MM-DD; sin fecha consulta el último lote publicado |
valuation | query | stringaccountingclpreal_uf | Base: moneda contable, CLP o real deflactada por UFPor defecto: accounting |
return_basis | query | stringpricetotal | Precio por defecto; total requiere factores/canjes verificados y habilitaciónPor defecto: price |
curl "https://api.buscafondos.com/api/real_assets/{asset_id}/returns" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/conceptual_assets/{concept_id}/real_assetsAPI keyListar series de un fondo
Retorna todas las series de un fondo mutuo con su último valor cuota, patrimonio y partícipes.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
concept_idrequerido | path | integer | ID numérico del fondo / conceptual asset (CRC32) |
curl "https://api.buscafondos.com/api/conceptual_assets/{concept_id}/real_assets" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/real_assets/{asset_id}/daysAPI keyValores cuota diarios de una serie
Historial de cuotas FM o valores libro CMF FI/ETF, filtrable por from_date.
Los ETF conservan id/type/attributes.date/attributes.price del contrato FM.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
asset_idrequerido | path | string | CRC32 de FM o UUID estable de FI/ETF |
from_date | query | string | Fecha inicio en formato YYYY-MM-DD |
curl "https://api.buscafondos.com/api/real_assets/{asset_id}/days" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/real_assets/{asset_id}/expense_ratioAPI keyTAC (expense ratio) de una serie
Retorna la Tasa Anual de Costos (TAC) de una serie como fracción decimal (ej: 1.32% → 0.0132).
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
asset_idrequerido | path | string | CRC32 de FM o UUID estable de FI/ETF |
curl "https://api.buscafondos.com/api/real_assets/{asset_id}/expense_ratio" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/real_assets/{asset_id}/risk_metricsAPI keyMetricas de riesgo de una serie
Retorna el ultimo snapshot de riesgo para una serie.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
asset_idrequerido | path | string | CRC32 de FM o UUID estable de FI/ETF |
curl "https://api.buscafondos.com/api/real_assets/{asset_id}/risk_metrics" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/real_assets/{asset_id}/expense_ratio/historyAPI keyHistorial mensual de TAC (expense ratio)
Retorna el historial mensual de TAC (Tasa Anual de Costos) para una serie.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
asset_idrequerido | path | string | CRC32 de FM o UUID estable de FI/ETF |
from_date | query | string | Fecha inicio en formato YYYYMMDD |
curl "https://api.buscafondos.com/api/real_assets/{asset_id}/expense_ratio/history" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Fund Returns
Comparación de rentabilidades y búsqueda de series del universo publicado, con filtros, paginación y esferas CMF.
/api/compareAPI keyComparar hasta diez series al corte publicado
Compara entre una y diez series del último lote publicado y conserva el orden solicitado. Entrega retornos de precio en moneda contable y escala decimal, datos del catálogo y esferas oficiales CMF. La comparabilidad de retornos por período y la de esferas se informan por separado, con motivos explícitos; las diferencias conservan los resultados individuales. No incluye historia diaria. El riesgo no equivale a rentabilidad ajustada por riesgo (RAR).
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
seriesrequerido | query | string | Entre uno y diez IDs decimales de serie separados por comas, únicos como enteros sin signo de 32 bits. Los ceros iniciales no distinguen IDs. Se conserva el orden solicitado. |
curl "https://api.buscafondos.com/api/compare?series=VALUE" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/screenerAPI keyBuscar y ordenar series del universo publicado
Filtra el último lote publicado y devuelve una página con catálogo, retornos de precio en moneda contable y esferas CMF. Ordenar retornos requiere currency; ordenar esferas requiere cmf_family y cmf_investor_type. Los valores no disponibles quedan al final en ambos sentidos; los empates se resuelven por ID numérico ascendente. Sin coincidencias devuelve una lista vacía y total=0. El paginado es estable dentro del mismo lote y revisión de insumos. No incluye metadatos de comparabilidad.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
q | query | string | null | Subcadena del nombre del fondo o RUN, sin distinguir mayúsculas. |
fund_family | query | string | null | Familia fundFamily del catálogo, igualdad sin distinguir mayúsculas. |
investor_class | query | string | null | Clase de inversionista vigente al corte; si falta, usa la clase TAC fechada. Igualdad sin distinguir mayúsculas. |
currency | query | string | null | Moneda contable: PESOS/CLP o DOLAR/USD, sin distinguir mayúsculas. Obligatoria para ordenar retornos. |
category | query | string | null | Categoría del catálogo, igualdad sin distinguir mayúsculas. |
administrator | query | string | null | Subcadena del nombre de la administradora, sin distinguir mayúsculas. |
cmf_spheres_min | query | integer | null | Mínimo inclusivo de esferas CMF (1 a 5); excluye valores no disponibles. No puede superar el máximo. |
cmf_spheres_max | query | integer | null | Máximo inclusivo de esferas CMF (1 a 5); excluye valores no disponibles. |
cmf_family | query | string | null | Familia oficial de esferas CMF, igualdad exacta y no vacía. Requerida para ordenar esferas. |
cmf_investor_type | query | string | null | Tipo de inversionista oficial de esferas CMF, igualdad exacta y no vacía. Requerido para ordenar esferas. |
sort | query | stringidtaccmf_spheres1m3m6m1yytd3y_ann5y_annlast_closed_month | Campo de orden. Los períodos de retorno requieren currency; cmf_spheres requiere ambos filtros de grupo oficial.Por defecto: id |
order | query | stringascdesc | Sentido del orden: ascendente o descendente. Los valores ausentes quedan al final.Por defecto: asc |
limit | query | integer | Número máximo de series por página, entre 1 y 200.Por defecto: 50 |
offset | query | integer | Número de series que se omiten después de filtrar y ordenar.Por defecto: 0 |
curl "https://api.buscafondos.com/api/screener" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
AGF Stats
Rankings y evolución de patrimonio/partícipes por administradora.
/api/agf_stats/rankingAPI keyRanking de administradoras
Retorna el ranking de administradoras ordenado por patrimonio o número de partícipes a la última fecha disponible.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
metric | query | string | Métrica de ordenamiento: `patrimony` (patrimonio) o `shareholders` (partícipes)Por defecto: patrimony |
date | query | string | null | Fecha específica (YYYY-MM-DD). Si no se envía, usa la más reciente. |
curl "https://api.buscafondos.com/api/agf_stats/ranking" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/agf_stats/evolutionAPI keyEvolución mensual de administradoras
Retorna la evolución mensual de patrimonio o partícipes para una o más administradoras, en formato pivotado para gráficos.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
administratorrequerido | query | array | Nombres de administradoras a comparar (repetir parámetro para múltiples) |
metric | query | string | Métrica a graficar: `patrimony` o `shareholders`Por defecto: patrimony |
from_month | query | string | null | Mes inicio en formato YYYY-MM |
to_month | query | string | null | Mes fin en formato YYYY-MM |
curl "https://api.buscafondos.com/api/agf_stats/evolution?administrator=VALUE" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
All Funds
Vista consolidada de todos los fondos del mercado con variaciones.
/api/all-fundsAPI keyListar todos los fondos del mercado con variaciones
FM by default; ETF and redeemable FI share CMF accounting quota fields.
all combines disjoint vehicles and preserves the FM metadata cutoff.
UUID series identities remain stable; unknown documentary data stays null.
All risk and catalog calculations are materialized offline.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
category | query | string | null | Filtrar por categoría (money_market, equity, etc.) |
fund_family | query | string | null | Filtrar por familia CMF/AFM (ej: Accionario eeuu) |
date | query | string | null | Fecha específica (YYYY-MM-DD). Si no se envía, usa la más reciente. |
article107_regulation_status | query | Article107RegulationStatus | nulldeclares_eligibledeclares_not_eligibleunknown | Filtrar por lo que declara el reglamento sobre el artículo 107 |
vehicle | query | stringmutual_fundetfinvestment_fundall | Vehículo: mutual_fund, etf, investment_fund (FI rescatable no ETF) o all.Por defecto: mutual_fund |
curl "https://api.buscafondos.com/api/all-funds" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Market Summary
Resumen de mercado: familias AFM como índices y top movers, con outliers filtrados.
/api/market-summaryAPI keyResumen de mercado: familias como índices y top movers
Vista compacta del mercado de fondos para el terminal: familias AFM
como índices (por moneda, ponderados por patrimonio de apertura) y
rankings de alzas/bajas, con outliers filtrados.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
date | query | string | null | Fecha específica (YYYY-MM-DD); fechas de calendario inválidas responden 422. Si no se envía, usa la más reciente. ATENCIÓN: una fecha histórica es un backtest sobre el universo de fondos vigentes HOY (sesgo de supervivencia: excluye fondos cerrados después de esa fecha). |
curl "https://api.buscafondos.com/api/market-summary" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/families/{family_rar}/indexAPI keyÍndice histórico de una familia AFM (base 100, por moneda)
Serie del índice precomputado de la familia. Si la familia no tiene
datos (o aún no corre el cron), devuelve data vacía con available=false.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
family_rarrequerido | path | string | Sin descripción. |
currency | query | string | null | Moneda contable del índice (PESOS, DOLAR). Default: la de mayor patrimonio. |
from_date | query | string | null | Fecha inicial inclusive (YYYY-MM-DD). |
curl "https://api.buscafondos.com/api/families/{family_rar}/index" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Cartera
Cartera de inversiones (holdings) por fondo.
/api/funds/{run}/cartera/resumenAPI keyResumen de cartera de un fondo
Resumen de cartera agrupado por tipo de instrumento, combinando holdings nacionales y extranjeros.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
runrequerido | path | string | Sin descripción. |
month | query | string | Mes en formato YYYY-MM (default: último disponible) |
curl "https://api.buscafondos.com/api/funds/{run}/cartera/resumen" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/funds/{run}/cartera/holdingsAPI keyHoldings individuales de un fondo
Lista de holdings individuales de un fondo, ordenados por peso en el activo.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
runrequerido | path | string | Sin descripción. |
month | query | string | Mes en formato YYYY-MM (default: último disponible) |
market | query | string | Filtro de mercado: N (nacional), E (extranjera), allPor defecto: all |
curl "https://api.buscafondos.com/api/funds/{run}/cartera/holdings" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Benchmarks
Benchmarks de mercado (ETF/índice) por familia comparable y sus precios crudos.
/api/benchmarksAPI keyCatálogo de benchmarks por familia
Catálogo de benchmarks activos (familia → símbolo, índice, moneda).
curl "https://api.buscafondos.com/api/benchmarks" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/benchmarks/{family_rar}/pricesAPI keySerie de precios cruda del benchmark de una familia
Serie cruda de precios del benchmark de una familia.
Devuelve precios crudos en moneda nativa (USD o CLP). El cálculo de retornos
y la conversión a USD/UF los hace el frontend. Si la familia no tiene
benchmark, devuelve data vacío con meta.has_benchmark = false.
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
family_rarrequerido | path | string | Sin descripción. |
from_date | query | string | Fecha inicial inclusive en formato YYYY-MM-DD |
curl "https://api.buscafondos.com/api/benchmarks/{family_rar}/prices" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Article 107
Declaración del reglamento vigente sobre el artículo 107 de la LIR.
/api/funds/{run}/article107API keyConsultar la declaración del reglamento sobre el artículo 107
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
runrequerido | path | string | Sin descripción. |
curl "https://api.buscafondos.com/api/funds/{run}/article107" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Account
Cuenta mínima, Mis Fondos y preferencias de correo.
/api/auth/magic-linkSin X-Api-KeyRequest Magic Link
Cuerpo del request
application/json requerido
{
"$ref": "#/components/schemas/MagicLinkRequest"
}curl -X POST "https://api.buscafondos.com/api/auth/magic-link" \
-H "Content-Type: application/json" \
-d 'JSON_BODY'Respuestas
/api/auth/googleSin X-Api-KeyStart Google Login
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
return_urlrequerido | query | string | Sin descripción. |
curl "https://api.buscafondos.com/api/auth/google?return_url=VALUE"Respuestas
/api/auth/google/callbackSin X-Api-KeyFinish Google Login
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
coderequerido | query | string | Sin descripción. |
staterequerido | query | string | Sin descripción. |
curl "https://api.buscafondos.com/api/auth/google/callback?code=VALUE&state=VALUE"Respuestas
/api/auth/callbackSin X-Api-KeyComplete Login
Cuerpo del request
application/json requerido
{
"$ref": "#/components/schemas/LoginCallbackRequest"
}curl -X POST "https://api.buscafondos.com/api/auth/callback" \
-H "Content-Type: application/json" \
-d 'JSON_BODY'Respuestas
/api/auth/logoutSin X-Api-KeyLogout
curl -X POST "https://api.buscafondos.com/api/auth/logout"Respuestas
/api/meSin X-Api-KeyGet Me
curl "https://api.buscafondos.com/api/me"Respuestas
/api/meSin X-Api-KeyRemove Account
curl -X DELETE "https://api.buscafondos.com/api/me"Respuestas
/api/me/watchlistSin X-Api-KeyGet Watchlist
curl "https://api.buscafondos.com/api/me/watchlist"Respuestas
/api/me/watchlistSin X-Api-KeyAdd To Watchlist
Cuerpo del request
application/json requerido
{
"$ref": "#/components/schemas/WatchlistRequest"
}curl -X POST "https://api.buscafondos.com/api/me/watchlist" \
-H "Content-Type: application/json" \
-d 'JSON_BODY'Respuestas
/api/me/watchlist/{serie_id}Sin X-Api-KeyRemove From Watchlist
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
serie_idrequerido | path | string | Sin descripción. |
curl -X DELETE "https://api.buscafondos.com/api/me/watchlist/{serie_id}"Respuestas
/api/me/alertsSin X-Api-KeyUpdate Alert Preferences
Cuerpo del request
application/json requerido
{
"$ref": "#/components/schemas/AlertPreferenceRequest"
}curl -X PATCH "https://api.buscafondos.com/api/me/alerts" \
-H "Content-Type: application/json" \
-d 'JSON_BODY'Respuestas
/api/alerts/unsubscribeSin X-Api-KeyUnsubscribe
Cuerpo del request
application/json requerido
{
"$ref": "#/components/schemas/UnsubscribeRequest"
}curl -X POST "https://api.buscafondos.com/api/alerts/unsubscribe" \
-H "Content-Type: application/json" \
-d 'JSON_BODY'Respuestas
/api/alerts/unsubscribe/one-clickSin X-Api-KeyOne Click Unsubscribe
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
tokenrequerido | query | string | Sin descripción. |
curl -X POST "https://api.buscafondos.com/api/alerts/unsubscribe/one-click?token=VALUE"Respuestas
Investment Funds
/api/fi/instrumentsAPI keyInstruments
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
provider_id | query | integer | null | Sin descripción. |
is_etf | query | boolean | null | Sin descripción. |
regulatory_type | query | string | nullFIRESFINRE | Sin descripción. |
status | query | stringactiveinactiveunknownall | Sin descripción.Por defecto: active |
q | query | string | null | Sin descripción. |
limit | query | integer | Sin descripción.Por defecto: 100 |
offset | query | integer | Sin descripción.Por defecto: 0 |
curl "https://api.buscafondos.com/api/fi/instruments" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/fi/instruments/{instrument_id}API keyInstrument
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
instrument_idrequerido | path | string | Sin descripción. |
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/fi/instruments/{instrument_id}/pricesAPI keyPrices
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
instrument_idrequerido | path | string | Sin descripción. |
from_date | query | string | null | Sin descripción. |
to_date | query | string | null | Sin descripción. |
limit | query | integer | Sin descripción.Por defecto: 1000 |
offset | query | integer | Sin descripción.Por defecto: 0 |
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}/prices" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/fi/instruments/{instrument_id}/cartera/holdingsAPI keyCartera Holdings
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
instrument_idrequerido | path | string | Sin descripción. |
month | query | string | null | Sin descripción. |
market | query | stringNEall | Sin descripción.Por defecto: all |
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}/cartera/holdings" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
/api/fi/instruments/{instrument_id}/cartera/resumenAPI keyCartera Resumen
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
instrument_idrequerido | path | string | Sin descripción. |
month | query | string | null | Sin descripción. |
market | query | stringNEall | Sin descripción.Por defecto: all |
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}/cartera/resumen" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Reports
/api/reports/tac-changesAPI keyRanking de fondos que mas variaron su TAC (expense ratio) mes a mes
Compara el TAC real (expense ratio) de cada serie entre el mes solicitado y
el mes anterior y devuelve el ranking ya armado, deduplicado a una serie por
fondo (la de mayor variacion en la direccion pedida).
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
date | query | string | null | Fecha del mes calendario cerrado (YYYY-MM-DD). Si no se envia, usa el ultimo mes con TAC. |
direction | query | string | up = mayores alzas de TAC; down = mayores bajas.Por defecto: up |
limit | query | integer | Cantidad de fondos a devolver.Por defecto: 15 |
category | query | string | null | Filtrar por categoria (money_market, equity, etc.). |
curl "https://api.buscafondos.com/api/reports/tac-changes" \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"Respuestas
Modelos
Schemas publicados en el snapshot OpenAPI.