Quickstart · 5 min
Mansa API in Python
From zero to live African data in five minutes with the official mansaapi Python package.
1
Get a free API key
100 requests/day, no credit card. Issued instantly.
2
Install the package
terminal
pip install mansaapi3
Initialize the client
main.py
import os
from mansaapi import MansaAPI
mansa = MansaAPI(api_key=os.environ["MANSA_API_KEY"])4
Look up a bank
main.py
bank = mansa.identity.get_bank("058") # GTBank
print(bank["data"]["name"]) # Guaranty Trust Bank (GTBank)
print(bank["data"]["swift_code"]) # GTBINGLA
print(bank["data"]["ussd"]) # *737#5
Query market data + handle errors
main.py
from mansaapi import MansaAPIError
# Pan-African market movers
movers = mansa.markets.get_pan_african_movers(limit=10)
for m in movers["data"]:
print(m["ticker"], m["change_pct"])
# Premium endpoints raise on the free tier
try:
mansa.markets.get_insider_trades("NGX", days=30)
except MansaAPIError as err:
print(err.code, err.status) # TIER_REQUIRED 403