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

action

string

required

Must be "subscribe".

topic

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

action

string

"subscribe"

status

string

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

topic

string

Topic that was subscribed.

reason

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"
}