Market Snapshot

wss://api.ngnmarket.com/v1/ws/snapshot

This pushes the current trading-day summary whenever it changes. It’s the same object GET /market/snapshot returns, including breadth, turnover rate, and year-to-date change. No query parameters, so every connection receives the same data.

wss://api.ngnmarket.com/v1/ws/snapshot?api_key=ngm_live_YOUR_KEY

const ws = new WebSocket(
  'wss://api.ngnmarket.com/v1/ws/snapshot?api_key=ngm_live_YOUR_KEY'
);

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  console.log(msg.type, msg.snapshot);
};

import WebSocket from 'ws';

const ws = new WebSocket(
  'wss://api.ngnmarket.com/v1/ws/snapshot?api_key=ngm_live_YOUR_KEY'
);

ws.on('message', (data) => {
  const msg = JSON.parse(data.toString());
  console.log(msg.type, msg.snapshot);
});

import asyncio
import json
import websockets

async def main():
    url = "wss://api.ngnmarket.com/v1/ws/snapshot?api_key=ngm_live_YOUR_KEY"
    async with websockets.connect(url) as ws:
        async for raw in ws:
            msg = json.loads(raw)
            print(msg["type"], msg["snapshot"])

asyncio.run(main())

Message format

snapshot arrives once on connect. update arrives whenever the trading-day summary changes. Both carry the same shape: a single object, not a list.

{
  "type": "update",
  "snapshot": {
    "date": "2026-08-21",
    "asi": 104250.30,
    "asi_change": 850.20,
    "asi_change_percent": 0.82,
    "ytd_asi_change_percent": 58.88,
    "deals": 6420,
    "volume": 412300000,
    "value_traded": 8930000000,
    "turnover_rate": 0.0359,
    "market_cap": {
      "equity": 61500000000000,
      "bonds": 21000000000000,
      "etfs": 180000000000,
      "total": 82680000000000
    },
    "breadth": {
      "advancers": 27,
      "decliners": 32,
      "unchanged": 85,
      "total": 144,
      "adv_dec_ratio": 0.84
    },
    "total_listed_securities": 151,
    "session": {
      "open_time": "10:00",
      "close_time": "14:30",
      "timezone": "Africa/Lagos"
    },
    "updated_at": "2026-08-21T11:40:00.000Z"
  }
}

See Errors for connection-level error codes. This channel takes no parameters, so nothing about it specifically can fail.

Get Started

Channels

Reference

Message format

​Message format

Message format