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

​
Topics

TopicScopeUse when
address/{bech32}One addressTrack a wallet or contract.
accountsNetwork-wide account deltasBuild 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

LimitValue
Active topics64 per WebSocket connection
Address formatValid bech32 address starting with erd1
DeliveryAfter 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.