Fundamentals

Screen 16 African exchanges — or the whole continent at once — by valuation, yield, profitability, balance-sheet health and analyst consensus. Verified NGX figures override market data where available. Starter tier and above.

get/api/v1/screener

Request

  • Base URL: https://mansaapi.com
  • URL: https://mansaapi.com/api/v1/screener
  • Auth: HTTP bearer

Query parameters

exchangestring

Exchange code (NGX, JSE, EGX, NSE, GSE, ...) or ALL for the whole continent. Defaults to NGX.

pe_maxstring

Maximum trailing P/E, e.g. 5.

dividend_yield_minstring

Minimum dividend yield in percent, e.g. 8.

roe_minstring

Minimum return on equity in percent, e.g. 20.

pb_maxstring

Maximum price-to-book ratio.

z_minstring

Minimum Altman Z-score (financial health).

market_cap_usd_minstring

Minimum market cap in USD, e.g. 100000000.

consensusstring

Analyst consensus filter: buy, hold, sell, strong buy, strong sell.

verified_onlystring

true to return only rows with filing-verified fundamentals.

limitstring

Maximum results, capped at 500.

Response

Successful response

successboolean
dataobject
metaobject
paginationobject

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.