Download and Aggregate High Frequency Trading Data from Bovespa

Downloads and aggregates high frequency trading data for Brazilian instruments directly from Bovespa ftp site <>.

Recently, Bovespa, the Brazilian financial exchange company, allowed external access to its ftp site. In this address one can find several information regarding the Brazilian financial system, including datasets with high frequency (tick by tick) trading data for three different markets: equity, options and BMF.

Downloading and processing these files, however, can be exausting. The dataset is composed of zip files with the whole trading data, separated by day and market. These files are huge in size and processing or aggregating them in a usefull manner requires specific knowledge for the structure of the dataset.

The package GetHFData make is easy to access this dataset directly by allowing the easy importation and aggregations of it. Based on this package the user can:

  • Access the contents of the Bovespa ftp using function function ghfd_get_ftp_contents
  • Get the list of available ticker in the trading data using ghfd_get_available_tickers_from_ftp
  • Download individual files using ghfd_download_file
  • Download and process a batch of dates and assets codes with ghfd_get_HF_data

In the next example we will only use a local file from the package. Given the size of the files in the ftp and the CHECK process of CRAN, it makes sense to keep this vignette compact and fast to run. More details about the usage of the package can be found in my RBFIN paper.


You can install the development version from github:


The stable version is availabe in CRAN:


Downloading and aggregating TRADE data

Package GetHDData supports batch downloads and processing of several different tickers using start and end dates. In this vignette we are not running the code given the large size of the downloaded files. You should try the next example in your own computer (just copy, paste and run the code in R).

In this example we will download files from the ftp for all stocks related to Petrobras (PETR) and Vale do Rio Doce (VALE). The data will be processed, resulting in a dataframe with aggregated data.


first.time <- '11:00:00'
last.time <- '17:00:00' <- '2015-11-01' <- '2015-11-10'
type.output <- 'agg' <- 'trades'
agg.diff <- '15 min'

# partial matching is available
my.assets <- c('PETR','VALE')
type.matching <- 'partial'  <- 'equity'

df.out <- ghfd_get_HF_data(my.assets =my.assets,
                           type.matching = type.matching,
                           first.time = first.time,
                           last.time = last.time,
                           type.output = type.output,
                           agg.diff = agg.diff)

Downloading and aggregating ORDER data

Version 1.3 of GetHFData makes it possible to download and aggregate order data from Bovespa. The data comprises buy and sell orders sent by market operators. Tabular data includes type of orders (buy or sell, new/update/cancel/..), date/time of submission, priority time, prices, order quantity, among many other information.

Be aware that these are very large files. One day of buy and sell orders in the equity market is around 100 MB zipped and close to 1 GB unzipped. If you computer is not suited to store this data in its memory, it will crash.

Here's an example of usage that will download and aggregate order data for all option contracts related to Petrobras (PETR):


first.time <- '10:00:00'
last.time <- '17:00:00' <- '2015-08-18' <- '2015-08-18'

type.output <- 'agg' # aggregates data 
agg.diff <- '5 min' # interval for aggregation

my.assets <- 'PETR' # all options related to Petrobras (partial matching)
type.matching <- 'partial' # finds tickers from my.assets using partial matching = 'options' # option market <- 'orders' # order data

df.out <- ghfd_get_HF_data(my.assets =my.assets, 
                           type.matching = type.matching,
                           first.time = first.time,
                           last.time = last.time,
                           type.output = type.output,
                           agg.diff = agg.diff)


Version 1.5 (2017-11-27)

Minor update:

  • Added support for milsecond in LOB

Version 1.4 (2017-09-10)

Major update:

  • Users can now recreate the LOB (limit order book) using order data from Bovespa
  • fixed bug for only.dl = TRUE

Version 1.3 (2017-05-29)

Major update:

  • Users can now download and aggregate order files (input
  • Fixed link to paper
  • Partial matching for assets is now possible (e.g. use PETR for all stocks or options related to Petrobras)
  • implement option for only downloading files (this is helpful if you are dealing with order data and will process the files in other R session or software)
  • muted message "Using ',' as decimal and '.' as grouping mark. Use read_delim() for more control."

Version 1.2.4 (2017-01-30)

Minor update:

  • Fixed bug in msg output when length(my.assets) > 2

Version 1.2.3 (2017-01-13)

Minor update:

  • Fixed bug for non existing assets in first date of download process
  • Changed input Date for simpler format (e.g. '2016-01-01' and not as.Date('2016-01-01'))

Version 1.2.2 (2016-12-05)

Minor update:

  • Revised apa citation on attach
  • Fixed some typos in vignette and added link to SSRN paper

Version 1.2.1 (2016-11-07)

Minor update with the following changes:

  • The user can now download data from the odd lots equity market ('equity-odds')
  • Added Henrique Ramos as a contributor
  • Other minor changes

Version 1.2.0 (2016-10-14)

Minor update with the following changes:

  • The function ghfd_get_HF_data now allows for partial matching of asset names and also the download of all assets available in ftp files
  • Function ghfd_get_available_tickers_from_ftp also returns the type of market in data.frame

Version 1.1.0 (2016-08-15)

Major update from initial version with the following changes:

  • The function for finding tickers in the ftp now looks for the closest date in the case that the actual date is missing from the ftp
  • The function for finding tickers now returns a dataframe with the tickers and number of trades
  • Added control for bad files
  • The output for raw and agg type of output were revised
  • The vignette is revised

Version 1.0.0 - First commit (2016-07-21)

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


1.5 by Marcelo Perlin, 3 months ago

Report a bug at

Browse source code at

Authors: Marcelo Perlin [aut, cre], Henrique Ramos [ctb]

Documentation:   PDF Manual  

Task views: Empirical Finance

GPL-2 license

Imports stringr, stats, RCurl, lubridate, readr, utils, curl, dplyr

Suggests knitr, rmarkdown, testthat, ggplot2

See at CRAN