Corporate Disclosures

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

This pushes newly-published corporate disclosures as they’re recorded, with the same fields and cleaned title text GET /disclosures returns. No query parameters.

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

This channel works differently from Prices, Market Snapshot, Indices, and Forex Rates. Disclosures are an append-only log, not a value that changes in place, so there’s no current state to repeat on every update. See Message format below.

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

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

import WebSocket from 'ws';

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

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

import asyncio
import json
import websockets

async def main():
    url = "wss://api.ngnmarket.com/v1/ws/disclosures?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["disclosures"])

asyncio.run(main())

Message format

snapshot arrives once on connect with the 20 most recent disclosures, so you have context right away. Every update after that contains only the disclosures published since your last message: never the full history again, and never one you’ve already received.

{
  "type": "update",
  "disclosures": [
    {
      "id": 2251,
      "title": "Unaudited Q2 2026 results",
      "company_name": "Dangote Cement Plc",
      "company_symbol": "DANGCEM",
      "isin": "NGDANGCEM001",
      "submission_type": "Financial Statement",
      "document_url": "https://doclib.ngxgroup.com/Financial_NewsDocs/...",
      "disclosed_at": "2026-08-21T09:15:00.000Z",
      "modified_at": "2026-08-21T09:15:00.000Z"
    }
  ]
}

title has any leading company-name prefix stripped and is sentence-cased. It’s the same cleanup GET /disclosures applies, so titles look the same whether you pull them from REST or from this channel. isin comes back as an empty string, not null, when NGX hasn’t recorded one for that filing.

An update can contain more than one disclosure if several were published within the same five-second check interval. If nothing new was published, no update message goes out at all. 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