Changelog

What’s new in Mansa API.

Every new endpoint, dataset, field, and fix — dated. Subscribe via RSS or watch this page.

Improved

Holiday names now default to English, with ?lang= for local languages

  • Holiday names previously came back in each country's own default language — Kenya returned Swahili ("Mwaka mpya", "Ijumaa Kuu"), which surprised English-speaking integrations.
  • GET /api/v1/location/countries/{country_code}/holidays/{year} now returns English wherever a country publishes it, and falls back to the country's primary language otherwise.
  • Pass ?lang= to choose explicitly — ?lang=sw returns Swahili for Kenya. Unsupported values return 400 with the list of valid options.
  • Responses now include meta.language and meta.languages_available so you can see and discover what is on offer.
  • Heads-up: if you relied on Kenyan holiday names arriving in Swahili, add ?lang=sw to keep the previous behaviour.
New

SDKs for every stack: PHP and Flutter join Node and Python

  • composer require mansaapi/mansaapi — full-coverage PHP SDK (PHP 8.1+, zero dependencies, Laravel-ready).
  • dart pub add mansaapi — Dart/Flutter SDK with 51 methods across all suites, live-tested against production.
  • npm: mansaapi 0.1.1 fixes the movers return type ({gainers, losers}); pip install mansaapi now resolves correctly.
  • All four SDKs cover the complete surface: markets, calendars, yields, macro, fundamentals, identity, and location.
New

Agent pricing: prepaid credit packs

  • Pay as you go, no subscription: $5 = 7,500 calls, $20 = 35,000, $50 = 100,000. Credits kick in automatically when you pass your daily limit, work on any tier including Free, and never expire.
  • Buy from the pricing page in under a minute — if the email has no key yet, one is created and sent with the purchase.
  • Your credit balance is visible on the dashboard, and rate-limit errors now point to top-ups.
New

Dividends calendar + MCP server v1.1.0

  • GET /api/v1/markets/exchanges/NGX/dividends-calendar — upcoming and historical ex-dividend, record, and pay dates across all listed companies, filterable by date range and symbol (Starter+).
  • The official MCP server now exposes 21 tools — added policy rates, country macro indicators, macro history, market open status, yield curves, FX rates, and bank lookup, so AI agents can reason about African macro and fixed income, not just stocks.
New

Business tier, dunning, interactive docs, and the student program

  • New Business tier — $199/month: 100,000 requests/day, yields and full macro, redistribution-lite for derived datasets.
  • Fair dunning: a failed renewal starts a 7-day grace period with email warnings; only then does a key drop to Free. Keys are never deleted, and paying again restores the plan instantly.
  • Interactive API reference at /docs/api — try every endpoint in the browser with your own key.
  • Postman collection at /postman.json — import, set your key, go.
  • Smarter errors: unknown-ticker 404s now detect watchlist-style index symbols (^NGXASI, JSE:J203) and point to the indices endpoints; every error can carry a hint and docs link.
  • Student & hackathon program at /students — free Starter for African university students.
  • Built-with gallery at /built-with, and a Financial Modeling Prep comparison at /compare/financial-modeling-prep.
New

Status page and customer dashboard

  • /status — real uptime history: an independent monitor probes every suite every 5 minutes; 90-day daily bars, live latency, and current status per suite.
  • /dashboard — your API key is your login: live usage meter against your daily limit, recent request log, billing history, one-click key rotation, and self-serve subscription cancellation.
  • Viewing the dashboard never consumes quota.
New

Continental Fundamentals: screener and metric sheets for ~1,170 companies on 16 exchanges

  • GET /api/v1/screener now screens the whole continent — exchange=ALL with USD-normalized market caps, plus new filters: P/B max, Altman Z floor, minimum USD market cap, broker consensus, and verified_only for filing-checked rows (Starter+).
  • GET /api/v1/metrics/{exchange}/{ticker} — the full ~45-metric profile for any covered listing, grouped into valuation, dividends, profitability, balance-sheet health, and signals (Starter+).
  • Verified NGX names carry the filing-verified block with a link to the source document.
  • Data refreshes weekly across all 16 exchanges.
New

Self-serve checkout: Free → Pro in under two minutes

  • Pay by card directly from the pricing page — your API key is upgraded automatically the moment payment confirms. No emails, no waiting.
  • Monthly or annual billing (annual gets 2 months free), in USD, via Flutterwave.
  • Renewals and upgrades are verified server-side with the payment provider before any key changes.
New

Live data pages: central bank rates and market hours

  • /african-central-bank-rates — the all-Africa policy rate and inflation table, rendered from the same data the API serves.
  • /african-market-hours — live open/closed status for all 20 exchanges, refreshed every minute.
  • /african-bond-yields-api — coverage and examples for the yields and bonds endpoints.
New

Macro Suite: African policy rates and inflation, with Nigeria live from CBN

  • GET /api/v1/macro/policy-rates — the all-Africa table: current central bank policy rate and latest inflation for 18 economies (NG, EG, ZA, KE, GH, MA, TN, DZ, ET, TZ, UG, RW, ZM, AO, CI/BCEAO, CM/BEAC, BW, MZ), every value with source institution and source URL.
  • GET /api/v1/macro/indicators?country=NG — Nigeria served live from Central Bank of Nigeria statistics: MPR, treasury bill rate, interbank call rate, prime/max lending, and headline, food, and core inflation.
  • GET /api/v1/macro/{country}/{indicator}/history — monthly history; Nigeria's money market series reach back to January 2006 (Starter+).
  • GET /api/demo/policy-rates — the all-Africa policy rate table with no API key.
New

Yields & Bonds: African government debt via API

  • GET /api/v1/markets/yields/{country}/curve — current government yield curve built from the latest auction per tenor (Professional+).
  • GET /api/v1/markets/yields/{country}/tbills — treasury bill auction results with stop rates, average yields, and subscription levels (Professional+).
  • GET /api/v1/markets/yields/{country}/auctions — full auction history across instrument types (Professional+).
  • GET /api/v1/markets/bonds/{country} — listed bonds (government local, eurobonds, sukuk, corporate) with latest clean price and yield to maturity (Professional+).
  • Coverage: Nigeria, Ghana, Kenya, South Africa, Zambia, Malawi, Mauritius, Uganda, Tunisia, Algeria, Botswana, Eswatini, Cape Verde.
New

Trading Calendars: is-open checks and full market calendars for all 20 exchanges

  • GET /api/v1/markets/calendar/{exchange}/is-open — is the market open right now, with reason (market hours, weekend, public holiday, pre/after market), local time, and next open/close timestamps. Free tier.
  • GET /api/v1/markets/calendar/{exchange} — full trading calendar: session times, timezone, trading days (including Sun–Thu markets like EGX and SGBV), settlement cycle, and public holidays by year. Starter tier and above.
  • GET /api/demo/is-open — open/closed status for all 20 African exchanges at a glance, no API key required.
Fixed

Forex endpoint restored, now with per-pair provenance

  • GET /api/v1/markets/forex was querying a stale table and returning errors — now reads the canonical FX store.
  • Each rate now includes as_of and source fields, so you know exactly when and where every rate was published.
New

Trust pages, legal pages, and no-auth demo endpoints

  • Published this changelog, with entries backfilled to the March 2026 launch and an RSS feed at /changelog/rss.xml.
  • Data licensing page (/licensing): plain-English answers on display, caching, redistribution, AI training, and white-labeling per tier.
  • Methodology page (/methodology): data sources per suite, refresh cadence per dataset, known limitations, and our correction policy.
  • API versioning and deprecation policy (/docs/versioning): v1 stability commitment with a 12-month deprecation window for breaking changes.
  • Terms of Service and Privacy Policy published.
  • No-auth demo endpoints: /api/demo/movers, /api/demo/banks/{code}, and /api/demo/forex return real cached data with zero setup.
New

Fundamentals Suite: verified financial statements and screener

  • GET /api/v1/fundamentals/{exchange}/{ticker} — verified revenue, profits, balance sheet, EPS, DPS, and derived ratios (net margin, ROE, ROA, payout, P/E, dividend yield), each record linked to its source filing.
  • GET /api/v1/screener — screen stocks by valuation, dividend yield, ROE, revenue growth, and sector.
  • GET /api/v1/markets/indices/{code}/history — historical values for any African index by code, with custom date ranges.
New

Dar es Salaam Stock Exchange indices

  • DSE index endpoints: GET /api/v1/markets/exchanges/DSE/indices and per-index snapshots with history.
New

Exchange coverage expanded from 7 to 20 African exchanges

  • Live coverage now spans NGX, JSE, NSE Kenya, GSE, EGX, CSE Morocco, BRVM, DSE, LuSE, USE, RSE, MSE, ZSE, BSE, NSX, SEM, BVMT, SGBV, BVC, and SSX.
  • Pan-African movers, search, and trending endpoints aggregate across all 20 markets.
  • Site-wide redesign with a lighter, enterprise-grade theme.
New

Python SDK live on PyPI

  • pip install mansaapi — full parity with the Node SDK across Markets, Identity, and Location suites.
  • Python quickstart guide added to the docs.
Improved

Brand consolidation: Mansa Labs

  • All public surfaces now carry one entity name: Mansa Labs.
  • Blog launched with tutorials, comparison guides, and French and German bank-codes landing pages.
New

Premium NGX market signals

  • Dividend history with ex-dividend and payment dates: GET /api/v1/markets/exchanges/NGX/dividends/{ticker} (Starter+).
  • Corporate disclosures and regulatory filings: GET /api/v1/markets/exchanges/NGX/disclosures (Starter+).
  • Director dealings / insider trades: GET /api/v1/markets/exchanges/NGX/insider-trades (Professional+).
  • Weekly broker consensus with target prices: GET /api/v1/markets/exchanges/NGX/recommendations (Starter+).
  • Instant API key issuance — keys are now shown on screen at signup, no inbox round-trip.
New

Reference data pages and free tools

  • Programmatic reference pages: 77 bank pages, 53 country profiles, 37 Nigerian state pages with LGA tables, and 42 holiday-year pages.
  • Four free tools: bank code finder, phone network checker, NUBAN validator, and public holidays lookup.
New

Starter tier

  • New $19/month Starter tier: 1,000 requests/day plus dividends, disclosures, and broker recommendations.
Improved

X-API-Key header support

  • Authentication now accepts X-API-Key alongside Authorization: Bearer — easier integration with tools that follow either convention.
New

NGX ETFs and indices

  • Full NGX ETF universe: GET /api/v1/markets/exchanges/NGX/etfs with per-symbol lookups and legacy ticker resolution.
  • Complete NGX index universe (21 indices) including sector, pension, bond, and commodity benchmarks.
Improved

Pan-African movers across all markets

  • GET /api/v1/markets/movers/pan-african now ranks gainers and losers across every live exchange, with exchange_code on each row.
New

Price history, search, and trending

  • Stock price history with 1D–ALL ranges: GET /api/v1/markets/exchanges/{code}/stocks/{ticker}/history.
  • Cross-exchange search: GET /api/v1/markets/search.
  • Volume-based trending stocks: GET /api/v1/markets/trending.
  • Per-stock fundamentals summary: market cap, sector, 52-week range, dividend yield.
Improved

Request audit logs

  • Every API request is now logged for abuse prevention and usage analytics, and responses are explicitly non-cached for data freshness.
Fixed

Atomic rate limiting

  • Usage tracking moved to a single atomic database operation — eliminates race conditions in daily quota enforcement under concurrent load.
Improved

API key admin workflow

  • Key issuance emails and an internal admin review flow for paid-tier requests.
New

Health endpoint and AI agent docs

  • GET /health reports platform status and market data freshness.
  • AI agent guide published at /docs/ai-agents.
New

Mansa API launch

  • Initial release at mansaapi.com: Markets, Identity, and Location suites.
  • Identity: African banks with NIBSS, SWIFT, and USSD codes; mobile networks with prefix lookup; currencies.
  • Location: 54 country profiles, states and LGAs, Nigeria postal codes, public holidays.
  • Markets: live quotes, movers, forex, and commodities.
  • Machine-readable surfaces from day one: OpenAPI spec at /openapi.json and /llms.txt.