Koffi-Fredysessie/AfriMarkets

African stocks markets # AfriMarkets ### Access · Analyze · Understand African Capital Markets **AfriMarkets** is an R package that provides unified, programmatic access to historical and real-time financial data from African stock exchanges. Built for researchers, data scientists, analysts, and developers working on African capital markets. Installation · Quick Start · Markets · Functions · Contributing --- ## 🌍 Why AfriMarkets? African financial markets are rich with opportunity yet remain largely inaccessible to the global data-science community. **AfriMarkets** bridges that gap with: - A **single, consistent API** across heterogeneous exchanges and data sources - Ready-to-use **OHLCV data** (Open, High, Low, Close, Volume) - Built-in **statistical and financial analysis** tools - **Interactive charts** powered by `highcharter` --- ## ✨ Features | | Feature | Description | |---|---|---| | 📊 | Ticker discovery | Browse all available indexes and shares per market | | 📈 | Historical data | Fetch daily OHLCV data across any custom date range | | 🔄 | Flexible output | Long format, wide format, or both at once | | 🕯️ | Interactive charts | Candlestick & multi-ticker line charts via `highcharter` | | 💹 | Performance KPIs | Return, volatility, Sharpe ratio, max drawdown, and more | | 🧪 | Statistical tests | Normality and stationarity test batteries | | ⚡ | Simple API | Consistent function signatures across all markets | --- ## 📦 Installation ```r # Install the development version from GitHub # install.packages("devtools") devtools::install_github("Koffi-Fredysessie/AfriMarkets") ``` > **Note:** An active internet connection is required at install time to > resolve dependencies, and at runtime to fetch market data. --- ## 🔑 Supported Markets | Flag | Code | Exchange | Region | Backend | |---|---|---|---|---| | 🌍 | `BRVM` | Bourse Régionale des Valeurs Mobilières | UEMOA (8 countries) | Custom scraper | …