Watchlists and Alerts🔖

Tracker is built around watchlists and live alerts.

If you remember only one thing, remember this:

• watchlist tells you what you are tracking
• alerts tell you what just happened

Watchlists🔖

A watchlist is the current set of wallets visible in one scope.

Depending on where you are, this can be:

• your private watchlist
• a group watchlist
• an admin-wide operator watchlist

What happens after you add a wallet🔖

After you add a wallet:

1. it becomes part of the watchlist for that scope
2. it can appear in snapshots
3. it becomes eligible for live alerts
4. you can open its wallet page in the Mini App or browser dashboard

If none of that happens, the first thing to check is whether you are looking at the right scope.

Private watchlists🔖

Use private watchlists when:

• you are tracking your own wallets
• you want a personal research list
• you do not want the list shared with a Telegram group

Private watchlist data stays in your private scope.

Group watchlists🔖

Use group watchlists when:

• you want a shared list for a community
• multiple group members need the same tracked wallets
• alerts should make sense in a single group context

Group watchlists stay in that specific group scope.

Automatic snapshots🔖

Automatic watchlist snapshots are optional.

They let Tracker post watchlist updates automatically for enabled private chats or groups instead of only replying when you request them manually.

Use:

• /watchlist auto on
• /watchlist auto off
• /watchlist auto status

if you want to control that behavior in private chat.

Typical private-chat flow:

1. Open your DM with the bot.
2. Send /watchlist to see a one-time snapshot.
3. If you want recurring automatic snapshots, send /watchlist auto on.
4. If you no longer want them, send /watchlist auto off.

What alerts are best for🔖

Alerts are best when you want to notice changes quickly.

Examples:

• a wallet bought a token
• a wallet sold a token
• a wallet moved assets
• a tracked token position changed meaningfully

The alert is your fast signal. The Mini App is where you inspect the full context.

What a live alert usually contains🔖

A typical swap alert can include:

• tracked wallet label
• trading venue such as STON.fi or DeDust.io
• action:
  • bought
  • sold
• token name and token address
• TON amount and USD value
• current balance after the trade
• realized PnL on sells
• Actual Mcap when Tracker has enough data to calculate it
• action links such as:
  • transaction
  • chart
  • DTrade
• Mini App

How to inspect an alert properly🔖

When you receive a live alert:

1. Read the wallet label at the top to confirm whose wallet moved.
2. Check the venue, such as STON.fi or DeDust.io.
3. Check whether it was a buy or a sell.
4. Compare the token amount with the TON amount spent or received.
5. Read the updated balance or PnL line if present.
6. Open:
   • the transaction link for chain confirmation
   • the chart link for market context
   • the Mini App link for deeper wallet detail

When to stay in Telegram and when to open the Mini App🔖

Stay in Telegram when:

• the alert already answers your question
• you only need a quick snapshot
• you just want to confirm that a buy or sell happened

Open the Mini App when:

• you want to inspect the full wallet
• you want token-level detail
• you want alert history
• you want to compare the latest alert with recent wallet activity

Why Actual Mcap may be missing🔖

Actual Mcap is shown only when Tracker can calculate it from available runtime data.

That usually means it needs:

• a usable token price
• a usable token supply

For launchpad and virtual-LP cases, Tracker may also use dedicated launchpad data when available.

If data is incomplete, the alert may omit Actual Mcap instead of showing a misleading value.

Alerts history and activity feed🔖

Inside the Mini App or browser dashboard you can open:

• alert history
• recent activity

Use alert history when you want a record of delivered alerts.

Use activity when you want a broader recent-event feed for the selected scope.

Favorites🔖

Favorites are a separate convenience list.

Use favorites when you want to pin a wallet for faster access without changing the underlying tracked rows.

Favorites do not replace watchlist tracking. They are only a shortcut layer.

Quick summary🔖

• Add wallets to the correct scope first.
• Use watchlists to see what is currently tracked.
• Use alerts to see what just happened.
• Open the Mini App when you need full context.