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.

GET/api/key/infoAPI key

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

curl "https://api.buscafondos.com/api/key/info" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

Health

Estado del servicio y última fecha scrapeada.

GET/healthPúblico

Health check

Retorna el estado del servicio, la última fecha scrapeada y el total de registros en la base de datos.

curl

curl "https://api.buscafondos.com/health"

Respuestas

Asset Providers

Administradoras Generales de Fondos (AGF).

GET/api/asset_providersAPI key

Listar administradoras

Retorna todas las Administradoras Generales de Fondos (AGF) registradas.

curl

curl "https://api.buscafondos.com/api/asset_providers" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

Conceptual Assets

Fondos mutuos (identificados por RUN).

GET/api/asset_providers/{provider_id}/conceptual_assetsAPI key

Listar 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_id`requerido	path	`integer`	ID numérico de la administradora (CRC32)

curl

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.

GET/api/conceptual_assets/{concept_id}/real_assetsAPI key

Listar 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_id`requerido	path	`integer`	ID numérico del fondo / conceptual asset (CRC32)

curl

curl "https://api.buscafondos.com/api/conceptual_assets/{concept_id}/real_assets" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/real_assets/{asset_id}/daysAPI key

Valores cuota diarios de una serie

Retorna el historial de valores cuota diarios para una serie, opcionalmente filtrado desde una fecha.

Parámetros

Nombre	Ubicación	Tipo	Descripción
`asset_id`requerido	path	`integer`	ID numérico de la serie / real asset (CRC32)
`from_date`	query	`string`	Fecha inicio en formato YYYY-MM-DD

curl

curl "https://api.buscafondos.com/api/real_assets/{asset_id}/days" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/real_assets/{asset_id}/expense_ratioAPI key

TAC (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_id`requerido	path	`integer`	ID numérico de la serie / real asset (CRC32)

curl

curl "https://api.buscafondos.com/api/real_assets/{asset_id}/expense_ratio" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/real_assets/{asset_id}/risk_metricsAPI key

Metricas de riesgo de una serie

Retorna el ultimo snapshot de riesgo para una serie.

Parámetros

Nombre	Ubicación	Tipo	Descripción
`asset_id`requerido	path	`integer`	ID numerico de la serie / real asset (CRC32)

curl

curl "https://api.buscafondos.com/api/real_assets/{asset_id}/risk_metrics" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/real_assets/{asset_id}/expense_ratio/historyAPI key

Historial 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_id`requerido	path	`integer`	ID numérico de la serie / real asset (CRC32)
`from_date`	query	`string`	Fecha inicio en formato YYYYMMDD

curl

curl "https://api.buscafondos.com/api/real_assets/{asset_id}/expense_ratio/history" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

AGF Stats

Rankings y evolución de patrimonio/partícipes por administradora.

GET/api/agf_stats/rankingAPI key

Ranking 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)
`date`	query	`sin tipo`	Fecha específica (YYYY-MM-DD). Si no se envía, usa la más reciente.

curl

curl "https://api.buscafondos.com/api/agf_stats/ranking" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/agf_stats/evolutionAPI key

Evolució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
`administrator`requerido	query	`array`	Nombres de administradoras a comparar (repetir parámetro para múltiples)
`metric`	query	`string`	Métrica a graficar: `patrimony` o `shareholders`
`from_month`	query	`sin tipo`	Mes inicio en formato YYYY-MM
`to_month`	query	`sin tipo`	Mes fin en formato YYYY-MM

curl

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.

GET/api/all-fundsAPI key

Listar todos los fondos del mercado con variaciones

Retorna todos los fondos vigentes del mercado con variaciones de precio diaria y mensual.

Parámetros

Nombre	Ubicación	Tipo	Descripción
`category`	query	`sin tipo`	Filtrar por categoría (money_market, equity, etc.)
`fund_family`	query	`sin tipo`	Filtrar por familia CMF/AFM (ej: Accionario eeuu)
`date`	query	`sin tipo`	Fecha específica (YYYY-MM-DD). Si no se envía, usa la más reciente.
`article107_regulation_status`	query	`sin tipo`	Filtrar por lo que declara el reglamento sobre el artículo 107

curl

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.

GET/api/market-summaryAPI key

Resumen 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	`sin tipo`	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

curl "https://api.buscafondos.com/api/market-summary" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/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_rar`requerido	path	`string`	Sin descripción.
`currency`	query	`sin tipo`	Moneda contable del índice (PESOS, DOLAR). Default: la de mayor patrimonio.
`from_date`	query	`sin tipo`	Fecha inicial inclusive (YYYY-MM-DD).

curl

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.

GET/api/funds/{run}/cartera/resumenAPI key

Resumen 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
`run`requerido	path	`string`	Sin descripción.
`month`	query	`string`	Mes en formato YYYY-MM (default: último disponible)

curl

curl "https://api.buscafondos.com/api/funds/{run}/cartera/resumen" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/funds/{run}/cartera/holdingsAPI key

Holdings 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
`run`requerido	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), all

curl

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.

GET/api/benchmarksAPI key

Catálogo de benchmarks por familia

Catálogo de benchmarks activos (familia → símbolo, índice, moneda).

curl

curl "https://api.buscafondos.com/api/benchmarks" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/benchmarks/{family_rar}/pricesAPI key

Serie 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_rar`requerido	path	`string`	Sin descripción.
`from_date`	query	`string`	Fecha inicial inclusive en formato YYYY-MM-DD

curl

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.

GET/api/funds/{run}/article107API key

Consultar la declaración del reglamento sobre el artículo 107

Parámetros

Nombre	Ubicación	Tipo	Descripción
`run`requerido	path	`string`	Sin descripción.

curl

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 alertas TAC.

POST/api/auth/magic-linkSin X-Api-Key

Request Magic Link

Cuerpo del request

application/json requerido

Schema

{
  "$ref": "#/components/schemas/MagicLinkRequest"
}

curl

curl -X POST "https://api.buscafondos.com/api/auth/magic-link" \
  -H "Content-Type: application/json" \
  -d 'JSON_BODY'

Respuestas

GET/api/auth/googleSin X-Api-Key

Start Google Login

Parámetros

Nombre	Ubicación	Tipo	Descripción
`return_url`requerido	query	`string`	Sin descripción.

curl

curl "https://api.buscafondos.com/api/auth/google?return_url=VALUE"

Respuestas

GET/api/auth/google/callbackSin X-Api-Key

Finish Google Login

Parámetros

Nombre	Ubicación	Tipo	Descripción
`code`requerido	query	`string`	Sin descripción.
`state`requerido	query	`string`	Sin descripción.

curl

curl "https://api.buscafondos.com/api/auth/google/callback?code=VALUE&state=VALUE"

Respuestas

POST/api/auth/callbackSin X-Api-Key

Complete Login

Cuerpo del request

application/json requerido

Schema

{
  "$ref": "#/components/schemas/LoginCallbackRequest"
}

curl

curl -X POST "https://api.buscafondos.com/api/auth/callback" \
  -H "Content-Type: application/json" \
  -d 'JSON_BODY'

Respuestas

POST/api/auth/logoutSin X-Api-Key

Logout

curl

curl -X POST "https://api.buscafondos.com/api/auth/logout"

Respuestas

GET/api/meSin X-Api-Key

Get Me

curl

curl "https://api.buscafondos.com/api/me"

Respuestas

DELETE/api/meSin X-Api-Key

Remove Account

curl

curl -X DELETE "https://api.buscafondos.com/api/me"

Respuestas

GET/api/me/watchlistSin X-Api-Key

Get Watchlist

curl

curl "https://api.buscafondos.com/api/me/watchlist"

Respuestas

POST/api/me/watchlistSin X-Api-Key

Add To Watchlist

Cuerpo del request

application/json requerido

Schema

{
  "$ref": "#/components/schemas/WatchlistRequest"
}

curl

curl -X POST "https://api.buscafondos.com/api/me/watchlist" \
  -H "Content-Type: application/json" \
  -d 'JSON_BODY'

Respuestas

DELETE/api/me/watchlist/{serie_id}Sin X-Api-Key

Remove From Watchlist

Parámetros

Nombre	Ubicación	Tipo	Descripción
`serie_id`requerido	path	`string`	Sin descripción.

curl

curl -X DELETE "https://api.buscafondos.com/api/me/watchlist/{serie_id}"

Respuestas

PATCH/api/me/alertsSin X-Api-Key

Update Alert Preferences

Cuerpo del request

application/json requerido

Schema

{
  "$ref": "#/components/schemas/AlertPreferenceRequest"
}

curl

curl -X PATCH "https://api.buscafondos.com/api/me/alerts" \
  -H "Content-Type: application/json" \
  -d 'JSON_BODY'

Respuestas

POST/api/alerts/unsubscribeSin X-Api-Key

Unsubscribe

Cuerpo del request

application/json requerido

Schema

{
  "$ref": "#/components/schemas/UnsubscribeRequest"
}

curl

curl -X POST "https://api.buscafondos.com/api/alerts/unsubscribe" \
  -H "Content-Type: application/json" \
  -d 'JSON_BODY'

Respuestas

POST/api/alerts/unsubscribe/one-clickSin X-Api-Key

One Click Unsubscribe

Parámetros

Nombre	Ubicación	Tipo	Descripción
`token`requerido	query	`string`	Sin descripción.

curl

curl -X POST "https://api.buscafondos.com/api/alerts/unsubscribe/one-click?token=VALUE"

Respuestas

Reports

GET/api/reports/tac-changesAPI key

Ranking 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	`sin tipo`	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.
`limit`	query	`integer`	Cantidad de fondos a devolver.
`category`	query	`sin tipo`	Filtrar por categoria (money_market, equity, etc.).

curl

curl "https://api.buscafondos.com/api/reports/tac-changes" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

Modelos

Schemas publicados en el snapshot OpenAPI.

Referencia API

2. Verifica tu API key

Respuestas

200 Successful Response

Health check

Respuestas

200 Estado del servicio

Listar administradoras

Respuestas

200 Lista de administradoras en formato JSON:API

Listar fondos de una administradora

Parámetros

Respuestas

200 Lista de fondos mutuos en formato JSON:API

404 Administradora no encontrada

422 Validation Error

Listar series de un fondo

Parámetros

Respuestas

200 Lista de series con último valor cuota

404 Fondo (conceptual asset) no encontrado

422 Validation Error

Valores cuota diarios de una serie

Parámetros

Respuestas

200 Serie temporal de valores cuota

404 Serie (real asset) no encontrada

422 Validation Error

TAC (expense ratio) de una serie

Parámetros

Respuestas

200 Tasa Anual de Costos como fracción decimal

404 Serie (real asset) no encontrada

422 Validation Error

Metricas de riesgo de una serie

Parámetros

Respuestas

200 Ultimo snapshot de riesgo materializado para la serie

404 Serie (real asset) no encontrada

422 Validation Error

Historial mensual de TAC (expense ratio)

Parámetros

Respuestas

200 Serie temporal mensual de TAC

404 Serie (real asset) no encontrada

422 Validation Error

Ranking de administradoras

Parámetros

Respuestas

200 Ranking ordenado por métrica seleccionada

422 Validation Error

Evolución mensual de administradoras

Parámetros

Respuestas

200 Serie temporal mensual pivotada por administradora (formato Recharts)

422 Validation Error

Listar todos los fondos del mercado con variaciones

Parámetros

Respuestas

200 Lista de todos los fondos vigentes con variaciones diaria y mensual

422 Validation Error

Resumen de mercado: familias como índices y top movers

Parámetros

Respuestas

200 Índices por familia AFM (variación ponderada por patrimonio de apertura, por moneda) y series con mayores alzas/bajas diarias y mensuales.

422 Validation Error

Índice histórico de una familia AFM (base 100, por moneda)

Parámetros

Respuestas

200 Serie encadenada del índice de la familia

422 Validation Error

Resumen de cartera de un fondo

Parámetros

Respuestas

200 Resumen agrupado por tipo de instrumento

422 Validation Error

Holdings individuales de un fondo

Parámetros

Respuestas

200 Lista de instrumentos en cartera