Skip to main content

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.

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 /v1/companies/:symbol (Starter plan)
  • GET /v1/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"

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

​
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 /v1/companies/:symbol

Price chart reference

Parameters for GET /v1/companies/:symbol/chart