Watchlists
A watchlist is the list of tokens you’ve explicitly told Prysm to follow.
Every other tracking feature — /list, /compact, /detailed, alerts,
holdings, the chain-shortcut filters — reads from a watchlist. Pasting a
contract or running /add appends a row, /remove deletes one.
The thing that shapes the rest of the docs is scope: which watchlist a command sees depends on whether you’re in a DM with Prysm or in a group. The two are completely independent and stored separately.
Two scopes
Section titled “Two scopes”Prysm keeps two kinds of watchlist, and the chat you’re in picks the one a command sees.
| Personal (DM) | Group | |
|---|---|---|
| Belongs to | You | The Telegram group |
| Visible to | Only you | Everyone in the group |
| Created when | You first run /start | Prysm is added to the group |
| Filled by | /add, paste, /import | /add, paste, Silent Auto-Track |
| Empties when | You remove tokens | A group admin removes them; auto-tracked tokens also expire on a TTL |
| Holdings & portfolio | Tracked here | Not tracked |
| Per-topic scoping | Not applicable | Yes, when the group has forum mode on |
Adding a token in your DM does not add it to any group you’re in, and vice versa. If you want a token in both places, you add it in both places.
Manual rows vs. auto-tracked rows
Section titled “Manual rows vs. auto-tracked rows”Group watchlists actually carry two stacks of rows, and which one
/list shows depends on the group’s tracking mode:
- Manual rows are added explicitly — somebody ran
/add, or pasted a contract while the group was in Manual Mode. They stay until someone removes them. - Auto-tracked rows are added by Silent Auto-Track, the default mode for new groups. Every contract pasted in the chat is silently appended — no preview, no buttons. Each row has an expiry; if nobody mentions the token again before then, the row falls off on its own.
A group is in one mode at a time. Switching modes in /settings swaps
which stack /list reads from; the other stack is preserved, so
flipping back doesn’t lose anything.
What a watchlist row holds
Section titled “What a watchlist row holds”Each row is the link between a token and its owner — you, or a group. The token itself (chain, contract address, symbol, name, decimals, current price, market cap, 24h change, ATH data) is stored once and shared across everyone tracking it. The row that’s specific to your watchlist holds only:
- Personal row — the token reference, when you added it, when it
was last priced, and your holding amount for the token if you’ve
set one with
/setholding. - Group row — the token reference, who added it, when, and the forum-topic ID if the group is in forum mode. Auto-tracked rows also carry an expiry timestamp. There is no per-group holding amount — a group watchlist tracks tokens, not bags.
That’s why holdings, portfolio value, and personal alerts only make sense in a DM. They live on your row, not on the group’s.
How rows get added
Section titled “How rows get added”Four entry points:
- Paste a contract. In a DM, Prysm shows a preview and adds it. In a group with Silent Auto-Track on, it’s appended quietly; in Manual Mode you get a preview card with an explicit “Add” button.
/add <contract>— the typed equivalent. Works in both scopes./import— bulk-add from a previously exported list. DM only.- Silent Auto-Track — group only, on by default for new groups.
Persistence and ownership
Section titled “Persistence and ownership”Watchlists live in Prysm’s database, not in the chat history. A few things follow from that:
- Your DM watchlist is yours. Restarting Telegram, switching devices, or leaving and re-finding the bot doesn’t change it. Nobody else sees it.
- A group’s watchlist belongs to the group, not to whoever invited Prysm in. If the original inviter leaves, the watchlist stays.
- Re-adding Prysm to a group restores its watchlist. When the bot is removed, the group is marked inactive — not deleted. Adding it back reactivates the same record with every token, setting, and tracking mode intact.
- Group → supergroup migrations carry over. When a group upgrades to a supergroup (e.g. when forum topics are turned on), Prysm transfers every token, every auto-tracked row, and every setting to the new supergroup record automatically.
Limits
Section titled “Limits”Each watchlist has a default cap so the bot stays responsive for everyone using it.
The default cap is 5 tokens per personal watchlist and 6 per group watchlist. These numbers are read live and may have moved since the last time you checked.
If you bump up against either, /add will tell you the limit was
reached. If you genuinely need more room than the default — you’re
running an active trading group, you cover a lot of chains, etc. —
contact the bot owner to request a higher cap. There’s nothing to
configure on your side beyond asking.
Forum-topic scoping in groups
Section titled “Forum-topic scoping in groups”If your group has Telegram forum mode turned on (multiple topics
inside one chat), Prysm scopes group tokens per topic. A contract
pasted in the #meme-coins topic only shows up in /list when
/list is run from that same topic. Each topic effectively has its
own slice of the group watchlist.
This is automatic — there’s no setting to flip. The moment a group
becomes a forum, every new add records the topic it came from. The
admin-only /migrate command bridges the two states when a group
toggles forum mode on or off (it lifts null-topic rows into General,
or flattens topic-scoped rows back to null).
What /list actually looks like
Section titled “What /list actually looks like”Two tokens on a personal watchlist, sorted by 24h change (the default):
Watchlist Tracking 3 tokens 🔹 PEPE (Pepe) 🟢 +12.4% MCap: $5.2M | 📊 DS 🪙 BONK (Bonk) 🟢 +4.1% MCap: $1.8B | 📊 DS 🔸 CAKE (PancakeSwap) 🔴 -1.7% MCap: $612M | 📊 DS
Reading the row format:
- The leading emoji is the chain badge — 🔹 for Ethereum, 🪙 for Solana, 🔸 for BSC, etc. The full mapping lives on the supported chains page.
- The symbol (e.g. PEPE) is the ticker. The parenthesised name is a tappable link to the chain’s block explorer.
- The 🟢 / 🔴 marker plus percentage is the price change for your
configured period — 24h by default, configurable in
/settings. - The footer line shows market cap and a tappable chart link. The
chart provider — DexScreener, DexTools, Defined, or GMGN — is also
a
/settingschoice.
In a group running Silent Auto-Track, the same view appears, but the percentage is always 1h (auto-tracked rows are short-lived, so a 24h baseline rarely makes sense). Everything else renders identically.