> For the complete documentation index, see [llms.txt](https://docs.zeroauthority.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zeroauthority.xyz/nova-bot/alerts-setup-guides/wallet-tracker-alerts.md).

# Wallet Tracker Alerts

Monitor any wallet across **multiple chains** and get notified whenever it moves — transfers in and out, trades, and on-chain activity.

{% hint style="info" %}
These notifications are available in Telegram groups/Discord servers and via Direct Messages.
{% endhint %}

| Plan    | Address Limit | Custom Labels | Noise Filters |
| ------- | ------------- | ------------- | ------------- |
| Free    | 1 address     | --            | Yes           |
| Premium | 300 addresses | Yes           | Yes           |

The address limit is shared across every chain combined.

***

### Supported Chains

| Chain                                                                       | What's tracked                                                                                                                    | Data source (keyless) |
| --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
| **Stacks**                                                                  | Token transfers, contract calls, deployments                                                                                      | Stacks block feed     |
| **Ethereum / Base / Arbitrum / Optimism / Polygon / BNB Chain / Avalanche** | Native + ERC-20 transfers (with USD value) and ERC-721/1155 NFTs (collection, token id + image) in & out                          | Alchemy transfers     |
| **Solana**                                                                  | SOL & SPL token transfers (amount + direction + USD), plus a new-activity signal for the rest                                     | Solana RPC            |
| **Bitcoin**                                                                 | Native BTC received / sent                                                                                                        | mempool.space         |
| **TON**                                                                     | TON & jetton transfers (amount + direction; native TON in USD), plus a new-activity signal for swaps / NFT moves / contract calls | TON API               |
| **Sui**                                                                     | SUI transfers (amount + direction + USD), plus a new-activity signal for Move calls / object moves / non-SUI coin txs             | Sui GraphQL RPC       |
| **Hyperliquid**                                                             | Fills (buy/sell, size, notional, PnL), deposits / withdrawals / transfers, and position opened / closed / flipped                 | Hyperliquid API       |

{% hint style="info" %}
**Bitcoin Runes & BRC-20** wallet activity is planned and will switch on once a suitable data source is connected. On **Solana**, the most recent transfers are decoded to show the amount, direction and USD value (SOL & SPL tokens); higher-volume bursts beyond that fall back to a "wallet transacted" signal.
{% endhint %}

***

### Noise Filters

When you track a wallet on any non-Stacks chain you can tune what alerts you:

| Filter                  | Options                                    | Applies to        |
| ----------------------- | ------------------------------------------ | ----------------- |
| **Minimum value (USD)** | 0 (everything) · $100 · $1k · $10k · $100k | All polled chains |
| **Direction**           | Both · Incoming only · Outgoing only       | EVM & Bitcoin     |

{% hint style="info" %}
Transfers we can't price (some tokens) are **never silently dropped** — they pass the minimum-value filter so you don't miss a large move we couldn't value.
{% endhint %}

***

### What You'll Get Notified About

Each wallet notification includes:

| Field           | Description                                     |
| --------------- | ----------------------------------------------- |
| Chain           | Which network the activity happened on          |
| Tracked Address | The address (shortened), or your custom label   |
| Direction       | Received 📥 / Sent 📤 (transfers)               |
| Amount + Value  | Asset amount and its USD value (when available) |
| Counterparty    | The other address involved (when available)     |
| Explorer Links  | Direct links to the transaction and the wallet  |

{% hint style="success" %}
**Premium feature:** Add custom labels to tracked addresses (e.g., "Team Wallet", "DEX Treasury") so notifications are easy to identify at a glance.
{% endhint %}

***

### Setup Wallet Tracker on Telegram

1. **Start the tracker setup:**
   * Use the `/nova` command and select **"Wallet Tracker"**.
2. **Follow the steps:**
   * Toggle notifications on/off
   * **Select the blockchain** to track
   * Enter the **wallet address** for that chain
   * Choose your **minimum value** and (EVM/Bitcoin) **direction** filters
   * **Premium only:** Add a custom label for the address
   * Review and confirm
3. **Success Confirmation:**
   * If you see the success message, congratulations — your wallet tracker is live.

***

### Setup Wallet Tracker on Discord

1. **Start the tracker setup:**
   * Use the `/nova` command and select **"Wallet Tracker"**.
2. **Follow the steps:**
   * Toggle notifications on/off
   * **SKIP IF DM:** Select a "Channel" where to receive wallet notifications
   * **Select the blockchain** to track
   * Enter the **wallet address** for that chain
   * Choose your **minimum value** and (EVM/Bitcoin) **direction** filters
   * **Premium only:** Add a custom label for the address
   * Review and confirm
3. **Success Confirmation:**
   * If you see the success message, congratulations — your wallet tracker is live.

***

{% hint style="info" %}
You can only run one command session at a time. Use the `/cancel` command to abort a session.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zeroauthority.xyz/nova-bot/alerts-setup-guides/wallet-tracker-alerts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
