This is a collection of R packages that facilitate download and use of Brazilian financial and economic data.
These packages help users by: (a) providing a more convenient browsing of datasets, and (b) facilitating the download and use of the selected datasets. This helps overcome issues that may arise from accessing the data directly from their APIs, such as having to transform each dataset from its native format into an R-friendly format (not to mention the native formats probably vary from one dataset to the other).
The goal of this compilation is to be a one-stop-shop for R users interested in Brazilian financial and economic datasets. Even if you know some of these packages, this list might help you know other packages that could be useful to you.
This list is a best-efforts compilaton, therefore it may be neither comprehensive nor necessarily up-to-date. Please feel free to contribute with updates, corrections or information about new packages that help users access Brazilian financial and economic data by creating a pull request. If you notice any issue with this compilation or if you have any ideas for features that could be added with a reasonable amount of effort, please create a new issue.
Please note there are no liabilities for the maintainers or colaborators of this repository from any problems that may arise due to the use of data downloaded from those packages.
Please note the packages below are organised by alphabetical order of their short name.
| Package | Title | Description | CRAN page | Source code |
|---|---|---|---|---|
| BETS | Brazilian Economic Time Series | It provides access to and information about the most important Brazilian economic time series - from the Getulio Vargas Foundation, the Central Bank of Brazil and the Brazilian Institute of Geography and Statistics. It also presents tools for managing, analysing (e.g. generating dynamic reports with a complete analysis of a series) and exporting these time series. | link | link |
| brazilianbanks | Data on Brazilian banks and other regulated financial institutions | A user-friendly interface to official datasets of bank-level variables sourced from the Central Bank of Brazil | - | link |
| censobr | Download Data from Brazil’s Population Census | censobr is an R package to download data from Brazil’s Population Census. The package is built on top of the Arrow platform, which allows users to work with larger-than-memory census data using {dplyr} familiar functions. | link | link |
| geobr | Download Official Spatial Data Sets of Brazil | Easy access to official spatial data sets of Brazil as 'sf' objects in R. The package includes a wide range of geospatial data available at various geographic scales and for various years with harmonized attributes, projection and fixed topology. | link | link |
| GetBCBData | Imports Datasets from BCB (Central Bank of Brazil) using Its Official API | Downloads and organizes datasets using BCB's API (https://www.bcb.gov.br/). Offers options for caching with the 'memoise' package and, multicore/multisession with 'furrr' and format of output data (long/wide). | link | link |
| GetDFPData2 | GetDFPData2: Reading Annual and Quarterly Financial Reports from B3 | Reads annual and quarterly financial reports from companies traded at B3, the Brazilian exchange. All data is downloaded and imported from CVM's public ftp site. | link | link |
| GetFREData | GetFREData: Reading FRE Corporate Data of Public Traded Companies from B3 | Reads corporate data such as board composition and compensation for companies traded at B3, the Brazilian exchange. All data is downloaded and imported from this ftp site. | link | link |
| GetTDData | GetTDData: Get Data for Brazilian Bonds (Tesouro Direto) | Downloads and aggregates data for Brazilian government issued bonds directly from the website of Tesouro Direto. | link | link |
| meedr | Macroeconomic Expectations Data in R using the Central Bank of Brazil API | Provides quick and easy access to market expectations data to the main macroeconomic indicators in the Focus report, made available by the Central Bank of Brazil through the Expectations System data API. This package offers an R interface to the API and other advantages, such as using a caching system and the option to use all the machine's cores (parallel computing). | link | link |
| rbcb | R interface to Brazilian Central Bank web services | An interface to structure the information provided by the Brazilian Central Bank. This package interfaces the Brazilian Central Bank web services to provide data already formatted into R's data structures and download currency data from Brazilian Centra Bank web site. | - | link |
| siconfiBD | siconfiBD | Public financial data from Brazillian municipalities. | - | link |
| siconfir | Quick and Easy Access Tax and Accounting Data of Brazil | Access tax and accounting data of Brazilian states and municipalities provided by the Brazilian Public Sector Accounting and Tax Information System. | link | link |