Documentation

Build on Africa with one API surface.

Mansa API exposes live African market data plus location and identity reference endpoints for developers and AI systems. Start with a free key, then move into higher limits when your product is ready.

Base URL
https://mansaapi.com
Authentication
Bearer token using a `mansa_live_sk_...` API key.
Free tier
100 requests per day, all endpoints, no credit card.
Get API Key

Issue a free key in one request.

Standard keys are issued instantly. Use the returned key in the `Authorization` header on every endpoint.

curl -X POST https://mansaapi.com/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Lovelace",
    "email": "ada@example.com"
  }'
curl https://mansaapi.com/api/v1/markets/exchanges \
  -H "Authorization: Bearer mansa_live_sk_your_key_here"
Suite Pages

Start with the right suite.

The suite pages give Mansa API clean category signals for search and AI discovery without turning the site into dozens of thin endpoint pages.

Selective Landing Pages

A few strong pages beat dozens of weak ones.

Authentication

Issue free developer keys and use them as Bearer tokens on every endpoint.

POST/api/v1/keys
Public

Issue a free standard key instantly or submit a higher-tier request.

Mansa Markets Suite

Live African exchange, quote, movers, index, forex, and commodity data.

GET/api/v1/markets/exchanges
Bearer auth

Return all tracked exchanges with latest snapshot metadata.

GET/api/v1/markets/exchanges/{exchange_code}
Bearer auth

Return a single exchange and its latest index snapshot.

GET/api/v1/markets/exchanges/{exchange_code}/stocks
Bearer auth

Return stocks for a single exchange.

Query params
limit - Maximum rows to return, capped at 200.
offset - Pagination offset.
sector - Optional sector filter.
sort_by - ticker, price, change_pct, or volume.
order - asc or desc.
GET/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}
Bearer auth

Return a single stock with quote and reference fields.

GET/api/v1/markets/exchanges/{exchange_code}/movers
Bearer auth

Return top gainers and losers for an exchange.

Query params
limit - Maximum movers to return, capped at 20.
type - gainers, losers, or both.
GET/api/v1/markets/movers/pan-african
Bearer auth

Return top movers across all live African exchanges.

Query params
limit - Maximum movers to return, capped at 20.
GET/api/v1/markets/indices
Bearer auth

Return latest tracked African market indices.

GET/api/v1/markets/forex
Bearer auth

Return current forex rates available through Mansa Markets.

GET/api/v1/markets/commodities
Bearer auth

Return commodity prices relevant to African producers and traders.

GET/api/v1/markets/exchange-metadata
Bearer auth

Return exchange metadata such as market type, settlement cycle, and website.

Mansa Location Suite

African country profiles, regional breakdowns, and holiday data.

GET/api/v1/location/countries
Bearer auth

Return African countries with optional region filter.

Query params
region - Filter countries by region text match.
GET/api/v1/location/countries/{country_code}
Bearer auth

Return a single country profile by ISO2 or ISO3 code.

GET/api/v1/location/countries/{country_code}/states
Bearer auth

Return states, regions, counties, or provinces for supported countries.

GET/api/v1/location/countries/{country_code}/states/{state_code}/lgas
Bearer auth

Return LGAs, districts, or sub-county units for supported states.

GET/api/v1/location/countries/{country_code}/states/{state_code}/postal-codes
Bearer auth

Return Nigeria postal-code coverage for a state, with optional detailed LGA lookup.

Query params
lga - Optional LGA name or code for a detailed locality-level postcode response.
limit - Rows per page when lga is provided, capped at 250.
offset - Pagination offset when lga is provided.
GET/api/v1/location/countries/{country_code}/holidays/{year}
Bearer auth

Return public holidays for a country and year.

Mansa Identity Suite

Bank and financial identity reference data for African fintech.

GET/api/v1/identity/banks
Bearer auth

Return bank and mobile-money institutions with optional filters.

Query params
country - Filter by country code, for example NG or GH.
type - Filter by institution type.
GET/api/v1/identity/banks/{bank_code}
Bearer auth

Return a single bank or institution by bank code.

GET/api/v1/identity/mobile-networks
Bearer auth

Return mobile network operators with optional country filter.

Query params
country - Filter by country code, for example NG or GH.
GET/api/v1/identity/mobile-networks/lookup
Bearer auth

Return the mobile network that matches a phone number prefix.

Query params
phone - Phone number in local or international format.
GET/api/v1/identity/currencies
Bearer auth

Return African currency metadata with issuing countries.

GET/api/v1/identity/currencies/{currency_code}
Bearer auth

Return a single currency record by ISO code.

Machine-readable

Specs for developers and agents.