Company Profile - NGN Market API

Full company profile

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

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

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