# Mansa API API

**Canonical:** https://apis.io/apis/mansaapi-com/mansa-api-api/  
**Provider:** mansaapi-com — https://apis.io/providers/mansaapi-com/  
**Base URL:** https://mansaapi.com  
**Documentation:** https://mansaapi.com/reference/african-bank-codes

Mansa API API is one of 2 APIs that [mansaapi-com](https://apis.io/providers/mansaapi-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

African data infrastructure for developers and AI agents. Live market data, NGX equities, ETFs, indices, location data, and identity reference data built in Lagos.

## Operations (60 of 61)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Return platform and suite health, including market freshness metadata. |
| POST | `/api/v1/keys` | Issue a free standard key instantly or submit a higher-tier request. |
| GET | `/api/v1/markets/exchanges` | Return all tracked exchanges with latest snapshot metadata. |
| GET | `/api/v1/markets/exchanges/{exchange_code}` | Return a single exchange and its latest index snapshot. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/stocks` | Return stocks for a single exchange. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}` | Return a single stock with quote and reference fields. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/movers` | Return top gainers and losers for an exchange. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}/history` | Return daily OHLCV price history for a stock from the deep archive. Depth varies by market: South Africa (JSE) from 1980, Kenya from 1992, Morocco from 1994,... |
| GET | `/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}/fundamentals` | Return fundamentals for a stock: market cap, sector, 52-week high/low, TTM dividend yield. |
| GET | `/api/v1/markets/search` | Search stocks by ticker or name across one or all African exchanges. |
| GET | `/api/v1/markets/trending` | Return trending stocks by volume across all live African exchanges. |
| GET | `/api/v1/markets/movers/pan-african` | Return top movers across all live African exchanges. |
| GET | `/api/v1/markets/indices` | Return latest tracked African market indices. |
| GET | `/api/v1/markets/indices/{index_code}/history` | Return daily historical values for a tracked African index. Depth varies by index: NGX ASI from 1996, JSE All Share from 1995, SEMDEX from 1990, EGX 30 from ... |
| GET | `/api/v1/markets/exchanges/{exchange_code}/indices` | Return available index snapshots for a tracked African exchange. DSE returns TSI, DSEI, BI, IA, and CS when the DSE feed has current data. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/indices/{code}` | Return a single benchmark or sector index by code or alias. For Tanzania, valid codes include TSI, DSEI, BI, IA, and CS. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/indices/{code}/history` | Return historical benchmark index points for a tracked exchange. Supports range=1D, 1W, 1M, 3M, 1Y, or ALL. |
| GET | `/api/v1/markets/exchanges/NGX/indices` | Return the full NGX index universe snapshot. Database-backed, persisted in Supabase-backed snapshots, refreshed every 30 minutes, and consumed by Mansa Marke... |
| GET | `/api/v1/markets/exchanges/NGX/indices/{code}` | Return a single NGX index by code or slug. Valid lookups include ASI and ngx-bnk. |
| GET | `/api/v1/markets/exchanges/NGX/etfs` | Return the full NGX ETF universe snapshot. Database-backed, persisted in Supabase-backed snapshots, refreshed every 30 minutes, and consumed by Mansa Markets... |
| GET | `/api/v1/markets/exchanges/NGX/etfs/{symbol}` | Return a single NGX ETF by canonical symbol. Example: NEWGOLD. |
| GET | `/api/v1/markets/exchanges/NGX/etfs/resolve/{symbol}` | Resolve legacy, shorthand, or vendor ETF tickers into canonical NGX ETF symbols used by the API. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/dividends/{ticker}` | Return dividend history for a stock: ex-dividend dates, record dates, pay dates, and dividend-per-share amounts. NGX only. Premium tier. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/disclosures` | Return NGX regulatory filings and company announcements: financial reports, corporate actions, price-sensitive notices. NGX only. Premium tier. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/insider-trades` | Return director and insider dealings parsed from NGX PDF disclosures: transaction type, volume, price, and post-trade holdings. NGX only. Premium tier. |
| GET | `/api/v1/markets/exchanges/{exchange_code}/recommendations` | Return weekly broker recommendations and per-ticker consensus (BUY/HOLD/SELL) compiled from Nigerian stockbroker research. NGX only. Premium tier. |
| GET | `/api/ngxdata/indices` | Legacy compatibility route for /api/v1/markets/exchanges/NGX/indices. Prefer the Mansa Markets namespace for new integrations. |
| GET | `/api/ngxdata/indices/{code}` | Legacy compatibility route for /api/v1/markets/exchanges/NGX/indices/{code}. Prefer the Mansa Markets namespace for new integrations. |
| GET | `/api/ngxdata/etfs` | Legacy compatibility route for /api/v1/markets/exchanges/NGX/etfs. Prefer the Mansa Markets namespace for new integrations. |
| GET | `/api/ngxdata/etfs/{symbol}` | Legacy compatibility route for /api/v1/markets/exchanges/NGX/etfs/{symbol}. Prefer the Mansa Markets namespace for new integrations. |
| GET | `/api/ngxdata/etfs/resolve/{symbol}` | Legacy compatibility route for /api/v1/markets/exchanges/NGX/etfs/resolve/{symbol}. Prefer the Mansa Markets namespace for new integrations. |
| GET | `/api/v1/markets/forex` | Return current forex rates available through Mansa Markets. |
| GET | `/api/v1/markets/commodities` | Return commodity prices relevant to African producers and traders. |
| GET | `/api/v1/markets/exchange-metadata` | Return exchange metadata such as market type, settlement cycle, and website. |
| GET | `/api/v1/markets/calendar/{exchange_code}/is-open` | Return whether an exchange is open right now, with next open/close timestamps. Free tier. |
| GET | `/api/v1/markets/calendar/{exchange_code}` | Return the full trading calendar for an exchange: session times, timezone, trading days, settlement cycle, and public holidays for a year. Starter tier and a... |
| GET | `/api/v1/markets/exchanges/{exchange_code}/dividends-calendar` | Calendar-style dividends across all listed companies: ex-dividend, record, and pay dates with amounts. Filter by date range, symbol, or upcoming=true. NGX. S... |
| GET | `/api/v1/markets/bonds/{country}` | Return listed bonds (government local, eurobond, sukuk, corporate) with latest price and yield to maturity. Pro plan and above. |
| GET | `/api/v1/markets/yields/{country}/curve` | Return the current government yield curve: latest auction result per instrument and tenor. Pro plan and above. |
| GET | `/api/v1/markets/yields/{country}/tbills` | Return treasury bill auction results (stop rates, average yields, subscription), newest first. Pro plan and above. |
| GET | `/api/v1/markets/yields/{country}/auctions` | Return government debt auction history across instrument types. Pro plan and above. |
| GET | `/api/v1/macro/policy-rates` | Flagship all-Africa table: current central bank policy rate and latest inflation for every covered economy, each with source institution and URL. |
| GET | `/api/v1/macro/indicators` | All indicators for one country (?country=NG returns the live CBN set: policy rate, T-bill, interbank, lending rates, headline/food/core inflation), or a cont... |
| GET | `/api/v1/macro/{country}/{indicator}/history` | Monthly history for an indicator. Nigeria has full depth (policy rate and money market back to 2006, CPI splits). Starter tier and above. |
| GET | `/api/v1/fundamentals/{exchange_code}/{ticker}` | Return verified fundamentals for one listing: revenue, profits, balance sheet, EPS and DPS per fiscal period, plus derived ratios (net margin, ROE, ROA, payo... |
| GET | `/api/v1/metrics/{exchange_code}/{ticker}` | Return the full metric sheet for any of ~1,170 African listings: valuation, dividends, profitability, balance-sheet health, quality scores and analyst signal... |
| GET | `/api/v1/screener` | Screen 16 African exchanges — or the whole continent at once — by valuation, yield, profitability, balance-sheet health and analyst consensus. Verified NGX f... |
| GET | `/api/v1/identifiers/{exchange_code}/{ticker}` | Return the ISIN and FIGI for a single listing. Starter tier and above. |
| GET | `/api/v1/identifiers` | List or search the security master. Filter by exchange, or resolve an ISIN or FIGI back to its ticker and exchange. Starter tier and above. |
| GET | `/api/v1/location/countries` | Return African countries with optional region filter. |
| GET | `/api/v1/location/countries/{country_code}` | Return a single country profile by ISO2 or ISO3 code. |
| GET | `/api/v1/location/countries/{country_code}/states` | Return states, regions, counties, or provinces for supported countries with normalized admin_level_1 fields. |
| GET | `/api/v1/location/countries/{country_code}/states/{state_code}/lgas` | Return LGAs, districts, or sub-county units with normalized admin_level_2 fields. |
| GET | `/api/v1/location/countries/{country_code}/states/{state_code}/postal-codes` | Return Nigeria postal-code coverage for a state, with optional detailed LGA lookup. |
| GET | `/api/v1/location/countries/{country_code}/holidays/{year}` | Return public holidays for a country and year. Names are returned in English wherever the country publishes it; pass ?lang= for another (Kenya also publishes... |
| GET | `/api/v1/identity/banks` | Return bank and mobile-money institutions with optional filters. |
| GET | `/api/v1/identity/banks/{bank_code}` | Return a single bank or institution by bank code. |
| GET | `/api/v1/identity/mobile-networks` | Return mobile network operators with optional country filter. |
| GET | `/api/v1/identity/mobile-networks/lookup` | Return the mobile network that matches a phone number prefix. |
| GET | `/api/v1/identity/currencies` | Return African currency metadata with issuing countries. |

…and 1 more operations. They are listed in full on the page.

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/mansaapi-com/openapi/_original/mansaapi-com-api-openapi.json

## Other mansaapi-com APIs (1)

- [Mansa API](https://apis.io/apis/mansaapi-com/mansa-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mansaapi-com/mansa-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mansaapi-com/.