Documentación

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.

Parámetros

NombreUbicaciónTipoDescripción
scopequerystring | nullallSin descripción.
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

NombreUbicaciónTipoDescripción
provider_idrequeridopathintegerID 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/real_assets/{asset_id}/returnsAPI key

Rentabilidades 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

NombreUbicaciónTipoDescripción
asset_idrequeridopathstringCRC32 de FM o UUID estable de FI/ETF
as_of_datequerystring | nullCorte YYYY-MM-DD; sin fecha consulta el último lote publicado
valuationquerystringaccountingclpreal_ufBase: moneda contable, CLP o real deflactada por UFPor defecto: accounting
return_basisquerystringpricetotalPrecio por defecto; total requiere factores/canjes verificados y habilitaciónPor defecto: price
curl
curl "https://api.buscafondos.com/api/real_assets/{asset_id}/returns" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

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

NombreUbicaciónTipoDescripción
concept_idrequeridopathintegerID 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

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

NombreUbicaciónTipoDescripción
asset_idrequeridopathstringCRC32 de FM o UUID estable de FI/ETF
from_datequerystringFecha 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

NombreUbicaciónTipoDescripción
asset_idrequeridopathstringCRC32 de FM o UUID estable de FI/ETF
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

NombreUbicaciónTipoDescripción
asset_idrequeridopathstringCRC32 de FM o UUID estable de FI/ETF
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

NombreUbicaciónTipoDescripción
asset_idrequeridopathstringCRC32 de FM o UUID estable de FI/ETF
from_datequerystringFecha 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

Fund Returns

Comparación de rentabilidades y búsqueda de series del universo publicado, con filtros, paginación y esferas CMF.

GET/api/compareAPI key

Comparar 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

NombreUbicaciónTipoDescripción
seriesrequeridoquerystringEntre 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
curl "https://api.buscafondos.com/api/compare?series=VALUE" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/screenerAPI key

Buscar 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

NombreUbicaciónTipoDescripción
qquerystring | nullSubcadena del nombre del fondo o RUN, sin distinguir mayúsculas.
fund_familyquerystring | nullFamilia fundFamily del catálogo, igualdad sin distinguir mayúsculas.
investor_classquerystring | nullClase de inversionista vigente al corte; si falta, usa la clase TAC fechada. Igualdad sin distinguir mayúsculas.
currencyquerystring | nullMoneda contable: PESOS/CLP o DOLAR/USD, sin distinguir mayúsculas. Obligatoria para ordenar retornos.
categoryquerystring | nullCategoría del catálogo, igualdad sin distinguir mayúsculas.
administratorquerystring | nullSubcadena del nombre de la administradora, sin distinguir mayúsculas.
cmf_spheres_minqueryinteger | nullMínimo inclusivo de esferas CMF (1 a 5); excluye valores no disponibles. No puede superar el máximo.
cmf_spheres_maxqueryinteger | nullMáximo inclusivo de esferas CMF (1 a 5); excluye valores no disponibles.
cmf_familyquerystring | nullFamilia oficial de esferas CMF, igualdad exacta y no vacía. Requerida para ordenar esferas.
cmf_investor_typequerystring | nullTipo de inversionista oficial de esferas CMF, igualdad exacta y no vacía. Requerido para ordenar esferas.
sortquerystringidtaccmf_spheres1m3m6m1yytd3y_ann5y_annlast_closed_monthCampo de orden. Los períodos de retorno requieren currency; cmf_spheres requiere ambos filtros de grupo oficial.Por defecto: id
orderquerystringascdescSentido del orden: ascendente o descendente. Los valores ausentes quedan al final.Por defecto: asc
limitqueryintegerNúmero máximo de series por página, entre 1 y 200.Por defecto: 50
offsetqueryintegerNúmero de series que se omiten después de filtrar y ordenar.Por defecto: 0
curl
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.

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

NombreUbicaciónTipoDescripción
metricquerystringMétrica de ordenamiento: `patrimony` (patrimonio) o `shareholders` (partícipes)Por defecto: patrimony
datequerystring | nullFecha 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

NombreUbicaciónTipoDescripción
administratorrequeridoqueryarrayNombres de administradoras a comparar (repetir parámetro para múltiples)
metricquerystringMétrica a graficar: `patrimony` o `shareholders`Por defecto: patrimony
from_monthquerystring | nullMes inicio en formato YYYY-MM
to_monthquerystring | nullMes 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

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

NombreUbicaciónTipoDescripción
categoryquerystring | nullFiltrar por categoría (money_market, equity, etc.)
fund_familyquerystring | nullFiltrar por familia CMF/AFM (ej: Accionario eeuu)
datequerystring | nullFecha específica (YYYY-MM-DD). Si no se envía, usa la más reciente.
article107_regulation_statusqueryArticle107RegulationStatus | nulldeclares_eligibledeclares_not_eligibleunknownFiltrar por lo que declara el reglamento sobre el artículo 107
vehiclequerystringmutual_fundetfinvestment_fundallVehículo: mutual_fund, etf, investment_fund (FI rescatable no ETF) o all.Por defecto: mutual_fund
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

NombreUbicaciónTipoDescripción
datequerystring | nullFecha 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

NombreUbicaciónTipoDescripción
family_rarrequeridopathstringSin descripción.
currencyquerystring | nullMoneda contable del índice (PESOS, DOLAR). Default: la de mayor patrimonio.
from_datequerystring | nullFecha 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

NombreUbicaciónTipoDescripción
runrequeridopathstringSin descripción.
monthquerystringMes 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

NombreUbicaciónTipoDescripción
runrequeridopathstringSin descripción.
monthquerystringMes en formato YYYY-MM (default: último disponible)
marketquerystringFiltro de mercado: N (nacional), E (extranjera), allPor defecto: 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

NombreUbicaciónTipoDescripción
family_rarrequeridopathstringSin descripción.
from_datequerystringFecha 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

NombreUbicaciónTipoDescripción
runrequeridopathstringSin 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 correo.

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

NombreUbicaciónTipoDescripción
return_urlrequeridoquerystringSin 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

NombreUbicaciónTipoDescripción
coderequeridoquerystringSin descripción.
staterequeridoquerystringSin 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

NombreUbicaciónTipoDescripción
serie_idrequeridopathstringSin 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

NombreUbicaciónTipoDescripción
tokenrequeridoquerystringSin descripción.
curl
curl -X POST "https://api.buscafondos.com/api/alerts/unsubscribe/one-click?token=VALUE"

Respuestas

Investment Funds

GET/api/fi/instrumentsAPI key

Instruments

Parámetros

NombreUbicaciónTipoDescripción
provider_idqueryinteger | nullSin descripción.
is_etfqueryboolean | nullSin descripción.
regulatory_typequerystring | nullFIRESFINRESin descripción.
statusquerystringactiveinactiveunknownallSin descripción.Por defecto: active
qquerystring | nullSin descripción.
limitqueryintegerSin descripción.Por defecto: 100
offsetqueryintegerSin descripción.Por defecto: 0
curl
curl "https://api.buscafondos.com/api/fi/instruments" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/fi/instruments/{instrument_id}API key

Instrument

Parámetros

NombreUbicaciónTipoDescripción
instrument_idrequeridopathstringSin descripción.
curl
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/fi/instruments/{instrument_id}/pricesAPI key

Prices

Parámetros

NombreUbicaciónTipoDescripción
instrument_idrequeridopathstringSin descripción.
from_datequerystring | nullSin descripción.
to_datequerystring | nullSin descripción.
limitqueryintegerSin descripción.Por defecto: 1000
offsetqueryintegerSin descripción.Por defecto: 0
curl
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}/prices" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/fi/instruments/{instrument_id}/cartera/holdingsAPI key

Cartera Holdings

Parámetros

NombreUbicaciónTipoDescripción
instrument_idrequeridopathstringSin descripción.
monthquerystring | nullSin descripción.
marketquerystringNEallSin descripción.Por defecto: all
curl
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}/cartera/holdings" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

Respuestas

GET/api/fi/instruments/{instrument_id}/cartera/resumenAPI key

Cartera Resumen

Parámetros

NombreUbicaciónTipoDescripción
instrument_idrequeridopathstringSin descripción.
monthquerystring | nullSin descripción.
marketquerystringNEallSin descripción.Por defecto: all
curl
curl "https://api.buscafondos.com/api/fi/instruments/{instrument_id}/cartera/resumen" \
  -H "X-Api-Key: $BUSCAFONDOS_API_KEY"

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

NombreUbicaciónTipoDescripción
datequerystring | nullFecha del mes calendario cerrado (YYYY-MM-DD). Si no se envia, usa el ultimo mes con TAC.
directionquerystringup = mayores alzas de TAC; down = mayores bajas.Por defecto: up
limitqueryintegerCantidad de fondos a devolver.Por defecto: 15
categoryquerystring | nullFiltrar 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.