Company Profile

Full company profile

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

import requests

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

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/{symbol}', 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/{symbol}",
  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/{symbol}"

	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/{symbol}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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": {
    "id": 12,
    "symbol": "DANGCEM",
    "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/DANGCEM.png",
    "international_sec_id": "NGDANGCEM0009",
    "name": "Dangote Cement Plc",
    "sector": "Industrial Goods",
    "sub_sector": "Building Materials",
    "market_classification": "Main Board",
    "shares_outstanding": 17040507405,
    "date_listed": "2010-10-26",
    "date_incorporated": "1992-11-04",
    "about": "Dangote Cement is Africa's largest cement producer with operations across Nigeria and 9 other African countries.",
    "website": "https://dangotecement.com",
    "email": "[email protected]",
    "phone": "+234 1 448 2200",
    "address": "Union Marble House, 1 Alfred Rewane Road, Ikoyi, Lagos",
    "nature_of_business": "Manufacture and sale of cement",
    "current_price": 302.5,
    "prev_close": 300,
    "open_price": 300,
    "day_high": 305,
    "day_low": 299.5,
    "volume": 1284729,
    "value_traded": 388431525.25,
    "market_cap": 5154853514312.5,
    "price_change": 2.5,
    "price_change_percent": 0.83,
    "high52wk": 320,
    "high_52wk_date": "2026-01-15",
    "low52wk": 258,
    "low_52wk_date": "2025-06-03",
    "ttm_eps": 24.12,
    "latest_equity": 1423900000000,
    "ttm_dividends": -206000000000,
    "last_updated": "2026-04-21T14:30:00.000Z"
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

companies

{symbol}

Full company profile

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

import requests

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

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/{symbol}', 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/{symbol}",
  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/{symbol}"

	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/{symbol}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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": {
    "id": 12,
    "symbol": "DANGCEM",
    "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/DANGCEM.png",
    "international_sec_id": "NGDANGCEM0009",
    "name": "Dangote Cement Plc",
    "sector": "Industrial Goods",
    "sub_sector": "Building Materials",
    "market_classification": "Main Board",
    "shares_outstanding": 17040507405,
    "date_listed": "2010-10-26",
    "date_incorporated": "1992-11-04",
    "about": "Dangote Cement is Africa's largest cement producer with operations across Nigeria and 9 other African countries.",
    "website": "https://dangotecement.com",
    "email": "[email protected]",
    "phone": "+234 1 448 2200",
    "address": "Union Marble House, 1 Alfred Rewane Road, Ikoyi, Lagos",
    "nature_of_business": "Manufacture and sale of cement",
    "current_price": 302.5,
    "prev_close": 300,
    "open_price": 300,
    "day_high": 305,
    "day_low": 299.5,
    "volume": 1284729,
    "value_traded": 388431525.25,
    "market_cap": 5154853514312.5,
    "price_change": 2.5,
    "price_change_percent": 0.83,
    "high52wk": 320,
    "high_52wk_date": "2026-01-15",
    "low52wk": 258,
    "low_52wk_date": "2025-06-03",
    "ttm_eps": 24.12,
    "latest_equity": 1423900000000,
    "ttm_dividends": -206000000000,
    "last_updated": "2026-04-21T14:30:00.000Z"
  },
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

The company detail endpoint returns everything you need to build a comprehensive company page: current price data, 52-week range, market cap, trailing EPS, sector classification, contact details, and a plain-language business description. It also returns pre-computed valuation and liquidity ratios derived from the latest available financial statements — so you don’t need to calculate these yourself:

pb_ratio — price-to-book (current price / book value per share)
debt_to_equity — total liabilities / shareholders’ equity
current_ratio — current assets / current liabilities
dividend_yield — from the most recent ex-dividend date

All ratio fields are null when the underlying financial data is not yet available for the company. The response also includes logo_url, a ready-to-use PNG for the company’s logo. Need a different format or size? See the company logos guide. The ticker symbol lookup is case-insensitive, so dangcem, DANGCEM, and DangCem all resolve to the same company. This endpoint requires a Starter plan or higher.

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.

Path Parameters

symbol

string

required

NGX ticker symbol (e.g. DANGCEM or GTCO). Case-insensitive.

Example:

"DANGCEM"

Response

Company detail 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

Path Parameters

Response