Get Mutual Funds Stats

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Listá las estadísticas de performance y composición de los fondos comunes de inversión disponibles.

Antes de empezar

Usá este endpoint cuando necesites recorrer o comparar estadísticas de varios FCI.
Agregá page y size si querés paginar el resultado.
Si necesitás el detalle de un fondo puntual, usá GET /api/prices/mutual-funds-stats/{mutual_fund_id}.

Cómo listar estadísticas de FCI

GET /api/prices/mutual-funds-stats

Consultar con paginación

GET /api/prices/mutual-funds-stats?page=1&size=50

Query parameters

Parámetro	Tipo	Requerido	Default	Descripción
`page`	integer	No	`1`	Número de página que querés consultar.
`size`	integer	No	`50`	Cantidad de fondos por página.

Qué devuelve este endpoint

La respuesta devuelve un objeto paginado con:

items: lista de estadísticas de fondos comunes de inversión
total: cantidad total de registros disponibles
page: página actual
size: cantidad de elementos por página

Cada elemento dentro de items representa las estadísticas de un fondo común de inversión.

Campo	Tipo	Descripción
`mutual_fund_id`	integer	Identificador único del fondo común de inversión.
`mutual_fund_name`	string	Nombre del fondo común de inversión.
`volatility_daily`	number	Volatilidad diaria del fondo.
`max_drop`	number	Máxima caída registrada del fondo.
`max_rise`	number	Máxima suba registrada del fondo.
`negative_months`	integer	Cantidad de meses con rendimiento negativo.
`positive_months`	integer	Cantidad de meses con rendimiento positivo.
`mtd_return`	number	Retorno acumulado en el mes.
`qtd_return`	number	Retorno acumulado en el trimestre.
`ytd_return`	number	Retorno acumulado en el año.
`last_year_return`	number	Retorno del último año calendario. Puede ser `null`.
`net_worth`	number	Patrimonio neto del fondo.
`annual_volatility`	number	Volatilidad anual del fondo.
`portfolio`	array de objetos	Composición de la cartera del fondo.
`updated_at`	string	Fecha y hora de la última actualización de los datos.

Estructura de `portfolio`

Cada elemento dentro de portfolio representa un componente de la cartera del fondo.

Campo	Tipo	Descripción
`amount`	number	Monto invertido en ese tipo de activo.
`currency_id`	string	Moneda en la que está expresado el monto.
`item`	string	Tipo de activo, por ejemplo `CAUCIONES`, `PLAZOS FIJOS` u `OTROS`.
`ratio_percentage`	number	Porcentaje que representa ese activo sobre el total del fondo.

Respuesta esperada

{
  "items": [
    {
      "mutual_fund_id": 9,
      "mutual_fund_name": "Adcap Ahorro Pesos Fondo de Dinero",
      "volatility_daily": 0.1693,
      "max_drop": 0.0227,
      "max_rise": 1.3101,
      "negative_months": 0,
      "positive_months": 66,
      "mtd_return": 0.2706,
      "qtd_return": 6.1664,
      "ytd_return": 59.0938,
      "last_year_return": null,
      "net_worth": 9389403601712.96,
      "annual_volatility": 2.689,
      "portfolio": [
        {
          "amount": 2115980881.8,
          "currency_id": "ARS",
          "item": "CAUCIONES",
          "ratio_percentage": 0.72
        }
      ],
      "updated_at": "2024-12-03T01:30:02Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 50
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

comparar métricas de performance entre varios FCI
revisar volatilidad, subas y caídas máximas en forma masiva
analizar composición de cartera para más de un fondo

Errores frecuentes

422 Validation Error: page o size tienen un formato inválido.
500 Internal Server Error: ocurrió un error no especificado durante la consulta.

Siguiente paso

Usá GET /api/prices/mutual-funds-stats/{mutual_fund_id} para consultar el detalle de un fondo puntual.