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",
        "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/DANGCEM.png",
        "sector": "Industrial Goods",
        "sub_sector": "Building Materials",
        "market_classification": "Main Board",
        "shares_outstanding": 17040507405,
        "website": "https://dangotecement.com",
        "price": 302.5,
        "prev_close": 300,
        "day_high": 305,
        "day_low": 299.5,
        "volume": 1284729,
        "market_cap": 8291047302,
        "price_change": 2.5,
        "price_change_percent": 0.83,
        "change_7d_percent": 1.2,
        "change_52w_percent": 14.5,
        "high52wk": 320,
        "low52wk": 258,
        "last_updated": "2026-04-21T14:30:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 5,
      "total": 150,
      "total_pages": 30
    }
  },
  "meta": {
    "plan": "free",
    "calls_used": 42,
    "calls_remaining": 9958,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

Browse NGX-listed companies

Returns a paginated, filterable list of all NGX-listed companies with current price data. Filter by sector, search by name or ticker, sort by market cap, price, or other fields, and apply market-cap range filters.

Price fields (current_price, price_change, volume, etc.) reflect the most recent intraday data. Prices are refreshed every 20 minutes during NGX trading hours (Monday–Friday, 09:00–16:00 WAT). Outside trading hours, values reflect the most recent session close.

Plan required: Free

GET

/

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",
        "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/DANGCEM.png",
        "sector": "Industrial Goods",
        "sub_sector": "Building Materials",
        "market_classification": "Main Board",
        "shares_outstanding": 17040507405,
        "website": "https://dangotecement.com",
        "price": 302.5,
        "prev_close": 300,
        "day_high": 305,
        "day_low": 299.5,
        "volume": 1284729,
        "market_cap": 8291047302,
        "price_change": 2.5,
        "price_change_percent": 0.83,
        "change_7d_percent": 1.2,
        "change_52w_percent": 14.5,
        "high52wk": 320,
        "low52wk": 258,
        "last_updated": "2026-04-21T14:30:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 5,
      "total": 150,
      "total_pages": 30
    }
  },
  "meta": {
    "plan": "free",
    "calls_used": 42,
    "calls_remaining": 9958,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

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.

Show child attributes

data

object

Show child attributes