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,bookandordersdeltas arrive as one contiguous block ofseqvalues.
seq means you missed an event, so resume.
Client frames
Subscribe
A market such as
cNGN-30NOV26, or asset_address:sub_id. Required for book and trades, optional for orders.Unsubscribe
Ping
{ "type": "pong" }. Most clients can rely on protocol pings instead.
Server frames
Update payloads
Resume after reconnect
Track the highestseq you applied per channel and market, then subscribe with it:
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 toorders. Sign this exact message with personal_sign, using unix seconds and no trailing newline:
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.

