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",
        "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

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