StocksMA is a package to facilitate access to financial and economic data of Moroccan stocks.

What is StocksMA ?

StocksMA is a package to facilitate access to financial and economic data of Moroccan stocks. It tries to cover potentially valuable and interesting data points.

The package include functions to extract price data from Leboursier, financial ratios(income statement, balance sheet, cash flow) from MarketWatch, and profile data from WSJ

Note: Sometimes, some functions may fail to get the data from some sources due to WAF protection.

Installation

Python3 is required.

$ pip install StocksMA

Usage

• Import the package
• Get all availabale tickers
• Get price data
  • Get price data of multiple companies
  • Get price data of single company
• Get session information
• Get intraday price data
• Get Ask Bid data
• Get balance sheet
  • Annual balance sheet
  • Quarter balance sheet
• Get income statement
  • Annual income statement
  • Quarter income statement
• Get cash flow
  • Annual cash flow
  • Quarter cash flow
• Get quote table
• Get market status
• Get company officers
• Get company information

Import the package

>> import StocksMA as stm

Get all availabale tickers

Show available tickers with the full name of the company Example:

stm.get_tickers()

ADH / Douja Promotion Groupe Addoha
ADI / Alliances Developpement Immobilier S.A.
AFI / Afric Industries S.A.
AFM / AFMA S.A.
.
.
.
WAA / Wafa Assurance S.A.
ZDJ / Zellidja S.A.

Get price data

Get historical OHLCV data for a given symbol(s)

Args:

• tickers Union[str, List[str]] : List or str of companies names or ticker symbols(e.g. ['maroc telecom', 'MNG'] or 'CIH')
• start_date str: (YYYY-MM-DD) Starting date to pull data from, limited to a maximum of six year
• end_date str: (YYYY-MM-DD) Ending date. Defaults to the current local date

Returns:

• pd.DataFrame: Dataframe of historical OHLCV data

Example:

# Get price data of multiple companies
stm.get_price_data(['CIH','maroc telecom', 'involys'], start_date='2020-11-14', end_date='2022-02-14')

[840 rows x 5 columns]

# Get price data of single company
stm.get_price_data('involys', start_date='2020-11-14', end_date='2022-02-14')

[253 rows x 5 columns]

Get session information

Get data related to the current trading session of a given symbol

Args:

• company str: Company name or ticker symbol(e.g. 'maroc telecom', 'MNG')

Returns:

• pd.DataFrame: Dataframe of session data

Example:

stm.get_session_info('involys')

Get intraday price data

Get intraday price data of a given symbol

Args:

• company str: Company name or ticker symbol(e.g. 'maroc telecom', 'MNG')

Returns:

• pd.DataFrame: Dataframe of intraday price data

Example:

stm.get_data_intraday('CIH')

Get Ask Bid data

Get ask bid data of a given symbol

Args:

• company str: Company name or ticker symbol(e.g. 'maroc telecom', 'MNG')

Returns:

• pd.DataFrame: Dataframe of ask bid data

Example:

stm.get_ask_bid('CIH')

Get balance sheet

Get balance sheet data of a given symbol

Args:

• company str: Ticker symbol(e.g. 'IAM', 'MNG')
• frequency str: Display either quarter or annual data. Defaults to "annual".

Returns:

• pd.DataFrame: Dataframe of balance sheet data

Example:

# Annual balance sheet
stm.get_balance_sheet('ATW', frequency='annual')

[74 rows x 5 columns]

# Quarter balance sheet
stm.get_balance_sheet('ATW', frequency='quarter')

[74 rows x 5 columns]

Get income statement

Get income statement data of a given symbol

Args:

• company str: Ticker symbol(e.g. 'IAM', 'MNG')
• frequency str: Display either quarter or annual data. Defaults to "annual".

Returns:

• pd.DataFrame: Dataframe of income statement data

Example:

# Annual income statement
stm.get_income_statement('IAM', frequency='annual')

# Quarter income statement
stm.get_income_statement('IAM', frequency='quarter')

Get cash flow

Get cash flow data of a given symbol

Args:

• company str: Ticker symbol(e.g. 'IAM', 'MNG')
• frequency str: Display either quarter or annual data. Defaults to "annual".

Returns:

• pd.DataFrame: Dataframe of cash flow data

Example:

# Annual cash flow
stm.get_cash_flow('IAM', frequency='annual')

# Quarter cash flow
stm.get_cash_flow('IAM', frequency='quarter')

Get quote table

Get important data about a given symbol

Args:

• company str: Ticker symbol(e.g. 'IAM', 'MNG')

Returns:

• pd.DataFrame: Dataframe of data about the ticker

Example:

stm.get_quote_table('ATW')

Get market status

Get status of the Moroccan market Returns:

• str: Status of the market(Open/Closed)

Example:

stm.get_market_status()

Closed

Get company officers

Get company officers of a given symbol

Args:

• company str: Ticker symbol(e.g. 'IAM', 'MNG')

Returns:

• pd.DataFrame: Dataframe of names and roles of the officers

Example:

stm.get_company_officers('MNG')

Get company information

Get information related to the company's location, adresse...

Args:

• company str: Ticker symbol(e.g. 'IAM', 'MNG')

Returns:

• pd.DataFrame: Dataframe of information related to the company (e.g. Name, Adresse, Phone...)

Example:

stm.get_company_info('MNG')

License

This project is licensed under the terms of the MIT license.