> ## 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.

# Get Today's Top Movers

> Fetch the biggest gainers and losers on the NGX for the latest trading session.

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.

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.ngnmarket.com/v1/market/movers?limit=10" \
    -H "Authorization: Bearer ngm_live_YOUR_KEY"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    'https://api.ngnmarket.com/v1/market/movers?limit=10',
    { headers: { Authorization: 'Bearer ngm_live_YOUR_KEY' } }
  );
  const { data } = await res.json();
  // data.top_gainers, data.top_losers, data.summary
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      'https://api.ngnmarket.com/v1/market/movers',
      params={'limit': 10},
      headers={'Authorization': 'Bearer ngm_live_YOUR_KEY'},
  )
  data = res.json()['data']
  gainers = data['top_gainers']
  losers  = data['top_losers']
  ```
</CodeGroup>

### Sample response (trimmed)

```json theme={null}
{
  "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:

```bash curl theme={null}
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 JavaScript theme={null}
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();
```

<Card title="Movers reference" icon="book" href="/api-reference/market/movers">
  Full parameter list for `GET /market/movers`
</Card>