Account subscriptions - XOXNO Docs

Subscribe to account topics to receive finalized balance and nonce changes over the Relayer WebSocket.

Topics

Topic	Scope	Use when
`address/{bech32}`	One address	Track a wallet or contract.
`accounts`	Network-wide account deltas	Build an indexer or analytics pipeline.

The accounts topic is high volume. Use address/{bech32} for wallet and app-specific monitoring.

Request

{
  "action": "subscribe",
  "requestId": "acct-001",
  "topic": "address/erd1..."
}

Acknowledgment

{
  "action": "subscribe",
  "requestId": "acct-001",
  "status": "ok",
  "topic": "address/erd1..."
}

Pushed Event

{
  "type": "accountDelta",
  "data": {
    "address": "erd1...",
    "shardId": 0,
    "timestamp": 1738800000000,
    "balances": {
      "EGLD": "1000000000000000000"
    },
    "nonce": 42,
    "blockHash": "0x...",
    "blockNonce": 12345
  }
}

Limits

Limit	Value
Active topics	64 per WebSocket connection
Address format	Valid bech32 address starting with `erd1`
Delivery	After finalized block ingestion

Unsubscribe

{
  "action": "unsubscribe",
  "requestId": "acct-stop",
  "topic": "address/erd1..."
}

Reconnect Handling

Subscriptions belong to the socket. After reconnect, resubscribe to each address topic and de-duplicate events by address, blockNonce, and nonce.