Dividends

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

This pushes newly-recorded dividend declarations as they happen, with the same fields GET /dividends/recent returns, including the company name and sector. No query parameters.

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

This channel works differently from Prices, Market Snapshot, Indices, and Forex Rates. Dividends 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/dividends?api_key=ngm_live_YOUR_KEY'
);

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

import WebSocket from 'ws';

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

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

import asyncio
import json
import websockets

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

asyncio.run(main())

Message format

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

{
  "type": "update",
  "dividends": [
    {
      "id": 3660,
      "symbol": "GTCO",
      "ex_dividend_date": "2026-09-01",
      "dividend": 3.50,
      "type": "Interim",
      "payment_date": "2026-09-15",
      "yield": 2.1,
      "company_name": "Guaranty Trust Holding Co",
      "sector": "Financial Services"
    }
  ]
}

An update can contain more than one dividend if several were recorded within the same five-second check interval. If nothing new was recorded, 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