Skip to main content
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 /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 /market/movers