Skip to main content
The server pushes this event at adaptive intervals tuned to block time. On /ws/stats, it arrives automatically. On /ws, subscribe to the networkStats topic. The payload includes schema versioning for forward compatibility.

Topic

Connect to wss://relayer.xoxno.com/ws/stats (automatic) or subscribe to networkStats on wss://relayer.xoxno.com/ws.

Event fields

type
string
Value is "networkStats".
schemaVersion
string
Semantic version of the schema (e.g., "1.1.0").
sequence
integer
Monotonically increasing frame counter. Use this to detect gaps.
ts
integer
Unix timestamp in milliseconds.
data
object
{
  "type": "networkStats",
  "schemaVersion": "1.1.0",
  "sequence": 4821,
  "ts": 1738800000000,
  "data": {
    "network": {
      "currentTps": 85.3,
      "avgTps10s": 82.1,
      "connectedPeers": 147,
      "activeValidators": 3200,
      "wsLagMs": 2
    },
    "blocks": {
      "latestShard": { "nonce": 19284712, "round": 19285000, "epoch": 1200 },
      "latestMeta": { "nonce": 19284700, "round": 19284950, "epoch": 1200 },
      "blockTimeMsP50ByShard": { "0": 6000, "1": 6100, "2": 5900 }
    },
    "mempool": {
      "estimatedQueue": 1240,
      "ingressTps": 90.5,
      "inclusionTps": 85.3,
      "pressure": 0.34
    },
    "validators": {
      "onlineByShard": { "0": 800, "1": 800, "2": 800, "meta": 800 },
      "totalOnline": 3200,
      "heartbeatRatePerSec": 12.5
    },
    "health": {
      "p2pDedupRatio1m": 0.92,
      "streamSubscribers": 45,
      "dataCompleteness": 1.0
    }
  }
}