Fondos Mutuos y de Inversión
============================

.. _available_funds:

Listado de fondos disponibles
-----------------------------

.. code-block:: python

   import pandas as pd
   import requests

   payload = {
      "key": API_KEY,
      'ruts': '?',
   }
   r = requests.post('https://dolphin.markets/api/funds', json=payload)
   funds = pd.DataFrame(r.json())


.. _funds_data:

Rendimiento de fondos de private equity
---------------------------------------

A continuación te mostramos a modo de ejemplo, cómo obtener los valores cuota de 
fondos *feeders* de Private Equity, y a compararlos rápidamente en un gráfico. 

.. code-block:: python

   import pandas as pd
   import requests

   payload = {
      "key": API_KEY,
      'ruts': ['9637', '9572', '9621', '9636', '9681', '9701'
               '9713', '9732', '9731', '9747', '9657'],
   }
   r = requests.post('https://dolphin.markets/api/funds', json=payload)
   df = pd.DataFrame(r.json())

   valores_cuota = df.pivot_table(index='date', columns='nombre_fondo', values='valor_cuota')

   valores_cuota = valores_cuota.bfill()
   valores_cuota = valores_cuota.div(valores_cuota.iloc[0])
   valores_cuota.plot(figsize=(20, 10))

Obtenemos el siguiente gráfico comparando los retornos de los fondos:

.. image:: images/valores_cuota_private_equity.png
   :align: center
   :alt: valores_cuota


Descripción de los fondos mutuos y de inversión
-----------------------------------------------

En el siguiente ejemplo obtendremos el tipo de fondo, las series disponibles para cada fondo y la fecha de la última actualización de los datos.

.. code-block:: python

   import pandas as pd
   import requests

   payload = {
      "key": API_KEY,
      'ruts': ['8490', '9117', '9241', '8940'],
      'data': ['tipo_fondo', 'nombre_fondo',]
   }

   r = requests.post('https://dolphin.markets/api/funds-description', json=payload)
   df = pd.DataFrame(r.json())

   # Series de cada fondo
   df[['rut', 'serie', 'nombre_fondo']]

   # Tipo de fondo (Fondo Mutuo, Fondo de Inversión Rescatable o No Rescatable)
   df.drop_duplicates(subset=['rut'])[['rut', 'nombre_fondo', 'tipo_fondo']]


Carteras de inversión de fondos mutuos y de inversión
-----------------------------------------------------

En el siguiente ejemplo obtendremos la composición de las carteras de inversión. Esta información está disponible para los fondos mutuos y de inversión rescatables y no rescatables, aunque en diferentes frecuencias.

.. code-block:: python

   import pandas as pd
   import requests

   payload = {
      "key": API_KEY,
      'ruts': ['8490'],
      'periods': ['2021-12-31'],
      'values': ['pct_activo_del_fondo'],
   }

   r = requests.post('https://dolphin.markets/api/funds-holdings', json=payload)
   df = pd.DataFrame(r.json())
   df

También podemos obtener la última composición de la cartera de inversión de un fondo en específico.

.. code-block:: python

   payload = {
      "key": API_KEY,
      'ruts': ['8490'],
      'periods': ['latest'],
      'values': ['pct_activo_del_fondo'],
   }

   r = requests.post('https://dolphin.markets/api/funds-holdings', json=payload)
   df = pd.DataFrame(r.json())
   df

A modo de ejemplo graficaremos la composición de la cartera de inversión del fondo mutuo *Security Selectivo*, previamente obtenidos.

.. code-block:: python

   df = df.set_index('ticker')['pct_activo_del_fondo'].sort_values(ascending=False)
   df.iloc[:20].plot.bar()

Obtenemos el siguiente gráfico:

.. image:: images/security_selectivo.png
   :align: center
   :alt: