> ## Documentation Index
> Fetch the complete documentation index at: https://xoxno.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Account subscriptions

> Subscribe to finalized MultiversX account balance and nonce changes by address or network-wide account topic.

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. |

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

## Request

```json theme={"system"}
{
  "action": "subscribe",
  "requestId": "acct-001",
  "topic": "address/erd1..."
}
```

## Acknowledgment

```json theme={"system"}
{
  "action": "subscribe",
  "requestId": "acct-001",
  "status": "ok",
  "topic": "address/erd1..."
}
```

## Pushed Event

```json theme={"system"}
{
  "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

```json theme={"system"}
{
  "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`.

## Related Pages

* [WebSocket lifecycle](/relayer/websocket-lifecycle)
* [accountDelta event schema](/api-reference/events/account-delta)
* [Connection limits](/relayer/connection-limits)