Librería descargarbvc

Resumen

En esta publicación, les quiero compartir una librería que he creado para R llamada descargarbvc, la cual sirve para obtener información de la Bolsa de Valores de Colombia. Actualmente sólo se puede descargar información sobre Acciones, pero con el tiempo iré implementando algunas otras funciones para obtener información de futuros y renta fija.

¿Por qué usarla?

Para realizar estudios sobre el comportamiento de las acciones se necesita tener la materia prima: la información. En mercados desarrollados la información se encuentra disponible libremente para tramos de tiempo de hasta 5 años. En Colombia, hay algunas limitaciones. La Bolsa de Valores de Colombia permite descargar la información únicamente para un tramo de tiempo de 6 meses. La librería descargarbvc permite descargar el tramo de tiempo que desees.

En un único comando es posible descargar la información de diferentes acciones a la vez. Esta es una utilidad importante para la creación de portafolios en un mismo periodo de tiempo.

El registro de la información está disponible en memoria, listo para su procesamiento. Como por ejemplo, realizar un gráfico de cajas y bigotes. Realizar portafolios eficientes, entre otras...

La información también queda almacenada en el disco duro, mediante un archivo .csv para posteriores análisis con otros software como Excel.

Requisitos previos

Se necesita tener instaladas las siguientes librerías:

• devtools
• XLConnect
• xts
• zoo

¿Cómo instalarla?

Abre R en la version de 64-bits e instala la librería devtools mediante el comando install.packages("devtools"). Esta librería permite hacer instalaciones de otras librerías que han sido guardadas en Github, que es un famoso repositorio para compartir software de código abierto. Similarmente, descargar las demás librerías requeridas (XLConnect, xts y zoo). Luego instalamos la librería 'descargarbvc', escribiendo el comando devtools::install_github("johnfarias/descargarbvc"). Si ha quedado bien instalada, se debe ver un código similar al siguiente:

¿Cómo cargar la librería instalada?

Se sugiere cargar todas las librerías necesarias para un correcto funcionamiento:

library(XLConnect)
library(xts)
library(zoo)
library(descargarbvc)

¿Cómo usarla?

En primer lugar, establezca un directorio de trabajo mediante el comando setwd(). En esta ruta, al utilizar la función principal 'descargarAccion', se creará una carpeta llamada 'Datos' que contendrá la información descargada de la bolsa.

El comando descargarAccion() se usa para obtener información de una Acción especifica que se negocia en bolsa. Se puede usar como argumento, un vector de cadenas de texto con los nemotécnicos. Por ejemplo, para obtener varios activos a la vez usamos descargarAccion(c("TERPEL","EEB","ECOPETROL")). O simplemente una cadena de texto con el nemotécnico del activo descargarAccion("ETB"). En cualquiera de los dos casos, se creará una variable tipo xts (Serie de tiempo con fechas) por cada activo puesto como argumento.

Por defecto se descarga un periodo de 182 días contando desde el día de consulta hacia atrás. Y es que la bolsa solo permite descargas de 182 días en formato .xls. Sin embargo se puede establecer un rango de fechas más amplio dentro de la función. R descargará periodos de a 182 dias en formato Excel, luego los unificará en un archivo .csv y finalmente los dejará almacenados en memoria, listos para procesar gráficos o análisis estadísticos. El archivo .csv es el único que permanecerá dentro de la carpeta 'Datos' y los archivos de excel serán eliminados. Especifique el rango de fechas que desea descargar, por ejemplo descargarAccion("EEB",fecha.ini="2015-01-01",fecha.fin="2017-01-01"). Esto será todo lo necesario para comenzar a usar este paquete.