Project description
[English]
Brazilian Fund Scrapper (or brfunds) is a package to recover data from investment funds without the need to download data to your computer. It uses the data available on https://comparadordefundos.com.br/ and can be used to Time Series Analysis of quote price, net assets and number of shareholders. It can also be used for comparing rentability of different funds.
[Português]
Brazilian Fund Scrapper (ou brfunds) é um pacote para obter dados de fundos de investimentos brasileiros sem precisar baixar arquivos para o drive do computador. Ele utiliza o banco de dados disponível em https://comparadordefundos.com.br/ e pode ser usado para Análise de Séries Temporais do valor de cotas, patrimônio do fundo e do número de cotistas.
Examples:
from brfunds import getFund
#Check CVM (http://sistemas.cvm.gov.br/fundos.asp)
# or Comparador de Fundos (https://www.comparadordefundos.com.br/fundos-de-investimento)
# for a valid fund name
getFund('Example Fund 1')
# You can also use the fund CNPJ as the name
Date |
Value |
Daily Variation |
Total Variation |
2008-01-31 |
500.000000 |
0.000000 |
0.000000 |
2008-02-01 |
499.642439 |
-0.000715 |
-0.000715 |
2008-02-06 |
495.049247 |
-0.009193 |
-0.009902 |
2008-02-07 |
495.495279 |
0.000901 |
-0.009009 |
2008-02-08 |
496.193927 |
0.001410 |
-0.007612 |
... |
... |
... |
... |
2021-06-02 |
1955.032101 |
0.002320 |
2.910064 |
2021-06-04 |
1957.100361 |
0.001058 |
2.914201 |
2021-06-07 |
1958.504200 |
0.000717 |
2.917008 |
2021-06-08 |
1955.777186 |
-0.001392 |
2.911554 |
2021-06-09 |
1955.800510 |
0.000012 |
2.911601 |
#Filter by Date
getFund('Example Fund 2', start='15/03/10', end='15/03/20')
#or
getFund('Example Fund 2', start=datetime.date(2010,3,15), end=datetime.date(2020,3,15))
Date |
Value |
Daily Variation |
Total Variation |
2010-03-15 |
2.921359 |
0.000000 |
0.000000 |
2010-03-16 |
2.925038 |
0.001259 |
0.001259 |
2010-03-17 |
2.922054 |
-0.001020 |
0.000238 |
2010-03-18 |
2.959106 |
0.012680 |
0.012921 |
2010-03-19 |
2.977092 |
0.006078 |
0.019078 |
... |
... |
... |
... |
2020-03-09 |
8.545470 |
0.023635 |
1.925169 |
2020-03-10 |
8.379862 |
-0.019380 |
1.868481 |
2020-03-11 |
8.552295 |
0.020577 |
1.927505 |
2020-03-12 |
8.666684 |
0.013375 |
1.966661 |
2020-03-13 |
8.722922 |
0.006489 |
1.985912 |
#Filter by period
getFund('Example Fund 3', period='2w')
Date |
Value |
Daily Variation |
Total Variation |
2021-06-01 |
66.362416 |
0.000000 |
0.000000 |
2021-06-02 |
66.339371 |
-0.000347 |
-0.000347 |
2021-06-04 |
66.355157 |
0.000238 |
-0.000109 |
2021-06-07 |
66.338489 |
-0.000251 |
-0.000361 |
2021-06-08 |
66.342636 |
0.000063 |
-0.000298 |
2021-06-09 |
66.335420 |
-0.000109 |
-0.000407 |
2021-06-10 |
66.321279 |
-0.000213 |
-0.000620 |
#Compare the results with the benchmark
#Available benchmarks: cdi, ipca and ibov
getFund('Example Fund 4', benchmark = 'ibov')
Date |
Value |
Daily Variation |
Total Variation |
IBOVESPA |
2019-11-29 |
10.000000 |
0.000000 |
0.000000 |
0.000000 |
2019-12-02 |
10.066960 |
0.006696 |
0.006696 |
0.006421 |
2019-12-03 |
10.041310 |
-0.002548 |
0.004131 |
0.006680 |
2019-12-04 |
10.167330 |
0.012550 |
0.016733 |
0.019107 |
2019-12-05 |
10.192820 |
0.002507 |
0.019282 |
0.022073 |
... |
... |
... |
... |
... |
2021-06-02 |
12.126600 |
0.016673 |
0.212660 |
0.197430 |
2021-06-04 |
12.169782 |
0.003561 |
0.216978 |
0.202275 |
2021-06-07 |
12.250059 |
0.006596 |
0.225006 |
0.208285 |
2021-06-08 |
12.152019 |
-0.008003 |
0.215202 |
0.199145 |
2021-06-09 |
12.153443 |
0.000117 |
0.215344 |
0.200251 |
#Obtain data about Net Assets and # of Shareholders
getFund('Example Fund 5', fullData = True)
Date |
Value |
Net Assets |
# of Shareholders |
Daily Variation |
Total Variation |
2020-11-16 |
100.000000 |
6130.00 |
6 |
0.000000 |
0.000000 |
2020-11-17 |
99.727896 |
6113.32 |
6 |
-0.002721 |
-0.002721 |
2020-11-18 |
99.640946 |
7228.91 |
13 |
-0.000872 |
-0.003591 |
2020-11-19 |
99.828543 |
7642.52 |
14 |
0.001883 |
-0.001715 |
2020-11-20 |
99.508648 |
9318.03 |
17 |
-0.003204 |
-0.004914 |
... |
... |
... |
... |
... |
... |
2021-06-02 |
117.688508 |
5578444.17 |
5892 |
0.007624 |
0.176885 |
2021-06-04 |
118.225607 |
5748230.07 |
6005 |
0.004564 |
0.182256 |
2021-06-07 |
118.538179 |
5882600.39 |
6231 |
0.002644 |
0.185382 |
2021-06-08 |
118.133825 |
6074472.90 |
6556 |
-0.003411 |
0.181338 |
2021-06-09 |
117.782325 |
6249691.48 |
6865 |
-0.002975 |
0.177823 |
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution