Methodology

Where the data comes from.

Every number we serve should be traceable to a source and a timestamp. This page documents how each dataset is sourced and refreshed, what we know the data can’t do, and how corrections work.

DatasetSourceRefresh
Stock quotes, movers, index snapshots (20 exchanges)Official exchange publications and market operators30-minute target during market hours
Index history (NGX ASI from 1996, JSE from 1995, SEMDEX from 1990)Exchange archives and official index providersDaily
NGX dividends, disclosures, insider tradesNGX corporate disclosures and regulatory filingsDaily
Broker recommendations (NGX)Published broker research, aggregated to consensusWeekly
Fundamentals (revenue, profits, balance sheet, ratios)Official company filings — extracted, then human-verifiedPer filing season; only verified records are served
Macro indicators — Nigeria (MPR, money market, CPI splits)Central Bank of Nigeria public statistics, fetched liveHourly check against CBN; monthly series back to 2006
Macro indicators — other African economies (policy rate, inflation)Central bank decisions and national statistics offices, individually verified with source URL per valueRe-verified after each rate decision / CPI release
Government bonds, T-bill auctions, yield curvesExchange listings, debt management offices, and central bank auction resultsPer auction / trading session
Forex ratesOfficial published rates30-minute target
Commodity pricesPublic commodity benchmarksDaily
Banks, sort codes, SWIFT/BIC, USSD codesCentral bank registries (incl. CBN/NIBSS) and institution publicationsUpdated as institutions change; reviewed continuously
Mobile networks and prefix mappingRegulator numbering plans and operator publicationsUpdated as allocations change
Countries, states, LGAs, postal codesNational statistical and postal authoritiesReviewed quarterly
Public holidaysGovernment gazettes and official announcementsAnnually, plus ad-hoc government declarations
Verification

Fundamentals are human-verified.

Financial statement data is extracted from official company filings, then reviewed by a human before it is marked verified. The API serves only verified records, and every record links back to its source document so you can check our work.

Provenance

Freshness metadata in every response.

Markets responses carry freshness metadata — data_freshness in the meta object and per-row last_updated timestamps — so you always know how old a number is. The /health endpoint reports current freshness per suite.

Limitations

What this data is not.

  • Not tick data. Quotes target a 30-minute window during market hours — built for analysis, dashboards, and agents, not for execution systems.
  • Smaller exchanges have thin sessions. On low-volume days some frontier markets publish few trades; change figures fall back to the most recent traded session, which the timestamps make visible.
  • Identity data is reference data. Bank codes, NUBAN validation, and network lookup are structural checks — not live KYC, account-name resolution, or HLR verification.
  • Historical prices are as-published. We serve prices as exchanges published them; we do not currently back-adjust for splits or corporate actions.
Corrections

Correction policy.

Found a wrong number? Email api@mansamarkets.com with the endpoint, the value, and what you believe is correct. We investigate every report, aim to correct confirmed errors within two business days, and note material corrections in the changelog.