Skip to main content
GET
/
v1
/
companies
Browse NGX-listed companies
curl --request GET \
  --url https://api.ngnmarket.com/v1/companies \
  --header 'Authorization: Bearer <token>'
{ "success": true, "data": { "data": [ { "id": 12, "symbol": "DANGCEM", "name": "Dangote Cement Plc", "sector": "Industrial Goods", "subSector": "Building Materials", "marketClassification": "Main Board", "sharesOutstanding": 17040507405, "website": "https://dangotecement.com", "price": 302.5, "prevClose": 300, "dayHigh": 305, "dayLow": 299.5, "volume": 1284729, "marketCap": 8291047302, "priceChange": 2.5, "priceChangePercent": 0.83, "change7dPercent": 1.2, "change52wPercent": 14.5, "high52wk": 320, "low52wk": 258, "lastUpdated": "2026-04-21T14:30:00.000Z" } ], "pagination": { "page": 1, "limit": 5, "total": 150, "totalPages": 30 } }, "meta": { "plan": "free", "calls_used": 42, "calls_remaining": 9958, "reset_at": "2026-05-01T00:00:00.000Z" } }
The list endpoint returns all companies currently listed on the Nigerian Exchange Group (NGX). You can paginate through results, narrow them to a specific sector, or search by company name or ticker symbol. Each company includes its current price, market capitalisation, trading volume, and percentage changes across multiple time frames. Sort and filter options let you rank companies by any of these fields.

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

​
page
integer
default:1

Page number to return. Starts at 1.

Required range: x >= 1
​
limit
integer
default:50

Number of results per page. Maximum 200.

Required range: 1 <= x <= 200
​
sector
string

Filter to a specific NGX sector. Must match exactly (e.g. Industrial Goods, Financial Services).

Example:

"Financial Services"

​
search
string

Search by company name or ticker symbol. Case-insensitive, partial match — DAN matches DANGCEM.

Example:

"DAN"

​
sort
enum<string>
default:market_cap

Field to sort results by.

Available options:
symbol,
company_name,
sector,
current_price,
market_cap,
volume,
price_change_percent,
shares_outstanding,
change_7d_percent,
change_52w_percent
​
order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
​
minMarketCap
number

Minimum market cap filter (in NGN).

​
maxMarketCap
number

Maximum market cap filter (in NGN).

Response

Companies retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object