subscribe - XOXNO Docs

Subscribe to a topic to receive events. The Relayer acknowledges the subscription and starts pushing data immediately.

Endpoint

wss://relayer.xoxno.com/ws

string

required

Must be "subscribe".

string

required

Topic to subscribe to. Supported topics:

Topic	Description	Delivery
`gasStats`	Per-shard gas prices and PPU with percentiles	50 ms debounce / 5 s periodic
`networkStats`	Full network snapshot	Adaptive (tracks block time)
`accounts`	All account deltas network-wide	On each finalized block
`address/{bech32}`	Account deltas + tx status for a specific address	Event-driven
`tx-status/{hash}`	Status updates for a specific transaction	Event-driven

string

"subscribe"

string

"ok" on success, "fail" on error.

string

Topic that was subscribed.

string

Present when status is "fail". See the error table below.

Reason	Cause
`topic limit reached`	Connection has 64 active subscriptions
`rate limit exceeded`	More than 64 control messages in a 5-second window
`invalid bech32 address in topic`	Address failed bech32 validation
`unknown topic`	Topic matches no supported pattern

{
  "action": "subscribe",
  "topic": "address/erd1qyu5wthldzr8wx5c9ucg8kjagg0jfs53s8nr3zpz3hypefsdd8ssycr6th"
}

{
  "action": "subscribe",
  "status": "ok",
  "topic": "address/erd1qyu5wthldzr8wx5c9ucg8kjagg0jfs53s8nr3zpz3hypefsdd8ssycr6th"
}

{
  "action": "subscribe",
  "status": "fail",
  "reason": "topic limit reached"
}