Forex Rates

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

This pushes current exchange rates whenever they change, with the same derived fields GET /forex/current computes: inverse rate and day-over-day change. No query parameters. The REST endpoint scopes to one ?target= currency at a time; this channel sends every currency pair for every target at once, and target_currency on each entry tells you which one it is.

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

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

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

import WebSocket from 'ws';

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

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

import asyncio
import json
import websockets

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

asyncio.run(main())

Message format

snapshot arrives once on connect with every currency pair’s current rate. update arrives whenever any rate changes, and always carries the full list.

{
  "type": "update",
  "rates": [
    {
      "currency": "USD",
      "target_currency": "NGN",
      "rate": 1580.25,
      "inverse_rate": 0.000633,
      "daily_change": 2.15,
      "daily_change_percent": 0.1364,
      "last_updated": "2026-08-21",
      "last_updated_timestamp": 1787392834000
    },
    {
      "currency": "GBP",
      "target_currency": "NGN",
      "rate": 2015.80,
      "inverse_rate": 0.000496,
      "daily_change": -3.40,
      "daily_change_percent": -0.1684,
      "last_updated": "2026-08-21",
      "last_updated_timestamp": 1787392834000
    }
  ]
}

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