MyNixOS website logo
Description

Retrieve Historical Data of Companies Listed on the 'BRVM' Stock Exchange.

Provide real-time access to data from the Regional Securities Exchange SA(<https://www.brvm.org/en>), commonly known as the 'BRVM' stock exchange. The goal is to facilitate data access for users of the R programming language. The package includes a variety of data that can be accessed by calling functions.

CRAN_Status_Badge Lifecycle: experimental PRs Welcome

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.

Metadata

Version

5.3.0

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows