Nothing
README.md
In BRVM: Retrieve Historical Data of Companies Listed on the 'BRVM' Stock Exchange
title: "Library BRVM"
date: "14 février,2024"
output:
html_document:
toc: yes
fig_caption: yes
keep_md: yes
fig_width: 8
fig_height: 6
word_document:
toc: yes
pdf_document:
toc: yes
latex_engine: lualatex
always_allow_html: true
BRVM
Description {.tabset}
English
This R package provides a user-friendly interface for accessing data from the BRVM, which is a regional stock exchange serving multiple West African countries. With this package, users can easily retrieve historical stock price data, trading volumes, and other financial indicators for a variety of stocks traded on the BRVM.
The package is designed to simplify the process of gathering and analyzing financial data, making it easier for researchers, investors, and other users to extract insights and make informed decisions based on the information available. Overall, BRVM library is a valuable tool for anyone looking to gain a better understanding of the BRVM and the financial markets in West Africa.
Français
Ce package R fournit une interface conviviale pour accéder aux données de la BRVM, qui est une bourse régionale desservant plusieurs pays d'Afrique de l'Ouest. Avec ce package, les utilisateurs peuvent facilement récupérer des données historiques sur les prix des actions, les volumes de transactions et d'autres indicateurs financiers pour une variété d'actions négociées sur la BRVM.
Le package est conçu pour simplifier le processus de collecte et d'analyse de données financières, ce qui facilite la tâche des chercheurs, des investisseurs et d'autres utilisateurs pour extraire des informations et prendre des décisions éclairées en se basant sur les informations disponibles. Dans l'ensemble, notre package R est un outil précieux pour quiconque cherche à mieux comprendre la BRVM et les marchés financiers en Afrique de l'Ouest.
Installation guidelines
You can install using CRAN version
install.packages("BRVM")
You can install the development version of BRVM from github with:
# github dev version
## We can use devtools
# install.packages("devtools")
devtools::install_github("Koffi-Fredysessie/BRVM")
# Or use remotes
# install.packages("remotes")
remotes::install_github("Koffi-Fredysessie/BRVM")
Html version of the Readme
Since the size of the readme is huge due to the charts, you can visit the html version of the readme on RPubs
library(BRVM)
The BRVM_ticker_desc() function
It receives no argument and returns BRVM tickers information such as its full name, sector and country.
# Display tickers of BRVM
tickers <- BRVM_ticker_desc()
tickers
Ticker
Company name
Sector
Country
ABJC
SERVAIR ABIDJAN COTE D'IVOIRE
DISTRIBUTION
IVORY COAST
BICC
BICI COTE D'IVOIRE
FINANCE
IVORY COAST
BNBC
BERNABE COTE D'IVOIRE
DISTRIBUTION
IVORY COAST
BOAB
BANK OF AFRICA BENIN
FINANCE
BENIN
BOABF
BANK OF AFRICA BURKINA FASO
FINANCE
BURKINA FASO
BOAC
BANK OF AFRICA COTE D'IVOIRE
FINANCE
IVORY COAST
BOAM
BANK OF AFRICA MALI
FINANCE
MALI
BOAN
BANK OF AFRICA NIGER
FINANCE
NIGER
BOAS
BANK OF AFRICA SENEGAL
FINANCE
SENEGAL
CABC
SICABLE COTE D'IVOIRE
INDUSTRY
IVORY COAST
CBIBF
CORIS BANK INTERNATIONAL BURKINA FASO
FINANCE
BURKINA FASO
CFAC
CFAO MOTORS COTE D'IVOIRE
DISTRIBUTION
IVORY COAST
CIEC
CIE COTE D'IVOIRE
PUBLIC SERVICE
IVORY COAST
ECOC
ECOBANK COTE D'IVOIRE
FINANCE
IVORY COAST
ETIT
Ecobank Transnational Incorporated TOGO
FINANCE
TOGO
FTSC
FILTISAC COTE D'IVOIRE
INDUSTRY
IVORY COAST
NEIC
NEI-CEDA COTE D'IVOIRE
INDUSTRY
IVORY COAST
NSBC
NSIA BANQUE COTE D'IVOIRE
FINANCE
IVORY COAST
NTLC
NESTLE COTE D'IVOIRE
INDUSTRY
IVORY COAST
ONTBF
ONATEL BURKINA FASO
PUBLIC SERVICE
BURKINA FASO
ORAC
ORANGE COTE D'IVOIRE
PUBLIC SERVICE
IVORY COAST
ORGT
ORAGROUP TOGO
FINANCE
TOGO
PALC
PALM COTE D'IVOIRE
AGRICULTURE
IVORY COAST
PRSC
TRACTAFRIC MOTORS COTE D'IVOIRE
DISTRIBUTION
IVORY COAST
SAFC
SAFCA COTE D'IVOIRE
FINANCE
IVORY COAST
SCRC
SUCRIVOIRE COTE D'IVOIRE
AGRICULTURE
IVORY COAST
SDCC
SODE COTE D'IVOIRE
PUBLIC SERVICE
IVORY COAST
SDSC
BOLLORE TRANSPORT & LOGISTICS COTE D'IVOIRE
TRANSPORT
IVORY COAST
SEMC
CROWN SIEM COTE D'IVOIRE
INDUSTRY
IVORY COAST
SGBC
SOCIETE GENERALE COTE D'IVOIRE
FINANCE
IVORY COAST
SHEC
VIVO ENERGY COTE D'IVOIRE
DISTRIBUTION
IVORY COAST
SIBC
SOCIETE IVOIRIENNE DE BANQUE COTE D'IVOIRE
FINANCE
IVORY COAST
SICC
SICOR COTE D'IVOIRE
AGRICULTURE
IVORY COAST
SIVC
AIR LIQUIDE COTE D'IVOIRE
INDUSTRY
IVORY COAST
SLBC
SOLIBRA COTE D'IVOIRE
INDUSTRY
IVORY COAST
SMBC
SMB COTE D'IVOIRE
INDUSTRY
IVORY COAST
SNTS
SONATEL SENEGAL
PUBLIC SERVICE
SENEGAL
SOGC
SOGB COTE D'IVOIRE
AGRICULTURE
IVORY COAST
SPHC
SAPH COTE D'IVOIRE
AGRICULTURE
IVORY COAST
STAC
SETAO COTE D'IVOIRE
OTHER
IVORY COAST
STBC
SITAB COTE D'IVOIRE
INDUSTRY
IVORY COAST
SVOC
MOVIS COTE D'IVOIRE
TRANSPORT
IVORY COAST
TTLC
TOTAL COTE D'IVOIRE
DISTRIBUTION
IVORY COAST
TTLS
TOTAL SENEGAL
DISTRIBUTION
SENEGAL
TTRC
TRITURAF Ste en Liquid
INDUSTRY
IVORY COAST
UNLC
UNILEVER COTE D'IVOIRE
INDUSTRY
IVORY COAST
UNXC
UNIWAX COTE D'IVOIRE
INDUSTRY
IVORY COAST
The BRVM_index() function :
It receives no argument and returns a table of updated data (with as table header: indexes, previous closing, closing, change (%), Year to Date Change) on all the indices available on the BRVM exchange.
the_index <- BRVM_index()
the_index
Indexes
Previous closing
Closing
Change (%)
Year to Date Change
BRVM-30
104.31
104.49
0.17
-0.36
BRVM - AGRICULTURE
158.18
157.35
-0.52
2.09
BRVM - OTHER SECTOR
1054.97
1054.97
0.00
0.00
BRVM - COMPOSITE
207.86
208.27
0.20
-0.36
BRVM - DISTRIBUTION
305.91
312.62
2.19
1.12
BRVM - FINANCE
83.92
84.80
1.05
0.45
BRVM - INDUSTRY
101.32
100.86
-0.45
-0.65
BRVM - PRESTIGE
97.41
98.06
0.67
1.05
BRVM - PRINCIPAL
101.59
101.98
0.38
-1.06
BRVM - PUBLIC SERVICES
513.71
510.89
-0.55
-1.18
BRVM - TRANSPORT
359.60
364.38
1.33
-3.48
The BRVM_get(".symbol", ".from", ".to") function
This function will get the data of the companies listed on the BVRM stock exchange in Rich Bourse website. The function takes a single parameter, .symbol (which represents the "Ticker").
The function will automatically format tickers you enter in uppercase using toupper() and then ensure that the passed ticker is in a Google spreadsheet of allowed tickers.
- .symbol : A vector of symbols, like: c("BICC","XOM","SlbC") ;
- .from : A quoted start date, ie. "2020-01-01" or "2020/01/01". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD" ;
- .to : A quoted end date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD".
#' Displaying data of SONATEL Senegal stock
BRVM_get(.symbol = "snts")
#> # A tibble: 246 × 6
#> Date Open High Low Close Volume
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl>
#> 1 2023-02-14 15275 15300 15275 15300 10529
#> 2 2023-02-15 15400 15400 15305 15305 7023
#> 3 2023-02-16 15350 15350 15300 15300 22423
#> 4 2023-02-17 15400 15400 15300 15300 18325
#> 5 2023-02-20 15305 15395 15305 15395 4011
#> 6 2023-02-21 15395 15400 15395 15400 6237
#> 7 2023-02-22 15400 15440 15400 15440 4015
#> 8 2023-02-23 15440 15440 15400 15400 71763
#> 9 2023-02-24 15500 15690 15500 15690 22593
#> 10 2023-02-27 15700 15945 15700 15945 47984
#> # ℹ 236 more rows
symbols <- c("BiCc","XOM","SlbC") # We use here three tickers
data_tbl <- BRVM_get(.symbol = symbols, .from = "2020-01-01", .to = Sys.Date() - 1)
# Display the first twenty observations of the table
head(data_tbl, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2020-01-10 6500 6500 6500 6500 24 BICC
#> 2 2020-01-13 6370 6500 6370 6500 29 BICC
#> 3 2020-01-14 6495 6495 6495 6495 10 BICC
#> 4 2020-01-29 6010 6010 6010 6010 24 BICC
#> 5 2020-01-30 6000 6000 6000 6000 50 BICC
#> 6 2020-02-04 5800 5800 5800 5800 12 BICC
#> 7 2020-02-07 5650 5650 5650 5650 5 BICC
#> 8 2020-02-10 5500 5500 5500 5500 5 BICC
#> 9 2020-02-14 5300 5300 5300 5300 9 BICC
#> 10 2020-02-17 4910 4910 4910 4910 210 BICC
#> 11 2020-02-18 4910 4910 4910 4910 50 BICC
#> 12 2020-02-20 4895 4895 4895 4895 5 BICC
#> 13 2020-02-21 4895 4895 4890 4890 13 BICC
#> 14 2020-02-25 4525 4525 4525 4525 16 BICC
#> 15 2020-02-26 4435 4435 4430 4430 21 BICC
#> 16 2020-02-27 4345 4760 4335 4760 1809 BICC
#> 17 2020-03-03 4745 4750 4745 4750 11 BICC
#> 18 2020-03-05 4700 4700 4700 4700 5 BICC
#> 19 2020-03-06 4695 4695 4695 4695 6 BICC
#> 20 2020-03-11 4345 4450 4345 4450 135 BICC
# Display the last twenty elements of the table
tail(data_tbl, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2023-12-14 88200 90000 88200 90000 4 SLBC
#> 2 2023-12-15 90000 90000 90000 90000 5 SLBC
#> 3 2023-12-18 89000 90000 89000 89000 1 SLBC
#> 4 2023-12-19 89000 89000 85000 85000 716 SLBC
#> 5 2023-12-20 79000 90000 85000 89900 10 SLBC
#> 6 2023-12-22 90000 90000 89900 90000 1 SLBC
#> 7 2023-12-26 83300 90000 83300 88495 3 SLBC
#> 8 2023-12-27 88500 88500 88495 88500 1 SLBC
#> 9 2023-12-28 83300 88500 83300 87000 13 SLBC
#> 10 2024-01-02 87000 90000 87000 90000 2 SLBC
#> 11 2024-01-04 89500 90000 89500 89500 5 SLBC
#> 12 2024-01-11 88000 89500 88000 88000 160 SLBC
#> 13 2024-01-12 88000 89500 88000 89500 11 SLBC
#> 14 2024-01-15 89500 89500 88000 88000 13 SLBC
#> 15 2024-01-16 89500 89500 88000 89500 4 SLBC
#> 16 2024-01-19 89500 89500 88050 88050 14 SLBC
#> 17 2024-01-23 88950 88950 88050 88950 5 SLBC
#> 18 2024-01-25 88935 88950 88940 88940 2 SLBC
#> 19 2024-02-09 82270 88940 82270 88500 29 SLBC
#> 20 2024-02-13 88495 88500 88495 88495 1 SLBC
The BRVM_get1("ticker ", "Period", "from", "to") function
This function will get data of the companies listed on the BVRM stock exchange through the sikafinance site.
The function takes in a single parameter of ticker and will auto-format the tickers you input into all upper case by using toupper()
- ticker : A vector of ticker, like: c("BICC","XOM","SlbC", "BRvm10");
- Period : Numeric number indicating time period. Valid entries are 0, 1, 5, 30, 91, and 365 representing respectively 'daily', 'one year', 'weekly', 'monthly', 'quarterly' and 'yearly';
- from : A quoted start date, ie. "2020-01-01" or "2020/01/01". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD";
- to : A quoted end date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD"
NB : There is a small difference between the BRVM_get and BRVM_get1 functions.
With BRVM_get it is only possible to download tickers' daily data.
But with BRVM_get1, you can download daily, weekly, monthly, annual tickers’ data, indices and even market capitalization.
#' Displaying data of SONATEL Senegal stock
BRVM_get1("snts")
#> # A tibble: 63 × 5
#> Date Open High Low Close
#> <date> <int> <int> <int> <int>
#> 1 2023-11-17 17095 17150 17095 17150
#> 2 2023-11-20 17160 17160 17090 17090
#> 3 2023-11-21 17090 17195 17090 17195
#> 4 2023-11-22 17000 17245 17000 17245
#> 5 2023-11-23 17000 17295 17000 17295
#> 6 2023-11-24 17200 17295 17200 17295
#> 7 2023-11-27 17000 17295 17000 17295
#> 8 2023-11-28 17295 17295 17200 17200
#> 9 2023-11-29 17200 17200 17200 17200
#> 10 2023-11-30 17195 17200 17195 17200
#> # ℹ 53 more rows
# Get daily data of all indexes
all_ind <- BRVM_get1("ALL INDEXES", Period = 0, from = "2020-01-04", to = "2023-03-24")
# display the first two tens elements of the table
head(all_ind, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2022-12-26 293. 293. 293. 293. 0 BRVMAG
#> 2 2022-12-27 292. 292. 292. 292. 0 BRVMAG
#> 3 2022-12-28 285. 285. 285. 285. 0 BRVMAG
#> 4 2022-12-29 285. 285. 285. 285. 0 BRVMAG
#> 5 2022-12-30 284. 284. 284. 284. 0 BRVMAG
#> 6 2023-01-02 283. 283. 283. 283. 0 BRVMAG
#> 7 2023-01-03 281. 281. 281. 281. 0 BRVMAG
#> 8 2023-01-04 275. 275. 275. 275. 0 BRVMAG
#> 9 2023-01-05 279. 279. 279. 279. 0 BRVMAG
#> 10 2023-01-06 269. 269. 269. 269. 0 BRVMAG
#> 11 2023-01-09 276. 276. 276. 276. 0 BRVMAG
#> 12 2023-01-10 276. 276. 276. 276. 0 BRVMAG
#> 13 2023-01-11 276. 276. 276. 276. 0 BRVMAG
#> 14 2023-01-12 275. 275. 275. 275. 0 BRVMAG
#> 15 2023-01-13 275. 275. 275. 275. 0 BRVMAG
#> 16 2023-01-16 273. 273. 273. 273. 0 BRVMAG
#> 17 2023-01-17 273. 273. 273. 273. 0 BRVMAG
#> 18 2023-01-18 271. 271. 271. 271. 0 BRVMAG
#> 19 2023-01-19 281. 281. 281. 281. 0 BRVMAG
#> 20 2023-01-20 281. 281. 281. 281. 0 BRVMAG
# display the two tens of the last elements of the table
tail(all_ind, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2020-02-26 4281311 4281311 4281311 4281311 0 CAPIB
#> 2 2020-02-27 4314933 4314933 4314933 4314933 0 CAPIB
#> 3 2020-02-28 4346515 4346515 4346515 4346515 0 CAPIB
#> 4 2020-03-02 4424073 4424073 4424073 4424073 0 CAPIB
#> 5 2020-03-03 4379647 4379647 4379647 4379647 0 CAPIB
#> 6 2020-03-04 4369550 4369550 4369550 4369550 0 CAPIB
#> 7 2020-03-05 4342229 4342229 4342229 4342229 0 CAPIB
#> 8 2020-03-06 4359879 4359879 4359879 4359879 0 CAPIB
#> 9 2020-03-09 4338293 4338293 4338293 4338293 0 CAPIB
#> 10 2020-03-10 4357221 4357221 4357221 4357221 0 CAPIB
#> 11 2020-03-11 4332656 4332656 4332656 4332656 0 CAPIB
#> 12 2020-03-12 4318096 4318096 4318096 4318096 0 CAPIB
#> 13 2020-03-13 4318112 4318112 4318112 4318112 0 CAPIB
#> 14 2020-03-16 4285184 4285184 4285184 4285184 0 CAPIB
#> 15 2020-03-17 4301727 4301727 4301727 4301727 0 CAPIB
#> 16 2020-03-18 4288582 4288582 4288582 4288582 0 CAPIB
#> 17 2020-03-19 4207231 4207231 4207231 4207231 0 CAPIB
#> 18 2020-03-20 4209788 4209788 4209788 4209788 0 CAPIB
#> 19 2020-03-23 4154445 4154445 4154445 4154445 0 CAPIB
#> 20 2020-03-24 4144325 4144325 4144325 4144325 0 CAPIB
# To get yearly data
yearly_data <- BRVM_get1(c("brvmtr", "BiCc", "BOAS"), Period = 365 )
# display the first two tens elements of the table
head(yearly_data, 20)
#> # A tibble: 20 × 6
#> Date Open High Low Close Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2004-02-19 76.8 89.2 72.9 89.2 BRVMTR
#> 2 2005-01-03 89.2 107. 70.7 104. BRVMTR
#> 3 2006-01-02 104. 158. 104. 153. BRVMTR
#> 4 2007-01-02 153. 275. 149. 249. BRVMTR
#> 5 2008-01-02 249. 386. 226. 296. BRVMTR
#> 6 2009-01-02 275. 296. 227. 236. BRVMTR
#> 7 2010-01-04 236. 259. 224. 238. BRVMTR
#> 8 2011-01-03 238. 249. 204. 239 BRVMTR
#> 9 2012-01-02 239 349. 201. 349. BRVMTR
#> 10 2013-01-02 349. 794. 339. 789. BRVMTR
#> 11 2014-01-02 789. 1213. 601. 1213. BRVMTR
#> 12 2015-01-02 1213. 1525. 653. 1525. BRVMTR
#> 13 2016-01-04 1525. 1525. 1216. 1432. BRVMTR
#> 14 2017-01-02 1432. 1433. 764. 1203. BRVMTR
#> 15 2018-01-02 1114. 1193. 966. 966. BRVMTR
#> 16 2019-06-03 403. 429. 311. 367. BRVMTR
#> 17 2020-01-01 367. 475. 292. 379. BRVMTR
#> 18 2021-01-04 376. 622. 325 622. BRVMTR
#> 19 2022-01-03 667. 667. 295. 342. BRVMTR
#> 20 2023-01-02 341. 414. 307. 331. BRVMTR
# display the two tens of the last elements of the table
tail(yearly_data, 20)
#> # A tibble: 20 × 6
#> Date Open High Low Close Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2016-01-04 10000 10700 8566 9890 BICC
#> 2 2017-01-05 9750 10000 6440 8490 BICC
#> 3 2018-01-02 8700 8750 3795 7900 BICC
#> 4 2019-01-04 7550 7550 3710 6800 BICC
#> 5 2020-01-01 6800 6890 2855 6680 BICC
#> 6 2021-01-04 6680 7525 4280 7400 BICC
#> 7 2022-01-03 7250 7250 5550 6850 BICC
#> 8 2023-01-02 6500 7495 5785 7490 BICC
#> 9 2024-01-04 7450 7485 6900 7445 BICC
#> 10 2014-12-10 1613 3225 1613 3225 BOAS
#> 11 2015-01-02 3370 4300 2900 3950 BOAS
#> 12 2016-01-04 3700 4101 2000 2350 BOAS
#> 13 2017-01-02 2325 3875 2035 2500 BOAS
#> 14 2018-01-02 2400 3250 1700 2020 BOAS
#> 15 2019-01-02 1900 2000 1500 1545 BOAS
#> 16 2020-01-01 1550 1700 1295 1495 BOAS
#> 17 2021-01-04 1480 2750 1340 2350 BOAS
#> 18 2022-01-03 2350 2780 2200 2450 BOAS
#> 19 2023-01-02 2580 3650 2175 3200 BOAS
#> 20 2024-01-01 3200 3400 3000 3050 BOAS
The BRVM.index() function :
It receives no argument and returns the name of all indexes available on BRVM Stock Exchange.
BRVM.index()
#> [1] "BRVMAG" "BRVMC" "BRVMAS" "BRVMDI" "BRVMFI" "BRVMIN" "BRVMSP" "BRVMTR"
#> [9] "BRVMPR" "BRVMPA" "BRVM30"
The BRVM_bySector(".sectors") function :
This function will take in the name of sector(s) and returns data for companies belonging to that/those sector(s)
- .sectors : A vector of sectors you wish to have returned.
# Get informations about brvm sectors like other and agriculture sectors
BRVM_bySector(.sectors = c("Other", "Agriculture"))
#> # A tibble: 6 × 8
#> Ticker `Company name` Volume `Previous price` Open Close `Change (%)` Sector
#> <chr> <chr> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 STAC SETAO COTE D'I… 0 855 0 855 0 Other
#> 2 PALC PALM COTE D'IV… 171 6550 6550 6800 0 Agric…
#> 3 SCRC SUCRIVOIRE COT… 321 470 470 470 -5.05 Agric…
#> 4 SICC SICOR COTE D'I… 0 3600 0 3600 0 Agric…
#> 5 SOGC SOGB COTE D'IV… 3956 3050 3050 3050 -0.97 Agric…
#> 6 SPHC SAPH COTE D'IV… 169 2245 2100 2245 -0.22 Agric…
The BRVM_stock_market(".weekday") function :
This function receives as input a day of the week (working day) and returns the official quotation revews of that day.
* .weekday : A quoted date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD". Must not be a weekend or a holiday.
# The BOC of 2022-02-23
BRVM_stock_market("2022-02-23")
Ticker
Equity
Volume
Value
Previous price
Open
Close
Change (%)
Annual change (%)
Reference price
Low
High
Net Income
Date
Compartment
Yield Net (%)
PER
INDUSTRY SECTOR
-4.85%
NA
CABC
SICABLE CI
517
665880
1225
1225
1225
0
20.69
1225
1000
1030
133.00
02/08/2021
1er
10.86
6.22
FTSC
FILTISAC CI
840
1343210
1560
1600
1600
-2.5
-7.14
1600
17020
19780
235.00
31/08/2021
1er
14.69
6.35
NEIC
NEI-CEDA CI
10866
8915565
880
875
850
-7.37
40.80
950
33
37
9.00
28/06/2021
1er
0.00
15.14
NTLC
NESTLE CI
207
1168515
5645
5640
5645
-0.09
22.58
5650
1850
2140
363.67
30/07/2021
2eme
6.44
5.97
SEMC
CROWN SIEM CI
602
445980
730
750
750
2.74
-1.96
730
12835
14915
14.40
28/12/2021
2eme
1.97
24.97
SIVC
AIR LIQUIDE CI
1549
1255650
925
900
860
-7.03
-3.91
925
3980
4620
63.00
29/09/2020
1er
0.00
0.00
SLBC
SOLIBRA CI
167700
160000
167700
4.81
7.50
160000
115625
134375
2736.00
03/08/2021
1er
1.71
15.03
SMBC
SMB CI
144
1069980
7495
7495
7495
4.83
8.62
7150
7770
9030
810.00
15/07/2021
1er
11.33
5.93
STBC
SITAB CI
111
961900
5800
5800
5800
0
-6.15
5800
72150
83850
445.12
22/07/2021
1er
7.52
12.19
TTRC
TRITURAF CI
0
490
NC
NC
0
0.00
490
455
525
1440.00
19/07/2019
2eme
0.00
0.00
UNLC
UNILEVER CI
0
0
4850
NC
NC
0
-0.82
4850
7865
9135
1233.00
09/07/2020
2eme
0.00
0.00
UNXC
UNIWAX CI
808
1683980
2085
2085
2085
-0.24
4.25
2090
3885
4515
18.00
16/08/2021
2eme
0.86
117.28
TOTAL
15644
17510660
NA
PUBLIC SERVICES SECTOR
-6.94%
NA
CIEC
CIE CI
4192
8773320
2095
2100
2095
-0.24
10.55
2100
1840
1695
153.16
25/07/2021
1er
7.96
7.27
ONTBF
ONATEL BF
1238
5221520
4240
4210
4240
0.71
7.48
4210
6245
7255
399.56
01/06/2021
1er
9.49
9.22
SDCC
SODECI
1285
4897025
4050
4100
3750
-7.41
-12.69
4050
39775
46225
337.50
27/08/2021
1er
8.33
8.46
SNTS
SONATEL SN
17445
255870465
14650
14650
14650
0
4.83
14650
20305
23595
1225.00
21/05/2021
1er
8.36
7.28
TOTAL
24160
274762330
NA
FINANCE SECTOR
-16.09%
NA
BICC
BICICI
1275
7901650
6200
6200
6010
-3.06
-18.78
6200
7865
6090
50.00
15/07/2021
1er
0.81
22.12
BOAB
BOA BENIN
3524
21132470
5995
5995
5995
-0.08
13.11
6000
6475
5100
436.00
20/05/2021
1er
7.27
9.14
BOABF
BOA BURKINA FASO
307
1903400
6200
6195
6200
0
0.00
6200
6750
4900
370.00
03/05/2021
1er
5.97
7.75
BOAC
BOA CI
143
772200
5490
5490
5400
-1.64
-7.77
5490
3885
4495
315.00
12/05/2021
1er
5.74
7.72
BOAM
BOA MALI
342
481920
1430
1400
1450
1.4
-2.36
1430
21645
3060
1er
0.00
49.53
BOAN
BOA NIGER
571
3399875
6015
6000
6015
0.25
17.94
6000
3610
4600
429.66
06/05/2021
1er
7.16
10.51
BOAS
BOA SENEGAL
867
2145825
2475
2475
2475
0.2
5.32
2470
2270
2495
161.01
06/07/2021
1er
6.52
7.73
CBIBF
CORIS BANK INTERNATIONAL BF
282
2909300
10800
10250
10800
0
2.86
10800
8605
2495
1er
3.76
10.05
ECOC
ECOBANK CI
7784
33865535
4500
4500
4500
-2.07
-5.96
4595
14800
189
1er
6.40
8.43
ETIT
ECOBANK TRANSNATIONAL INCORPORATED (ETI TG)
248019
5129708
20
20
20
0
11.11
20
23
22
1.21
28/04/2021
1er
0.00
1.87
NSBC
NSIA BANQUE CI
335
1926200
5750
5750
5750
0
-7.03
5750
14800
189
1er
1.35
19.75
ORGT
ORAGROUP TG
982
3829065
3900
3900
3900
-4.06
-6.92
4065
14800
189
1er
1.46
29.89
SAFC
SAFCA CI
132
131340
1160
1160
1075
-7.33
26.47
1160
5740
5740
23.04
29/07/2021
1er
0.00
0.00
SGBC
SGCI
534
6885855
6885855
13105
12995
-0.84
22.65
13105
11990
11840
368.30
30/06/2021
1er
2.81
6.05
SIBC
SIB CI
3339
13466125
3955
3955
4000
1.14
0.38
3955
14800
189
1er
9.10
6.53
TOTAL
268436
105880468
NA
TRANSPORT SECTOR
0.00%
NA
SDSC
BOLLORE TRANSPORT & LOGISTICS CI
45
113000
2500
2400
2500
0
-2.72
2550
3935
3695
100.00
11/08/2021
1er
4.00
10.11
SVOC
MOVIS CI
0
0
2395
NC
NC
0
0.00
2395
2965
2900
270.00
23/07/2021
2eme
0.00
0.00
TOTAL
45
113000
NA
AGRICULTURE SECTOR
-12.42%
NA
PALC
PALM CÔTE D'IVOIRE
1310
11723360
9420
9295
8900
-0.16
34.76
9435
5250
4800
1236.34
31/08/2021
2eme
1.09
41.42
SCRC
SUCRIVOIRE CI
11629
11117870
1015
1075
1015
-7.31
5.73
1095
735
1005
1er
3.70
12.00
SICC
SICOR CI
4
21500
5320
5500
5000
-6.02
-2.34
5320
3655
3530
1919.00
25/09/2020
1er
0.00
3.23
SOGC
SOGB CI
517
2810115
5500
5495
5500
0.09
10.00
5495
3795
2900
541.81
21/07/2021
1er
4.55
15.51
SPHC
SAPH CI
1169
5962125
5150
5145
5150
0.98
-0.87
5100
2740
2800
132.30
24/08/2021
1er
2.59
17.46
TOTAL
14629
31634970
NA
DISTRIBUTION SECTOR
-1.84%
NA
ABJC
SERVAIR ABIDJAN CI
1000
1643825
1650
1640
1650
-5.44
-5.71
1745
1148
1005
164.96
30/09/2020
1er
0.00
0.00
BNBC
BERNABE CI
1088
2615160
2395
2395
2500
4.38
14.94
2395
576
1200
45.00
30/09/2019
1er
0.00
25.18
CFAC
CFAO MOTORS CI
198
232590
1160
1160
1200
0
-2.52
1160
605
430
22.15
15/07/2021
2eme
1.91
55.67
PRSC
TRACTAFRIC MOTORS CI
252
1158140
4600
4600
4600
0
9.52
4600
10
2800
162.90
02/09/2021
1er
3.54
25.28
SHEC
VIVO ENERGY CI
158
147150
925
925
925
-0.54
7.56
930
1172
585
63.90
26/11/2020
2eme
6.80
0.00
TTLC
TOTAL CI
8600
18586860
2160
2200
2160
0
2.86
2160
1961
1475
109.31
27/09/2021
1er
5.06
17.78
TTLS
TOTAL SN
1648
3486710
2095
2100
2095
-0.24
6.08
2100
1634
1445
223.60
30/09/2021
1er
10.65
11.28
TOTAL
12944
27870435
NA
OTHER SECTOR
-7.48%
NA
STAC
SETAO CI
6517
10304135
1805
1670
1670
-7.48
147.26
1805
281
565
2eme
3.66
10.45
TOTAL
6517
10304135
NA
TOTAL - Equities market
342375
468075998
NA
The BRVM_plot(".company", "up.col", "down.col") function:
This function will get Ticker(s) data and then plot it.
- .company : is the Ticker(s) name(s)
- from : A quoted start date, ie. "2020-01-01" or "2020/01/01". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD".
- to : A quoted end date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD"
- up.col : is the up color
- down.col : is down color
chart <- BRVM_plot("BICC") # The default colors for the up and down are green and
#chart
#It is also possible to plot stock data chart for more than one ticker
#Let's plot BICC, ETIT and BOAM stock data
chart1 <- BRVM_plot(c("BICC","ETIT", "BOAM"))
# chart1
BRVM_plot : For one ticker, you can also specify your color like BRVM_plot("boas", up.col = "blue", down.col = "pink") for example
The BRVM_company_info("ticker") function
It receives the ticker of a company listed on the BRVM stock exchange, Turn to upper case the input by using toupper() and returns informations about the company's RSI, Beta, Closing price, etc. .
# Get informations such us beta, RSI, Closing, Valorisation, etc. of Bank Of Africa Senegal
inform <- BRVM_company_info("BOAS")
inform
Informations
Values
Volume (titres)
2 399
Volume (XOF )
7 316 950
Ouverture
3 290
Plus haut
3 290
Plus bas
3 050
Clôture veille
3 290
Beta 1 an
0,28
RSI
37,14
Capital échangé
0,01%
Valorisation
73 200 MXOF
- BRVM_cap() : receives no argument and returns informations about BRVM capitalization
capit_ <- BRVM_cap()
capit_
- BRVM_company_rank() : returns companies rank from the BRVM Bourse exchange according to their daily change (variation).
comp.rank <- BRVM_company_rank() #Get companies rank
comp.rank <- comp.rank%>%
arrange(desc(percent_change)) #Describe in decreasing order
comp.rank
ticker
company_name
percent_change
rank
ABJC
SERVAIR ABIDJAN COTE D'IVOIRE
6.98
1
SHEC
VIVO ENERGY COTE D'IVOIRE
6.62
2
NEIC
NEI-CEDA COTE D'IVOIRE
5.93
3
ORGT
ORAGROUP TOGO
5.60
4
PRSC
TRACTAFRIC MOTORS COTE D'IVOIRE
4.78
5
CABC
SICABLE COTE D'IVOIRE
4.08
6
CBIBF
CORIS BANK INTERNATIONAL BURKINA FASO
3.78
7
CFAC
CFAO MOTORS COTE D'IVOIRE
3.47
8
SGBC
SOCIETE GENERALE COTE D'IVOIRE
2.17
9
ECOC
ECOBANK COTE D'IVOIRE
1.49
10
SDSC
BOLLORE TRANSPORT & LOGISTICS COTE D'IVOIRE
1.36
11
SIBC
SOCIETE IVOIRIENNE DE BANQUE COTE D'IVOIRE
1.04
12
SIVC
AIR LIQUIDE COTE D'IVOIRE
0.61
13
CIEC
CIE COTE D'IVOIRE
0.30
14
NSBC
NSIA BANQUE COTE D'IVOIRE
0.17
15
ORAC
ORANGE COTE D'IVOIRE
0.05
16
BICC
BICI COTE D'IVOIRE
0.00
25
BOABF
BANK OF AFRICA BURKINA FASO
0.00
25
BOAN
BANK OF AFRICA NIGER
0.00
25
ETIT
Ecobank Transnational Incorporated TOGO
0.00
25
FTSC
FILTISAC COTE D'IVOIRE
0.00
25
NTLC
NESTLE COTE D'IVOIRE
0.00
25
ONTBF
ONATEL BURKINA FASO
0.00
25
PALC
PALM COTE D'IVOIRE
0.00
25
SAFC
SAFCA COTE D'IVOIRE
0.00
25
SEMC
CROWN SIEM COTE D'IVOIRE
0.00
25
SICC
SICOR COTE D'IVOIRE
0.00
25
STAC
SETAO COTE D'IVOIRE
0.00
25
SVOC
MOVIS COTE D'IVOIRE
0.00
25
TTLC
TOTAL COTE D'IVOIRE
0.00
25
TTRC
TRITURAF Ste en Liquid
0.00
25
UNLC
UNILEVER COTE D'IVOIRE
0.00
25
UNXC
UNIWAX COTE D'IVOIRE
0.00
25
SLBC
SOLIBRA COTE D'IVOIRE
-0.01
34
SPHC
SAPH COTE D'IVOIRE
-0.22
35
BOAM
BANK OF AFRICA MALI
-0.37
36
TTLS
TOTAL SENEGAL
-0.42
37
SOGC
SOGB COTE D'IVOIRE
-0.97
38
SNTS
SONATEL SENEGAL
-1.16
39
BOAC
BANK OF AFRICA COTE D'IVOIRE
-1.25
40
STBC
SITAB COTE D'IVOIRE
-1.48
41
BOAB
BANK OF AFRICA BENIN
-1.54
42
SDCC
SODE COTE D'IVOIRE
-2.30
43
SMBC
SMB COTE D'IVOIRE
-2.39
44
BNBC
BERNABE COTE D'IVOIRE
-4.66
45
SCRC
SUCRIVOIRE COTE D'IVOIRE
-5.05
46
BOAS
BANK OF AFRICA SENEGAL
-7.29
47
- BRVM_direction(".up_or_down") : Takes 'Up' or 'Down' and returns respectively n results for the top or flop ranking of the BRVM tickers.
- .up_or_down : This is a character string set to "Up" by default It can either be 'Up' or 'Down'.
# Rank in increasing order the price of shares listed on the BRVM according to daily variations.
brvm_down <- BRVM_direction("Down")
brvm_down
Symbol
Name
Variation in percentage
BOAS
BANK OF AFRICA SENEGAL
-7.29
SCRC
SUCRIVOIRE COTE D'IVOIRE
-5.05
BNBC
BERNABE COTE D'IVOIRE
-4.66
SMBC
SMB COTE D'IVOIRE
-2.39
SDCC
SODE COTE D'IVOIRE
-2.30
BOAB
BANK OF AFRICA BENIN
-1.54
STBC
SITAB COTE D'IVOIRE
-1.48
BOAC
BANK OF AFRICA COTE D'IVOIRE
-1.25
SNTS
SONATEL SENEGAL
-1.16
SOGC
SOGB COTE D'IVOIRE
-0.97
TTLS
TOTAL SENEGAL
-0.42
BOAM
BANK OF AFRICA MALI
-0.37
SPHC
SAPH COTE D'IVOIRE
-0.22
SLBC
SOLIBRA COTE D'IVOIRE
-0.01
BICC
BICI COTE D'IVOIRE
0.00
BOABF
BANK OF AFRICA BURKINA FASO
0.00
BOAN
BANK OF AFRICA NIGER
0.00
ETIT
Ecobank Transnational Incorporated TOGO
0.00
FTSC
FILTISAC COTE D'IVOIRE
0.00
NTLC
NESTLE COTE D'IVOIRE
0.00
ONTBF
ONATEL BURKINA FASO
0.00
PALC
PALM COTE D'IVOIRE
0.00
SAFC
SAFCA COTE D'IVOIRE
0.00
SEMC
CROWN SIEM COTE D'IVOIRE
0.00
SICC
SICOR COTE D'IVOIRE
0.00
STAC
SETAO COTE D'IVOIRE
0.00
SVOC
MOVIS COTE D'IVOIRE
0.00
TTLC
TOTAL COTE D'IVOIRE
0.00
TTRC
TRITURAF Ste en Liquid
0.00
UNLC
UNILEVER COTE D'IVOIRE
0.00
UNXC
UNIWAX COTE D'IVOIRE
0.00
ORAC
ORANGE COTE D'IVOIRE
0.05
NSBC
NSIA BANQUE COTE D'IVOIRE
0.17
CIEC
CIE COTE D'IVOIRE
0.30
SIVC
AIR LIQUIDE COTE D'IVOIRE
0.61
SIBC
SOCIETE IVOIRIENNE DE BANQUE COTE D'IVOIRE
1.04
SDSC
BOLLORE TRANSPORT & LOGISTICS COTE D'IVOIRE
1.36
ECOC
ECOBANK COTE D'IVOIRE
1.49
SGBC
SOCIETE GENERALE COTE D'IVOIRE
2.17
CFAC
CFAO MOTORS COTE D'IVOIRE
3.47
CBIBF
CORIS BANK INTERNATIONAL BURKINA FASO
3.78
CABC
SICABLE COTE D'IVOIRE
4.08
PRSC
TRACTAFRIC MOTORS COTE D'IVOIRE
4.78
ORGT
ORAGROUP TOGO
5.60
NEIC
NEI-CEDA COTE D'IVOIRE
5.93
SHEC
VIVO ENERGY COTE D'IVOIRE
6.62
ABJC
SERVAIR ABIDJAN COTE D'IVOIRE
6.98
- BRVM_rank : receives "top" or "flop" and a number 'n' and returns table of companies classification
-
top_or_flop : Choose between "top" or "flop"
-
n : is the number of companies in the classification
#To get top 15
BRVM_rank("top", 15)
#> # A tibble: 15 × 3
#> Ticker Name `Change (%)`
#> <chr> <chr> <dbl>
#> 1 ABJC SERVAIR ABIDJAN COTE D'IVOIRE 6.98
#> 2 SHEC VIVO ENERGY COTE D'IVOIRE 6.62
#> 3 NEIC NEI-CEDA COTE D'IVOIRE 5.93
#> 4 ORGT ORAGROUP TOGO 5.6
#> 5 PRSC TRACTAFRIC MOTORS COTE D'IVOIRE 4.78
#> 6 CABC SICABLE COTE D'IVOIRE 4.08
#> 7 CBIBF CORIS BANK INTERNATIONAL BURKINA FASO 3.78
#> 8 CFAC CFAO MOTORS COTE D'IVOIRE 3.47
#> 9 SGBC SOCIETE GENERALE COTE D'IVOIRE 2.17
#> 10 ECOC ECOBANK COTE D'IVOIRE 1.49
#> 11 SDSC BOLLORE TRANSPORT & LOGISTICS COTE D'IVOIRE 1.36
#> 12 SIBC SOCIETE IVOIRIENNE DE BANQUE COTE D'IVOIRE 1.04
#> 13 SIVC AIR LIQUIDE COTE D'IVOIRE 0.61
#> 14 CIEC CIE COTE D'IVOIRE 0.3
#> 15 NSBC NSIA BANQUE COTE D'IVOIRE 0.17
#To get flop 5
BRVM_rank("flop", 5)
#> # A tibble: 5 × 3
#> Ticker Name `Change (%)`
#> <chr> <chr> <dbl>
#> 1 BOAS BANK OF AFRICA SENEGAL -7.29
#> 2 SCRC SUCRIVOIRE COTE D'IVOIRE -5.05
#> 3 BNBC BERNABE COTE D'IVOIRE -4.66
#> 4 SMBC SMB COTE D'IVOIRE -2.39
#> 5 SDCC SODE COTE D'IVOIRE -2.3
- company_traded_val("company") : receives one company listed on the BRVM stock exchange, Turn to upper case the input by using toupper() and returns informations about the company's traded value
- company : The name of company listed on the BRVM stock exchange
company_traded_val("ontbf") # Traded value of ONATEL BURKINA FASO
#> [1] "2 439 860"
Authors :
-
-
-
Creator : Koffi Frederic Sessie
cph (Copyright Holder) : Koffi Frederic Sessie
License : MIT 2023, BRVM authors. All rights reserved.
Try the BRVM package in your browser
Any scripts or data that you put into this service are public.
BRVM documentation built on May 29, 2024, 11:47 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
title: "Library BRVM" date: "14 février,2024" output: html_document: toc: yes fig_caption: yes keep_md: yes fig_width: 8 fig_height: 6 word_document: toc: yes pdf_document: toc: yes latex_engine: lualatex always_allow_html: true
BRVM
Description {.tabset}
English
This R package provides a user-friendly interface for accessing data from the BRVM, which is a regional stock exchange serving multiple West African countries. With this package, users can easily retrieve historical stock price data, trading volumes, and other financial indicators for a variety of stocks traded on the BRVM.
The package is designed to simplify the process of gathering and analyzing financial data, making it easier for researchers, investors, and other users to extract insights and make informed decisions based on the information available. Overall, BRVM library is a valuable tool for anyone looking to gain a better understanding of the BRVM and the financial markets in West Africa.
Français
Ce package R fournit une interface conviviale pour accéder aux données de la BRVM, qui est une bourse régionale desservant plusieurs pays d'Afrique de l'Ouest. Avec ce package, les utilisateurs peuvent facilement récupérer des données historiques sur les prix des actions, les volumes de transactions et d'autres indicateurs financiers pour une variété d'actions négociées sur la BRVM.
Le package est conçu pour simplifier le processus de collecte et d'analyse de données financières, ce qui facilite la tâche des chercheurs, des investisseurs et d'autres utilisateurs pour extraire des informations et prendre des décisions éclairées en se basant sur les informations disponibles. Dans l'ensemble, notre package R est un outil précieux pour quiconque cherche à mieux comprendre la BRVM et les marchés financiers en Afrique de l'Ouest.
Installation guidelines
You can install using CRAN version
install.packages("BRVM")
You can install the development version of BRVM from github with:
# github dev version
## We can use devtools
# install.packages("devtools")
devtools::install_github("Koffi-Fredysessie/BRVM")
# Or use remotes
# install.packages("remotes")
remotes::install_github("Koffi-Fredysessie/BRVM")
Html version of the Readme
Since the size of the readme is huge due to the charts, you can visit the html version of the readme on RPubs
library(BRVM)
The BRVM_ticker_desc() function
It receives no argument and returns BRVM tickers information such as its full name, sector and country.
# Display tickers of BRVM
tickers <- BRVM_ticker_desc()
tickers
The BRVM_index() function :
It receives no argument and returns a table of updated data (with as table header: indexes, previous closing, closing, change (%), Year to Date Change) on all the indices available on the BRVM exchange.
the_index <- BRVM_index()
the_index
The BRVM_get(".symbol", ".from", ".to") function
This function will get the data of the companies listed on the BVRM stock exchange in Rich Bourse website. The function takes a single parameter, .symbol (which represents the "Ticker").
The function will automatically format tickers you enter in uppercase using toupper() and then ensure that the passed ticker is in a Google spreadsheet of allowed tickers.
- .symbol : A vector of symbols, like: c("BICC","XOM","SlbC") ;
- .from : A quoted start date, ie. "2020-01-01" or "2020/01/01". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD" ;
- .to : A quoted end date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD".
#' Displaying data of SONATEL Senegal stock
BRVM_get(.symbol = "snts")
#> # A tibble: 246 × 6
#> Date Open High Low Close Volume
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl>
#> 1 2023-02-14 15275 15300 15275 15300 10529
#> 2 2023-02-15 15400 15400 15305 15305 7023
#> 3 2023-02-16 15350 15350 15300 15300 22423
#> 4 2023-02-17 15400 15400 15300 15300 18325
#> 5 2023-02-20 15305 15395 15305 15395 4011
#> 6 2023-02-21 15395 15400 15395 15400 6237
#> 7 2023-02-22 15400 15440 15400 15440 4015
#> 8 2023-02-23 15440 15440 15400 15400 71763
#> 9 2023-02-24 15500 15690 15500 15690 22593
#> 10 2023-02-27 15700 15945 15700 15945 47984
#> # ℹ 236 more rows
symbols <- c("BiCc","XOM","SlbC") # We use here three tickers
data_tbl <- BRVM_get(.symbol = symbols, .from = "2020-01-01", .to = Sys.Date() - 1)
# Display the first twenty observations of the table
head(data_tbl, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2020-01-10 6500 6500 6500 6500 24 BICC
#> 2 2020-01-13 6370 6500 6370 6500 29 BICC
#> 3 2020-01-14 6495 6495 6495 6495 10 BICC
#> 4 2020-01-29 6010 6010 6010 6010 24 BICC
#> 5 2020-01-30 6000 6000 6000 6000 50 BICC
#> 6 2020-02-04 5800 5800 5800 5800 12 BICC
#> 7 2020-02-07 5650 5650 5650 5650 5 BICC
#> 8 2020-02-10 5500 5500 5500 5500 5 BICC
#> 9 2020-02-14 5300 5300 5300 5300 9 BICC
#> 10 2020-02-17 4910 4910 4910 4910 210 BICC
#> 11 2020-02-18 4910 4910 4910 4910 50 BICC
#> 12 2020-02-20 4895 4895 4895 4895 5 BICC
#> 13 2020-02-21 4895 4895 4890 4890 13 BICC
#> 14 2020-02-25 4525 4525 4525 4525 16 BICC
#> 15 2020-02-26 4435 4435 4430 4430 21 BICC
#> 16 2020-02-27 4345 4760 4335 4760 1809 BICC
#> 17 2020-03-03 4745 4750 4745 4750 11 BICC
#> 18 2020-03-05 4700 4700 4700 4700 5 BICC
#> 19 2020-03-06 4695 4695 4695 4695 6 BICC
#> 20 2020-03-11 4345 4450 4345 4450 135 BICC
# Display the last twenty elements of the table
tail(data_tbl, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2023-12-14 88200 90000 88200 90000 4 SLBC
#> 2 2023-12-15 90000 90000 90000 90000 5 SLBC
#> 3 2023-12-18 89000 90000 89000 89000 1 SLBC
#> 4 2023-12-19 89000 89000 85000 85000 716 SLBC
#> 5 2023-12-20 79000 90000 85000 89900 10 SLBC
#> 6 2023-12-22 90000 90000 89900 90000 1 SLBC
#> 7 2023-12-26 83300 90000 83300 88495 3 SLBC
#> 8 2023-12-27 88500 88500 88495 88500 1 SLBC
#> 9 2023-12-28 83300 88500 83300 87000 13 SLBC
#> 10 2024-01-02 87000 90000 87000 90000 2 SLBC
#> 11 2024-01-04 89500 90000 89500 89500 5 SLBC
#> 12 2024-01-11 88000 89500 88000 88000 160 SLBC
#> 13 2024-01-12 88000 89500 88000 89500 11 SLBC
#> 14 2024-01-15 89500 89500 88000 88000 13 SLBC
#> 15 2024-01-16 89500 89500 88000 89500 4 SLBC
#> 16 2024-01-19 89500 89500 88050 88050 14 SLBC
#> 17 2024-01-23 88950 88950 88050 88950 5 SLBC
#> 18 2024-01-25 88935 88950 88940 88940 2 SLBC
#> 19 2024-02-09 82270 88940 82270 88500 29 SLBC
#> 20 2024-02-13 88495 88500 88495 88495 1 SLBC
The BRVM_get1("ticker ", "Period", "from", "to") function
This function will get data of the companies listed on the BVRM stock exchange through the sikafinance site.
The function takes in a single parameter of ticker and will auto-format the tickers you input into all upper case by using toupper()
- ticker : A vector of ticker, like: c("BICC","XOM","SlbC", "BRvm10");
- Period : Numeric number indicating time period. Valid entries are 0, 1, 5, 30, 91, and 365 representing respectively 'daily', 'one year', 'weekly', 'monthly', 'quarterly' and 'yearly';
- from : A quoted start date, ie. "2020-01-01" or "2020/01/01". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD";
- to : A quoted end date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD"
NB : There is a small difference between the BRVM_get and BRVM_get1 functions. With BRVM_get it is only possible to download tickers' daily data. But with BRVM_get1, you can download daily, weekly, monthly, annual tickers’ data, indices and even market capitalization.
#' Displaying data of SONATEL Senegal stock
BRVM_get1("snts")
#> # A tibble: 63 × 5
#> Date Open High Low Close
#> <date> <int> <int> <int> <int>
#> 1 2023-11-17 17095 17150 17095 17150
#> 2 2023-11-20 17160 17160 17090 17090
#> 3 2023-11-21 17090 17195 17090 17195
#> 4 2023-11-22 17000 17245 17000 17245
#> 5 2023-11-23 17000 17295 17000 17295
#> 6 2023-11-24 17200 17295 17200 17295
#> 7 2023-11-27 17000 17295 17000 17295
#> 8 2023-11-28 17295 17295 17200 17200
#> 9 2023-11-29 17200 17200 17200 17200
#> 10 2023-11-30 17195 17200 17195 17200
#> # ℹ 53 more rows
# Get daily data of all indexes
all_ind <- BRVM_get1("ALL INDEXES", Period = 0, from = "2020-01-04", to = "2023-03-24")
# display the first two tens elements of the table
head(all_ind, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2022-12-26 293. 293. 293. 293. 0 BRVMAG
#> 2 2022-12-27 292. 292. 292. 292. 0 BRVMAG
#> 3 2022-12-28 285. 285. 285. 285. 0 BRVMAG
#> 4 2022-12-29 285. 285. 285. 285. 0 BRVMAG
#> 5 2022-12-30 284. 284. 284. 284. 0 BRVMAG
#> 6 2023-01-02 283. 283. 283. 283. 0 BRVMAG
#> 7 2023-01-03 281. 281. 281. 281. 0 BRVMAG
#> 8 2023-01-04 275. 275. 275. 275. 0 BRVMAG
#> 9 2023-01-05 279. 279. 279. 279. 0 BRVMAG
#> 10 2023-01-06 269. 269. 269. 269. 0 BRVMAG
#> 11 2023-01-09 276. 276. 276. 276. 0 BRVMAG
#> 12 2023-01-10 276. 276. 276. 276. 0 BRVMAG
#> 13 2023-01-11 276. 276. 276. 276. 0 BRVMAG
#> 14 2023-01-12 275. 275. 275. 275. 0 BRVMAG
#> 15 2023-01-13 275. 275. 275. 275. 0 BRVMAG
#> 16 2023-01-16 273. 273. 273. 273. 0 BRVMAG
#> 17 2023-01-17 273. 273. 273. 273. 0 BRVMAG
#> 18 2023-01-18 271. 271. 271. 271. 0 BRVMAG
#> 19 2023-01-19 281. 281. 281. 281. 0 BRVMAG
#> 20 2023-01-20 281. 281. 281. 281. 0 BRVMAG
# display the two tens of the last elements of the table
tail(all_ind, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2020-02-26 4281311 4281311 4281311 4281311 0 CAPIB
#> 2 2020-02-27 4314933 4314933 4314933 4314933 0 CAPIB
#> 3 2020-02-28 4346515 4346515 4346515 4346515 0 CAPIB
#> 4 2020-03-02 4424073 4424073 4424073 4424073 0 CAPIB
#> 5 2020-03-03 4379647 4379647 4379647 4379647 0 CAPIB
#> 6 2020-03-04 4369550 4369550 4369550 4369550 0 CAPIB
#> 7 2020-03-05 4342229 4342229 4342229 4342229 0 CAPIB
#> 8 2020-03-06 4359879 4359879 4359879 4359879 0 CAPIB
#> 9 2020-03-09 4338293 4338293 4338293 4338293 0 CAPIB
#> 10 2020-03-10 4357221 4357221 4357221 4357221 0 CAPIB
#> 11 2020-03-11 4332656 4332656 4332656 4332656 0 CAPIB
#> 12 2020-03-12 4318096 4318096 4318096 4318096 0 CAPIB
#> 13 2020-03-13 4318112 4318112 4318112 4318112 0 CAPIB
#> 14 2020-03-16 4285184 4285184 4285184 4285184 0 CAPIB
#> 15 2020-03-17 4301727 4301727 4301727 4301727 0 CAPIB
#> 16 2020-03-18 4288582 4288582 4288582 4288582 0 CAPIB
#> 17 2020-03-19 4207231 4207231 4207231 4207231 0 CAPIB
#> 18 2020-03-20 4209788 4209788 4209788 4209788 0 CAPIB
#> 19 2020-03-23 4154445 4154445 4154445 4154445 0 CAPIB
#> 20 2020-03-24 4144325 4144325 4144325 4144325 0 CAPIB
# To get yearly data
yearly_data <- BRVM_get1(c("brvmtr", "BiCc", "BOAS"), Period = 365 )
# display the first two tens elements of the table
head(yearly_data, 20)
#> # A tibble: 20 × 6
#> Date Open High Low Close Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2004-02-19 76.8 89.2 72.9 89.2 BRVMTR
#> 2 2005-01-03 89.2 107. 70.7 104. BRVMTR
#> 3 2006-01-02 104. 158. 104. 153. BRVMTR
#> 4 2007-01-02 153. 275. 149. 249. BRVMTR
#> 5 2008-01-02 249. 386. 226. 296. BRVMTR
#> 6 2009-01-02 275. 296. 227. 236. BRVMTR
#> 7 2010-01-04 236. 259. 224. 238. BRVMTR
#> 8 2011-01-03 238. 249. 204. 239 BRVMTR
#> 9 2012-01-02 239 349. 201. 349. BRVMTR
#> 10 2013-01-02 349. 794. 339. 789. BRVMTR
#> 11 2014-01-02 789. 1213. 601. 1213. BRVMTR
#> 12 2015-01-02 1213. 1525. 653. 1525. BRVMTR
#> 13 2016-01-04 1525. 1525. 1216. 1432. BRVMTR
#> 14 2017-01-02 1432. 1433. 764. 1203. BRVMTR
#> 15 2018-01-02 1114. 1193. 966. 966. BRVMTR
#> 16 2019-06-03 403. 429. 311. 367. BRVMTR
#> 17 2020-01-01 367. 475. 292. 379. BRVMTR
#> 18 2021-01-04 376. 622. 325 622. BRVMTR
#> 19 2022-01-03 667. 667. 295. 342. BRVMTR
#> 20 2023-01-02 341. 414. 307. 331. BRVMTR
# display the two tens of the last elements of the table
tail(yearly_data, 20)
#> # A tibble: 20 × 6
#> Date Open High Low Close Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2016-01-04 10000 10700 8566 9890 BICC
#> 2 2017-01-05 9750 10000 6440 8490 BICC
#> 3 2018-01-02 8700 8750 3795 7900 BICC
#> 4 2019-01-04 7550 7550 3710 6800 BICC
#> 5 2020-01-01 6800 6890 2855 6680 BICC
#> 6 2021-01-04 6680 7525 4280 7400 BICC
#> 7 2022-01-03 7250 7250 5550 6850 BICC
#> 8 2023-01-02 6500 7495 5785 7490 BICC
#> 9 2024-01-04 7450 7485 6900 7445 BICC
#> 10 2014-12-10 1613 3225 1613 3225 BOAS
#> 11 2015-01-02 3370 4300 2900 3950 BOAS
#> 12 2016-01-04 3700 4101 2000 2350 BOAS
#> 13 2017-01-02 2325 3875 2035 2500 BOAS
#> 14 2018-01-02 2400 3250 1700 2020 BOAS
#> 15 2019-01-02 1900 2000 1500 1545 BOAS
#> 16 2020-01-01 1550 1700 1295 1495 BOAS
#> 17 2021-01-04 1480 2750 1340 2350 BOAS
#> 18 2022-01-03 2350 2780 2200 2450 BOAS
#> 19 2023-01-02 2580 3650 2175 3200 BOAS
#> 20 2024-01-01 3200 3400 3000 3050 BOAS
The BRVM.index() function :
It receives no argument and returns the name of all indexes available on BRVM Stock Exchange.
BRVM.index()
#> [1] "BRVMAG" "BRVMC" "BRVMAS" "BRVMDI" "BRVMFI" "BRVMIN" "BRVMSP" "BRVMTR"
#> [9] "BRVMPR" "BRVMPA" "BRVM30"
The BRVM_bySector(".sectors") function :
This function will take in the name of sector(s) and returns data for companies belonging to that/those sector(s)
- .sectors : A vector of sectors you wish to have returned.
# Get informations about brvm sectors like other and agriculture sectors
BRVM_bySector(.sectors = c("Other", "Agriculture"))
#> # A tibble: 6 × 8
#> Ticker `Company name` Volume `Previous price` Open Close `Change (%)` Sector
#> <chr> <chr> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 STAC SETAO COTE D'I… 0 855 0 855 0 Other
#> 2 PALC PALM COTE D'IV… 171 6550 6550 6800 0 Agric…
#> 3 SCRC SUCRIVOIRE COT… 321 470 470 470 -5.05 Agric…
#> 4 SICC SICOR COTE D'I… 0 3600 0 3600 0 Agric…
#> 5 SOGC SOGB COTE D'IV… 3956 3050 3050 3050 -0.97 Agric…
#> 6 SPHC SAPH COTE D'IV… 169 2245 2100 2245 -0.22 Agric…
The BRVM_stock_market(".weekday") function :
This function receives as input a day of the week (working day) and returns the official quotation revews of that day. * .weekday : A quoted date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD". Must not be a weekend or a holiday.
# The BOC of 2022-02-23
BRVM_stock_market("2022-02-23")
The BRVM_plot(".company", "up.col", "down.col") function:
This function will get Ticker(s) data and then plot it.
- .company : is the Ticker(s) name(s)
- from : A quoted start date, ie. "2020-01-01" or "2020/01/01". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD".
- to : A quoted end date, ie. "2022-01-31" or "2022/01/31". The date must be in ymd format "YYYY-MM-DD" or "YYYY/MM/DD"
- up.col : is the up color
- down.col : is down color
chart <- BRVM_plot("BICC") # The default colors for the up and down are green and
#chart
#It is also possible to plot stock data chart for more than one ticker
#Let's plot BICC, ETIT and BOAM stock data
chart1 <- BRVM_plot(c("BICC","ETIT", "BOAM"))
# chart1
BRVM_plot: For one ticker, you can also specify your color likeBRVM_plot("boas", up.col = "blue", down.col = "pink")for example
The BRVM_company_info("ticker") function
It receives the ticker of a company listed on the BRVM stock exchange, Turn to upper case the input by using toupper() and returns informations about the company's RSI, Beta, Closing price, etc. .
# Get informations such us beta, RSI, Closing, Valorisation, etc. of Bank Of Africa Senegal
inform <- BRVM_company_info("BOAS")
inform
- BRVM_cap() : receives no argument and returns informations about BRVM capitalization
capit_ <- BRVM_cap()
capit_
- BRVM_company_rank() : returns companies rank from the BRVM Bourse exchange according to their daily change (variation).
comp.rank <- BRVM_company_rank() #Get companies rank
comp.rank <- comp.rank%>%
arrange(desc(percent_change)) #Describe in decreasing order
comp.rank
- BRVM_direction(".up_or_down") : Takes 'Up' or 'Down' and returns respectively n results for the top or flop ranking of the BRVM tickers.
- .up_or_down : This is a character string set to "Up" by default It can either be 'Up' or 'Down'.
# Rank in increasing order the price of shares listed on the BRVM according to daily variations.
brvm_down <- BRVM_direction("Down")
brvm_down
- BRVM_rank : receives "top" or "flop" and a number 'n' and returns table of companies classification
-
top_or_flop : Choose between "top" or "flop"
-
n : is the number of companies in the classification
#To get top 15
BRVM_rank("top", 15)
#> # A tibble: 15 × 3
#> Ticker Name `Change (%)`
#> <chr> <chr> <dbl>
#> 1 ABJC SERVAIR ABIDJAN COTE D'IVOIRE 6.98
#> 2 SHEC VIVO ENERGY COTE D'IVOIRE 6.62
#> 3 NEIC NEI-CEDA COTE D'IVOIRE 5.93
#> 4 ORGT ORAGROUP TOGO 5.6
#> 5 PRSC TRACTAFRIC MOTORS COTE D'IVOIRE 4.78
#> 6 CABC SICABLE COTE D'IVOIRE 4.08
#> 7 CBIBF CORIS BANK INTERNATIONAL BURKINA FASO 3.78
#> 8 CFAC CFAO MOTORS COTE D'IVOIRE 3.47
#> 9 SGBC SOCIETE GENERALE COTE D'IVOIRE 2.17
#> 10 ECOC ECOBANK COTE D'IVOIRE 1.49
#> 11 SDSC BOLLORE TRANSPORT & LOGISTICS COTE D'IVOIRE 1.36
#> 12 SIBC SOCIETE IVOIRIENNE DE BANQUE COTE D'IVOIRE 1.04
#> 13 SIVC AIR LIQUIDE COTE D'IVOIRE 0.61
#> 14 CIEC CIE COTE D'IVOIRE 0.3
#> 15 NSBC NSIA BANQUE COTE D'IVOIRE 0.17
#To get flop 5
BRVM_rank("flop", 5)
#> # A tibble: 5 × 3
#> Ticker Name `Change (%)`
#> <chr> <chr> <dbl>
#> 1 BOAS BANK OF AFRICA SENEGAL -7.29
#> 2 SCRC SUCRIVOIRE COTE D'IVOIRE -5.05
#> 3 BNBC BERNABE COTE D'IVOIRE -4.66
#> 4 SMBC SMB COTE D'IVOIRE -2.39
#> 5 SDCC SODE COTE D'IVOIRE -2.3
- company_traded_val("company") : receives one company listed on the BRVM stock exchange, Turn to upper case the input by using toupper() and returns informations about the company's traded value
- company : The name of company listed on the BRVM stock exchange
company_traded_val("ontbf") # Traded value of ONATEL BURKINA FASO
#> [1] "2 439 860"
Authors :
Creator : Koffi Frederic Sessie
cph (Copyright Holder) : Koffi Frederic Sessie
License : MIT 2023, BRVM authors. All rights reserved.
Try the BRVM package in your browser
Any scripts or data that you put into this service are public.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.