Skip to main content
Connect to wss://api.numofx.com/ws and subscribe to any number of channels. Each stream sends a snapshot, then a delta for every state change, using JSON text frames.

Update delivery

  • Updates are not batched or rate-limited. Each change is one frame with its own seq.
  • A quiet market can go minutes without a frame. The server still pings every 15 seconds and drops connections that miss pongs.
  • A fill’s trades, book and orders deltas arrive as one contiguous block of seq values.
A gap in seq means you missed an event, so resume.

Client frames

Subscribe

string
required
subscribe, unsubscribe, auth or ping.
string
book, trades or orders.
string
A market such as cNGN-30NOV26, or asset_address:sub_id. Required for book and trades, optional for orders.
integer
The last seq you processed. The server replays from there instead of sending a snapshot.
Subscribing twice to the same channel and market does nothing.

Unsubscribe

Ping

The server replies with { "type": "pong" }. Most clients can rely on protocol pings instead.

Server frames

Update payloads

Resume after reconnect

Track the highest seq you applied per channel and market, then subscribe with it:
The server replays what you missed. If since_seq is too old, you get resume_too_old and a fresh snapshot, so discard your local state and rebuild from it.

Authentication

Required before subscribing to orders. Sign this exact message with personal_sign, using unix seconds and no trailing newline:
Then send:
Use a unique nonce per frame and a short validity window, because the server enforces a maximum. Success returns { "type": "ack", "message": "authenticated" }, and the connection stays authorized until it closes. Order history frames are not accepted here.

Error codes