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 top 10 gainers and losers for the most recent NGX trading session. Useful for building a daily market summary widget or a leaderboard. Endpoint: GET /v1/market/movers (Starter plan)

​
Fetch gainers and losers

Omitting type returns both gainers and losers in a single response. 
curl "https://api.ngnmarket.com/v1/market/movers?limit=10" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

​
Sample response (trimmed)

{
  "success": true,
  "data": {
    "trade_date": "2026-04-17",
    "summary": {
      "total_gainers": 10,
      "total_losers": 10,
      "biggest_gainer": { "symbol": "OKOMUOIL", "change_percent": 9.94 },
      "biggest_loser":  { "symbol": "TRANSCORP", "change_percent": -9.80 }
    },
    "top_gainers": [
      {
        "symbol": "OKOMUOIL",
        "company_name": "Okomu Oil Palm",
        "sector": "Agriculture",
        "last_close": 364.50,
        "todays_close": 400.70,
        "change": 36.20,
        "change_percent": 9.94,
        "volume": 287340,
        "value_traded": 115073718
      }
    ],
    "top_losers": [
      {
        "symbol": "TRANSCORP",
        "company_name": "Transnational Corporation",
        "sector": "Conglomerates",
        "last_close": 10.20,
        "todays_close": 9.20,
        "change": -1.00,
        "change_percent": -9.80,
        "volume": 1820450,
        "value_traded": 16748140
      }
    ]
  }
}

​
Fetch only gainers or only losers

Pass type=gainers or type=losers if you only need one side:
curl
curl "https://api.ngnmarket.com/v1/market/movers?type=gainers&limit=5" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

​
Look up a mover’s full profile

Once you have a symbol from the movers list, fetch the full company profile:
JavaScript
const symbol = data.top_gainers[0].symbol; // e.g. "OKOMUOIL"

const profileRes = await fetch(
  `https://api.ngnmarket.com/v1/companies/${symbol}`,
  { headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' } }
);
const { data: profile } = await profileRes.json();

Movers reference

Full parameter list for GET /v1/market/movers