Téléchargement — SDK Python

Accédez aux données des marchés africains (BRVM + 15 places) directement depuis Python, avec une API simple et ergonomique. Gratuit pour la BRVM, sans clé.

Installation

pip install africaMarketsAnalytics

Python 3.8+. Le SDK tire automatiquement requests ; pandas est recommandé pour les DataFrames.

Téléchargement direct

Si vous préférez installer hors PyPI (réseau d'entreprise, air-gapped) :

⬇ Wheel (.whl)⬇ Archive source (.tar.gz)v0.1.0

puis :

pip install ./africamarketsanalytics-0.1.0-py3-none-any.whl

Gratuit, sans clé

Sans clé API, vous avez accès au marché régional BRVM/UEMOA avec 1 an d'historique. Pour les 15 autres places africaines, un historique plus profond, les conseils et le backtest, créez une clé (offres Premium/Entreprise).

Démarrage rapide

import africaMarketsAnalytics as ama

# Gratuit (BRVM, 1 an) — aucune clé requise
t = ama.Ticker("SNTS")
df = t.history(period="1y")     # DataFrame OHLCV
print(df.tail())

t.rsi(period=14)                # indicateur -> DataFrame
ama.tickers()                   # univers coté

# Tous les marchés + historique étendu : avec une clé API
ama.set_key("brvm_live_xxxxxxxx")
ama.download(["SNTS", "NPN"], period="5y")

Documentation — référence

Aperçu des fonctions. Le détail complet est dans le README livré avec le package.

Appel	Description
`ama.set_key(key)`	Définit la clé API (optionnel — sans clé = gratuit BRVM/1 an).
`ama.Ticker(symbol)`	Objet titre.
`t.history(period, start, end)`	Historique OHLCV → DataFrame (index Date).
`t.info`	Métadonnées : nom, secteur, pays, plage de dates.
`t.indicator(name, **p) / t.rsi() / t.macd()`	Indicateur → DataFrame (sma, ema, rsi, macd, bollinger, stochastic, atr, obv, vwap).
`t.signals(strategy)`	Signaux d'achat/vente d'une stratégie.
`t.backtest(strategy, **p)`	Backtest (clé requise).
`t.advice()`	Conseil automatique (clé requise).
`ama.tickers()`	Univers coté → DataFrame.
`ama.download(symbols, period)`	Multi-titres → DataFrame (colonnes MultiIndex).
`ama.market() / indices() / news() / usage()`	Aperçu marché, indices, actualités, consommation API.

Périodes acceptées

history(period=…) : 5d, 1mo, 3mo, 6mo, 1y, 2y, 3y, 5y, 10y, ytd, max — ou start='AAAA-MM-JJ'/end='AAAA-MM-JJ'. La profondeur réelle est plafonnée par votre offre (gratuit : 1 an).

Erreurs

`ama.AuthError`	Clé invalide/révoquée ou titre hors plan gratuit (401/403).
`ama.NotFound`	Ticker ou endpoint inconnu (404).
`ama.RateLimited`	Quota journalier dépassé (429).
`ama.AMAError`	Classe de base de toutes les erreurs du SDK.

⬇ README (doc complète)Voir la documentation de l'API REST →

Licence MIT · africaMarketsAnalytics v0.1.0