# Mansa API - llms.txt
# African Data Infrastructure for Developers and AI Agents

Mansa API (https://mansaapi.com) provides REST APIs for African market data,
geographic data, and financial identity reference data.
Built in Lagos, Nigeria by Mansa Labs.

## Platform
- GET https://mansaapi.com/health

## Live Suites

### Mansa Markets
- GET https://mansaapi.com/api/v1/markets/exchanges
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/stocks
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/movers
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}/history
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/stocks/{ticker}/fundamentals
- GET https://mansaapi.com/api/v1/markets/search
- GET https://mansaapi.com/api/v1/markets/trending
- GET https://mansaapi.com/api/v1/markets/movers/pan-african
- GET https://mansaapi.com/api/v1/markets/indices
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/indices
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/indices/{code}
- GET https://mansaapi.com/api/v1/markets/exchanges/{exchange_code}/indices/{code}/history
- GET https://mansaapi.com/api/v1/markets/exchanges/NGX/indices
- GET https://mansaapi.com/api/v1/markets/exchanges/NGX/indices/{code}
- GET https://mansaapi.com/api/v1/markets/exchanges/NGX/etfs
- GET https://mansaapi.com/api/v1/markets/exchanges/NGX/etfs/{symbol}
- GET https://mansaapi.com/api/v1/markets/exchanges/NGX/etfs/resolve/{symbol}
- GET https://mansaapi.com/api/v1/markets/forex
- GET https://mansaapi.com/api/v1/markets/commodities
- GET https://mansaapi.com/api/v1/markets/exchange-metadata
- GET https://mansaapi.com/api/v1/markets/calendar/{exchange_code} (session times, trading days, settlement cycle, public holidays; starter tier+)
- GET https://mansaapi.com/api/v1/markets/calendar/{exchange_code}/is-open (is the market open right now + next open/close; free tier)
- GET https://mansaapi.com/api/v1/markets/bonds/{country} (listed bonds with latest price and YTM; Pro plan+)
- GET https://mansaapi.com/api/v1/markets/yields/{country}/curve (current government yield curve from auction results; Pro plan+)
- GET https://mansaapi.com/api/v1/markets/yields/{country}/tbills (treasury bill auction results; Pro plan+)
- GET https://mansaapi.com/api/v1/markets/yields/{country}/auctions (government debt auction history; Pro plan+)

Mansa Macro Suite — African macro indicators with provenance (source institution + URL) in every payload:
- GET https://mansaapi.com/api/v1/macro/policy-rates (flagship: policy rate + inflation for 18 African economies)
- GET https://mansaapi.com/api/v1/macro/indicators?country=NG (full live Nigeria set from CBN: MPR, T-bill, interbank, lending rates, headline/food/core CPI)
- GET https://mansaapi.com/api/v1/macro/{country}/{indicator}/history (monthly history; Nigeria back to 2006; starter tier+)

Mansa Fundamentals Suite — queryable fundamentals for ~1,170 companies across 16 African exchanges, refreshed weekly (starter tier+):
- GET https://mansaapi.com/api/v1/screener (continental screener; exchange=ALL or any exchange code; filters: pe_max, pb_max, dividend_yield_min, roe_min, z_min, market_cap_usd_min, consensus, verified_only)
- GET https://mansaapi.com/api/v1/metrics/{exchange_code}/{ticker} (~45-metric sheet: valuation, dividends, profitability, balance-sheet health, signals; USD market cap)
- GET https://mansaapi.com/api/v1/fundamentals/{exchange_code}/{ticker} (filing-verified statements with source-document links on covered NGX names)

Mansa Markets index coverage includes exchange benchmark and sector index snapshots plus history for tracked markets including DSE Tanzania. NGX instrument coverage includes equities, ETFs, and the full NGX index universe. The canonical ETF and index endpoints live in the Mansa Markets namespace and are database-backed, served from Supabase-backed snapshots, refreshed every 30 minutes, and intended for Mansa Markets ingestion.

Legacy compatibility routes remain available temporarily:
- GET https://mansaapi.com/api/ngxdata/indices
- GET https://mansaapi.com/api/ngxdata/indices/{code}
- GET https://mansaapi.com/api/ngxdata/etfs
- GET https://mansaapi.com/api/ngxdata/etfs/{symbol}
- GET https://mansaapi.com/api/ngxdata/etfs/resolve/{symbol}

### Mansa Location
- GET https://mansaapi.com/api/v1/location/countries
- GET https://mansaapi.com/api/v1/location/countries/{country_code}
- GET https://mansaapi.com/api/v1/location/countries/{country_code}/states
- GET https://mansaapi.com/api/v1/location/countries/{country_code}/states/{state_code}/lgas
- GET https://mansaapi.com/api/v1/location/countries/{country_code}/states/{state_code}/postal-codes
- GET https://mansaapi.com/api/v1/location/countries/{country_code}/holidays/{year}

### Mansa Identity
- GET https://mansaapi.com/api/v1/identity/banks
- GET https://mansaapi.com/api/v1/identity/banks/{bank_code}
- GET https://mansaapi.com/api/v1/identity/mobile-networks
- GET https://mansaapi.com/api/v1/identity/mobile-networks/lookup?phone=08031234567
- GET https://mansaapi.com/api/v1/identity/currencies
- GET https://mansaapi.com/api/v1/identity/currencies/{currency_code}

## Authentication
Bearer token.
Get a free key at:
- https://mansaapi.com/docs#get-api-key
- POST https://mansaapi.com/api/v1/keys

## Related
- Mansa Markets: https://mansamarkets.com
- NGX Pulse: https://ngxpulse.ng

## Machine-readable
- Docs: https://mansaapi.com/docs
- AI agents guide: https://mansaapi.com/docs/ai-agents
- OpenAPI: https://mansaapi.com/openapi.json
- Postman collection: https://mansaapi.com/postman.json
- MCP server (Streamable HTTP, no key required): https://mansaapi.com/api/mcp
  Tools: lookup_bank (reverse SWIFT/BIC and bank-code lookup), list_banks,
  resolve_nuban (which Nigerian banks a 10-digit account number is valid for),
  lookup_phone_network, get_public_holidays, get_currency.
- llms.txt: https://mansaapi.com/llms.txt