List Companies

Browse NGX-listed companies

curl --request GET \
  --url https://api.ngnmarket.com/v1/companies \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.ngnmarket.com/v1/companies"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ngnmarket.com/v1/companies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ngnmarket.com/v1/companies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ngnmarket.com/v1/companies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.ngnmarket.com/v1/companies")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ngnmarket.com/v1/companies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

GET

companies

Browse NGX-listed companies

curl --request GET \
  --url https://api.ngnmarket.com/v1/companies \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.ngnmarket.com/v1/companies"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ngnmarket.com/v1/companies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ngnmarket.com/v1/companies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ngnmarket.com/v1/companies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.ngnmarket.com/v1/companies")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.ngnmarket.com/v1/companies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

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, plus a logo_url you can drop straight into an <img> tag. Sort and filter options let you rank companies by any of these fields.

logo_url is a 200×200 PNG served from a CDN, ready to use with no setup. If you need WebP, favicon-sized ICOs, or logos bundled into your own build, see the company logos guide.

For example, to fetch the 25 largest Financial Services companies sorted by market cap:

curl "https://api.ngnmarket.com/v1/companies?sector=Financial%20Services&limit=25&sort=market_cap&order=desc" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

const url = new URL('https://api.ngnmarket.com/v1/companies');
url.searchParams.set('sector', 'Financial Services');
url.searchParams.set('limit', '25');
url.searchParams.set('sort', 'market_cap');
url.searchParams.set('order', 'desc');

const res = await fetch(url, {
  headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
});
const { data } = await res.json();

import requests

res = requests.get(
    'https://api.ngnmarket.com/v1/companies',
    params={
        'sector': 'Financial Services',
        'limit': 25,
        'sort': 'market_cap',
        'order': 'desc',
    },
    headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
data = res.json()['data']

Use search instead of sector for partial-match lookups by ticker or name (search=DAN matches DANGCEM).

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"

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

Using the API

Market Endpoints

Company Endpoints

Dividend Endpoints

Forex Endpoints

Index Endpoints

ETF Endpoints

Bond Endpoints

Disclosure Endpoints

Blog Endpoints

Account Endpoints

Authorizations

Query Parameters

Response