Market Snapshot - NGN Market API

Daily NGX market summary

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

{
  "success": true,
  "data": {
    "date": "2026-04-17",
    "asi": 105432.18,
    "asi_change": 876.44,
    "asi_change_percent": 0.84,
    "ytd_asi_change_percent": 12.37,
    "deals": 4821,
    "volume": 312847291,
    "value_traded": 4821093847,
    "turnover_rate": 0.0093,
    "market_cap": {
      "equity": 52109847302,
      "bonds": 5100000000,
      "etfs": 1081200000,
      "total": 58291047302
    },
    "breadth": {
      "advancers": 38,
      "decliners": 21,
      "unchanged": 14,
      "total": 73,
      "adv_dec_ratio": 1.81
    },
    "total_listed_securities": 158,
    "session": {
      "open_time": "10:00",
      "close_time": "14:30",
      "timezone": "Africa/Lagos"
    },
    "updated_at": "2026-04-17T18:00:00.000Z"
  },
  "meta": {
    "plan": "free",
    "calls_used": 1,
    "calls_remaining": 9999,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

GET

market

snapshot

Daily NGX market summary

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

{
  "success": true,
  "data": {
    "date": "2026-04-17",
    "asi": 105432.18,
    "asi_change": 876.44,
    "asi_change_percent": 0.84,
    "ytd_asi_change_percent": 12.37,
    "deals": 4821,
    "volume": 312847291,
    "value_traded": 4821093847,
    "turnover_rate": 0.0093,
    "market_cap": {
      "equity": 52109847302,
      "bonds": 5100000000,
      "etfs": 1081200000,
      "total": 58291047302
    },
    "breadth": {
      "advancers": 38,
      "decliners": 21,
      "unchanged": 14,
      "total": 73,
      "adv_dec_ratio": 1.81
    },
    "total_listed_securities": 158,
    "session": {
      "open_time": "10:00",
      "close_time": "14:30",
      "timezone": "Africa/Lagos"
    },
    "updated_at": "2026-04-17T18:00:00.000Z"
  },
  "meta": {
    "plan": "free",
    "calls_used": 1,
    "calls_remaining": 9999,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

The snapshot endpoint gives you a complete picture of any single NGX trading day in one request. You get the All Share Index (ASI) level (asi), its absolute and percentage change, naira value traded, total deals, share volume, and a market capitalisation breakdown across equities, bonds, and ETFs. The response also includes:

breadth — how many securities advanced, declined, or were unchanged in that session, plus the advance/decline ratio.
ytd_asi_change_percent — ASI return from the first trading day of the year, useful for YTD performance widgets.
turnover_rate — value traded as a percentage of equity market cap, a quick liquidity signal.
total_listed_securities — total companies listed on NGX.
session — NGX trading hours (10:00–14:30 WAT).

When no date is supplied the API returns the most recent available trading day automatically. To pull a specific historical day, pass date as YYYY-MM-DD:

curl "https://api.ngnmarket.com/v1/market/snapshot?date=2026-04-17" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

If the date is a weekend, public holiday, or any other non-trading day, the API responds with 404 NOT_FOUND. You can confirm valid dates with GET /market/available-dates.

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 (e.g. 2026-04-17). Omit for the latest available snapshot.

Example:

"2026-04-17"

Response

Market snapshot retrieved successfully.

success

boolean

required