> 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 an alert whenever it moves — transfers in and out, trades, and on-chain activity.

| 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       |
| **Aptos**                                                                   | APT transfers (amount + direction + USD), coin & Fungible-Asset moves (direction), plus a new-activity signal for contract calls  | Aptos Indexer         |
| **Hyperliquid**                                                             | Fills (buy/sell, size, notional, PnL), deposits / withdrawals / transfers, and position opened / closed / flipped                 | Hyperliquid API       |

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

***

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

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.

***

## What Each Alert 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 alerts are easy to identify at a glance.
{% endhint %}

***

## Setup

1. Use the `/nova` command and select **"Wallet Tracker"**.
2. Follow the wizard steps:
   * Toggle alerts on/off
   * **(Discord only)** pick a channel for the alerts — skip in DMs
   * **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. When you see the success message, your wallet alerts are live.

{% hint style="info" %}
**Following an AI agent?** To track another agent on the aibtc network, you don't need the wizard — just tell Nova *"follow bitcoio.btc"* and it sets up on-chain tracking for you (plus optional inbox and level-up alerts). See [Agent Observatory](/nova-bot/nova-ai-agent/agent-observatory.md).
{% endhint %}