Skip to main content
The REST API works on request and response: you ask, it answers. WebSocket flips that. You connect once, and the server pushes a message every time the underlying data changes, for as long as the connection stays open.
NGX equity prices update roughly every 20 minutes, not tick by tick. Live here means pushed the moment the data changes, not a constant stream of price movement.If you’re polling GET /companies on an interval to catch changes, a WebSocket connection gets you the same data faster and without wasted requests. You only hear from it when something actually changed.It carries no historical data, so keep using the REST endpoints for charts and history.

​
Base URL

Every channel is a path under this, authenticated with the same API key you already use for REST calls. The key travels as a query parameter instead of a header. See Authentication for why.

​
Available on every plan

Prices, market snapshot, indices, and forex rates are all available on the Free plan. None of them carry historical data, and their REST equivalents are free too. What actually scales by plan is how many connections you can hold open at once, and, on the prices channel, how many symbols one connection can request. See Limits for the full table.
WebSocket connections don’t count against your monthly REST quota. The two are tracked separately.

​
Channels

Prices

Current price for a symbol list you choose

Market snapshot

The daily ASI, volume, and value-traded summary

Indices

All NGX indices

Forex rates

Current NGN exchange rates

Corporate disclosures

New disclosure filings as they’re published

Dividends

New dividend declarations as they’re recorded

​
Get started

Quickstart

Connect to your first channel in under five minutes

Authentication

How your API key travels over a WebSocket handshake

Limits

Connection and symbol limits by plan

Errors

Every WebSocket-specific error code, and how to fix it