Market Movers - NGN Market API

Top gainers and losers

curl --request GET \
  --url https://api.ngnmarket.com/v1/market/movers \
  --header 'Authorization: Bearer <token>'

{
  "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.8
      }
    },
    "top_gainers": [
      {
        "symbol": "OKOMUOIL",
        "company_name": "Okomu Oil Palm",
        "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/OKOMUOIL.png",
        "sector": "Agriculture",
        "market_cap": 456800000000,
        "last_close": 364.5,
        "todays_close": 400.7,
        "change": 36.2,
        "change_percent": 9.94,
        "volume": 287340,
        "value_traded": 115073718,
        "trades": 412,
        "updated_at": "2026-04-17T18:00:00.000Z"
      }
    ],
    "top_losers": [
      {
        "symbol": "TRANSCORP",
        "company_name": "Transnational Corporation",
        "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/TRANSCORP.png",
        "sector": "Conglomerates",
        "market_cap": 87200000000,
        "last_close": 10.2,
        "todays_close": 9.2,
        "change": -1,
        "change_percent": -9.8,
        "volume": 1820450,
        "value_traded": 16748140,
        "trades": 831,
        "updated_at": "2026-04-17T18:00:00.000Z"
      }
    ]
  },
  "meta": {
    "plan": "growth",
    "calls_used": 210,
    "calls_remaining": 499790,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

market

movers

Top gainers and losers

curl --request GET \
  --url https://api.ngnmarket.com/v1/market/movers \
  --header 'Authorization: Bearer <token>'

{
  "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.8
      }
    },
    "top_gainers": [
      {
        "symbol": "OKOMUOIL",
        "company_name": "Okomu Oil Palm",
        "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/OKOMUOIL.png",
        "sector": "Agriculture",
        "market_cap": 456800000000,
        "last_close": 364.5,
        "todays_close": 400.7,
        "change": 36.2,
        "change_percent": 9.94,
        "volume": 287340,
        "value_traded": 115073718,
        "trades": 412,
        "updated_at": "2026-04-17T18:00:00.000Z"
      }
    ],
    "top_losers": [
      {
        "symbol": "TRANSCORP",
        "company_name": "Transnational Corporation",
        "logo_url": "https://cdn.jsdelivr.net/gh/ngnmarket/ngx-logos/dist/png/TRANSCORP.png",
        "sector": "Conglomerates",
        "market_cap": 87200000000,
        "last_close": 10.2,
        "todays_close": 9.2,
        "change": -1,
        "change_percent": -9.8,
        "volume": 1820450,
        "value_traded": 16748140,
        "trades": 831,
        "updated_at": "2026-04-17T18:00:00.000Z"
      }
    ]
  },
  "meta": {
    "plan": "growth",
    "calls_used": 210,
    "calls_remaining": 499790,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

The movers endpoint returns the biggest movers on the NGX for a given trading session — top gainers sorted by percentage gain and top losers sorted by percentage decline. Each entry includes logo_url, market_cap, previous close, today’s closing price, absolute and percentage change, volume, value traded, and trade count. Use the type filter to request only gainers or losers when building separate leaderboards. For example, to fetch the top 5 gainers for a specific session:

curl "https://api.ngnmarket.com/v1/market/movers?type=gainers&limit=5&date=2026-04-17" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

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.

Query Parameters

date

string<date>

Trading date in YYYY-MM-DD format. Omit for the most recent available day.

Example:

"2026-04-17"

limit

integer

default:10

Number of entries to return per category (gainers and losers each respect this limit). Maximum 50.

Required range: 1 <= x <= 50

type

enum<string>

Filter to a single category. Omit to receive both.

Available options:

gainers,

losers

Response

Market statistics retrieved successfully.

success

boolean

required