TPS — Transactions Per Second

Subscribe

{"subscribe": ["TPS"]}

Message Format

{"seq": 43, "TPS": 2450}

Payload is a bare integer (not an object).

Description

TPS (Transactions Per Second) is a network throughput estimate. Calculated using a 2.5-block rolling window (~1 second at 400 ms block time).

  • Updated on every new block
  • On first subscribe, a snapshot of the current value is sent (if TPS > 0)
  • Value 0 = no data yet (server just started)

Usage Examples

TPS Dashboard

{"subscribe": ["TPS"]}
ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.TPS !== undefined) {
    updateDashboard(msg.tps);
  }
};

TPS + Block Events

{"subscribe": ["TPS", "BlockStart", "BlockFinalized"]}

REST Equivalent

curl http://localhost:8443/v1/tps
# {"tps": 2450}

Update Frequency

~2-3 times per second (depends on block time). Each TPS update is tied to a seq from the event ring.