Get a Company Profile and Price Chart

This example fetches the full profile for Dangote Cement (DANGCEM), including sector, market cap, 52-week range, and current price, alongside a 30-day price history. You can substitute any NGX ticker symbol. Endpoints used:

GET /companies/:symbol (Starter plan)
GET /companies/:symbol/chart (Starter plan)

Step 1: Fetch the company profile

curl "https://api.ngnmarket.com/v1/companies/DANGCEM" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

const res = await fetch(
  'https://api.ngnmarket.com/v1/companies/DANGCEM',
  { headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' } }
);
const { data } = await res.json();
// data.current_price, data.market_cap, data.sector, etc.

import requests

res = requests.get(
    'https://api.ngnmarket.com/v1/companies/DANGCEM',
    headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
profile = res.json()['data']

Sample response (trimmed)

{
  "success": true,
  "data": {
    "symbol": "DANGCEM",
    "company_name": "Dangote Cement Plc",
    "sector": "Industrial Goods",
    "current_price": 302.50,
    "price_change": 4.00,
    "price_change_percent": 1.34,
    "market_cap": 5150820750000,
    "week_52_high": 325.00,
    "week_52_low": 241.00,
    "listing_date": "2010-10-26",
    "isin": "NGDANGCEM006"
  }
}

Step 2: Fetch the 30-day price chart

curl "https://api.ngnmarket.com/v1/companies/DANGCEM/chart?period=30d" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

const res = await fetch(
  'https://api.ngnmarket.com/v1/companies/DANGCEM/chart?period=30d',
  { headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' } }
);
const { data } = await res.json();
// data.data → array of daily price points

res = requests.get(
    'https://api.ngnmarket.com/v1/companies/DANGCEM/chart',
    params={'period': '30d'},
    headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
)
chart = res.json()['data']['data']

Sample response (trimmed)

{
  "success": true,
  "data": {
    "symbol": "DANGCEM",
    "period": "30d",
    "count": 22,
    "data": [
      {
        "date": "2026-04-17",
        "close_price": 302.50,
        "change": 4.00,
        "change_percent": 1.34
      },
      {
        "date": "2026-04-16",
        "close_price": 298.50,
        "change": -1.50,
        "change_percent": -0.50
      }
    ],
    "statistics": {
      "period_change": 18.50,
      "period_change_percent": 6.52,
      "min_price": 278.00,
      "max_price": 305.00
    }
  }
}

Fetch both calls in parallel

In JavaScript you can fire both requests simultaneously:

JavaScript

const [profileRes, chartRes] = await Promise.all([
  fetch('https://api.ngnmarket.com/v1/companies/DANGCEM', {
    headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
  }),
  fetch('https://api.ngnmarket.com/v1/companies/DANGCEM/chart?period=30d', {
    headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' },
  }),
]);

const [{ data: profile }, { data: chart }] = await Promise.all([
  profileRes.json(),
  chartRes.json(),
]);

Company detail reference

All fields returned by GET /companies/:symbol

Price chart reference

Parameters for GET /companies/:symbol/chart

​Step 1: Fetch the company profile

​Sample response (trimmed)

​Step 2: Fetch the 30-day price chart

​Sample response (trimmed)

​Fetch both calls in parallel

Company detail reference

Price chart reference

Step 1: Fetch the company profile

Sample response (trimmed)

Step 2: Fetch the 30-day price chart

Sample response (trimmed)

Fetch both calls in parallel