casased

casased — Casablanca Stock Exchange Data Retriever

A Python library to retrieve historical and intraday data from the Casablanca Stock Exchange (Bourse de Casablanca) using the Medias24 API.

Features

• 📈 Historical Data: Daily OHLCV data for all listed stocks
• 📊 Index Data: MASI and MSI20 historical data
• ⏱️ Intraday Data: Real-time intraday prices
• 🏦 Multiple Assets: Load data for multiple stocks at once
• ⚖️ Index Weights: Market index weights (pondération)
• 🔤 Asset Aliases: Support for common ticker aliases (CFG, CMG, IAM, MDP, SAM)

Note: Some features (getCours, getKeyIndicators, getDividend, getIndex, getIndexRecap) are temporarily unavailable due to website changes. See ROADMAP.md for details.

Installation

pip install casased

Cloudflare Bypass (Optional)

If you encounter 403 errors due to Cloudflare protection, install browser automation tools:

# Install with browser automation support
pip install casased[cloudflare]

# Or install manually
pip install nodriver seleniumbase

The library will automatically use headless browser automation as a fallback when direct API requests fail.

Quick Start

import casased as cas

# List available assets
assets = cas.notation()

# Get historical data for a stock
df = cas.get_history('BCP', start='2024-01-01', end='2024-12-31')

# Get MASI index history
masi = cas.get_history('MASI')

# Load multiple assets
banks = cas.loadmany(['BCP', 'CIH', 'Attijariwafa'], start='2024-01-01', end='2024-12-31')

# Get intraday data
intraday = cas.get_intraday('BCP')

API Reference

Historical Data

get_history(identifier, start=None, end=None)

Get historical daily data for a stock or index.

# Stock data
df = cas.get_history('Addoha', start='2024-01-01', end='2024-06-30')

# Index data
masi = cas.get_history('MASI')
msi20 = cas.get_history('MSI20')

Returns: DataFrame with columns: Value, Min, Max, Variation, Volume

loadmany(*assets, start=None, end=None, feature='Value')

Load data for multiple assets.

# Load closing prices
df = cas.loadmany(['BCP', 'CIH', 'BOA'], start='2024-01-01', end='2024-12-31')

# Load volumes
volumes = cas.loadmany(['BCP', 'CIH'], feature='Volume')

Intraday Data

get_intraday(identifier)

Get intraday prices for a stock or index.

# Stock intraday
intraday = cas.get_intraday('BCP')

# Market intraday
market = cas.get_intraday('MASI')

Company Information

⚠️ Temporarily Unavailable: The following functions are currently deprecated due to changes in the casablanca-bourse.com website structure. They return empty dictionaries with deprecation warnings. See ROADMAP.md for restoration timeline.

getCours(name) (deprecated)

Get session data, latest transactions, and order book.

cours = cas.getCours('BOA')  # Returns {} with deprecation warning

getKeyIndicators(name) (deprecated)

Get company key indicators and financial ratios.

indicators = cas.getKeyIndicators('Attijariwafa')  # Returns {} with deprecation warning

getDividend(name) (deprecated)

Get dividend history.

dividends = cas.getDividend('BOA')  # Returns {} with deprecation warning

Market Overview

getIndex() (deprecated)

Get all index summaries.

index = cas.getIndex()  # Returns {} with deprecation warning

getPond()

Get index weights (pondération).

weights = cas.getPond()

getIndexRecap() (deprecated)

Get session recap with top gainers/losers.

recap = cas.getIndexRecap()  # Returns {} with deprecation warning

Utilities

notation()

Get list of all available asset names.

assets = cas.notation()

get_isin_by_name(name)

Get ISIN code for an asset. Supports aliases like CFG, CMG, IAM, MDP, SAM.

isin = cas.get_isin_by_name('BCP')  # Returns 'MA0000011884'
isin = cas.get_isin_by_name('IAM')  # Returns 'MA0000011488' (alias for Maroc Telecom)

Data Sources

• Historical & Intraday Data: Medias24 API
• Company Info & Market Data: Bourse de Casablanca

Requirements

• Python 3.7+
• requests
• beautifulsoup4
• pandas
• lxml

Example Notebook

See casased_exemple.ipynb for a complete demonstration of all features.

Release Notes

• v0.2.0 — 2026-01-14 — Added asset aliases (CFG, CMG, IAM, MDP, SAM), deprecated broken scraping functions, updated HPS ISIN, added ROADMAP.md
• v0.1.2 — 2026-01-06 — Documentation cleanup, branding updates
• v0.1.1 — 2026-01-06 — Remove demo videos, update branding
• v0.1.0 — Initial release

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License — see LICENSE for details.

Contact

• GitHub: QuantBender/casased
• Twitter: @desire_dosseh
• LinkedIn: Désiré A. D.