# Telegram and Discord bots

Source: https://www.solscanner.app/docs/bots

> Look up wallets and tokens, browse KOL and alpha traders, and track group token calls from Telegram or Discord.

Scanner has a Telegram bot and a Discord bot. Both let you check wallets and tokens without leaving chat, browse the [KOL tracker](/docs/trackers) and alpha trader leaderboards, and keep a leaderboard of token calls in your group or server. They work on Solana and Robinhood Chain (0x addresses). Alerts, KOL, identity, and PnL tools are Solana-only for now.

The bots are included on every plan, Free included.

How scans work [#how-scans-work]

The bots don't render full scan reports in chat (the one exception is Telegram's `/bm`, below). When you ask for a scan, you get a reply with buttons that open it in Scanner: the live bubble map, the full report, and your scan history. The scan runs there and uses your plan's scan allowance like any other scan: Deep 2, Max 4, token 1. See [Deep Scan](/docs/scanner) for what each depth covers and [Plans and access](/docs/access) for allowances.

Lookups that aren't scans cost nothing and need no account: balances, holdings, trades, identities, token cards, and the KOL and alpha leaderboards.

Add a bot [#add-a-bot]

Telegram [#telegram]

* **Private chat:** open the Scanner bot in Telegram and send `/start`.
* **Group:** add the bot to the group like any other member. It posts a welcome message listing the group commands.

In a group, `/link` and `/credits` reply to you in a private message so your account details stay out of the channel. Start a private chat with the bot first, otherwise it can't message you.

Discord [#discord]

Run `/setup` to get the install link and see whether auto-scan is on for your server. The bot asks for these permissions: View Channels, Send Messages, Embed Links, Attach Files (for charts and maps), and Read Message History.

Server-only commands such as `/leaderboard` only work inside a server, not in DMs.

Link your Scanner account [#link-your-scanner-account]

Linking ties the bot to your Scanner account, so scans, saved wallets, and alerts belong to you.

1. Send `/link` to the bot. It replies with a one-time code and a link to your settings.
2. Open the link while signed in, or paste the code under Telegram or Discord in [Settings](/dashboard/settings).

Telegram codes expire after 10 minutes. You can unlink either account from the same Settings page.

Pasting addresses and tickers [#pasting-addresses-and-tickers]

You don't always need a command:

* **Token contract:** paste a Solana mint or a 0x token and the bot replies with a token card (price, market cap, holders, socials, and trading links). In a group or server, the paste also counts as a call for the leaderboard.
* **`$TICKER`:** a ticker like `$BONK` resolves to the token and gets the same card.
* **Wallet:** a pasted wallet gets a quick balance summary with a button to open a Deep Scan. The scan itself only runs when you open it.

Auto-replies are throttled per user and per group, so repeating the same address a few seconds apart won't flood the chat. If the bot doesn't react to pastes in your group or server, auto-replies are off there; the commands below still work, and on Discord `/setup` shows the current status.

Group call tracking [#group-call-tracking]

Every token pasted in a group or server is recorded as a call by the person who posted it first. The bot then follows the token's peak after the call.

| Command        | What it shows                              |
| -------------- | ------------------------------------------ |
| `/leaderboard` | Members ranked by their best call          |
| `/calls`       | Recent token calls in this group or server |
| `/mycalls`     | Your own call stats and rank               |

Calls are tracked separately for each group or server.

Telegram commands [#telegram-commands]

Scanning [#scanning]

| Command               | What it does                                                                                         |
| --------------------- | ---------------------------------------------------------------------------------------------------- |
| `/scan <address>`     | Deep Scan a wallet or token. Accepts Solana addresses, token mints, `.sol` domains, and 0x addresses |
| `/scan <a> <b> ...`   | Open up to 5 addresses at once                                                                       |
| `/deepscan <address>` | Same as `/scan`                                                                                      |
| `/maxscan <address>`  | Max depth wallet scan                                                                                |
| `/contract <token>`   | Token holder scan. Aliases: `/x`, `/z`, `/h`, `/nh`                                                  |
| `/c <token>`          | Token trader scan (Solana only). Alias: `/cx`                                                        |
| `/bm <token>`         | Holder bubble map image right in chat. This runs a token scan on your linked account                 |

Wallets [#wallets]

| Command                 | What it does                                             |
| ----------------------- | -------------------------------------------------------- |
| `/holdings <address>`   | Token holdings and portfolio value                       |
| `/balance <address>`    | Quick liquid balance. Alias: `/w`                        |
| `/trades <address>`     | Trade history and realized PnL (Solana)                  |
| `/who <address> [more]` | Known identity or label for one or more wallets (Solana) |

KOLs and traders [#kols-and-traders]

| Command                                | What it does                                   |
| -------------------------------------- | ---------------------------------------------- |
| `/kol <name>`                          | Look up a KOL: PnL, wallets, and a scan button |
| `/compare <kol1>, <kol2>, ...`         | Compare up to 5 KOLs                           |
| `/alpha [1d\|7d\|30d]`                 | Top alpha traders leaderboard                  |
| `/recent`                              | Recently scanned wallets                       |
| `/submitkol <address> <twitter> <why>` | Nominate a wallet for the KOL directory        |

You can also type `@` followed by the bot's username and a name in any chat to autocomplete KOLs inline.

Alerts and saved wallets [#alerts-and-saved-wallets]

These need a linked account.

| Command                                              | What it does                                                                                                |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `/alert <address> [trades\|transfers\|both] [label]` | Watch a Solana wallet. `trades` covers swaps, `transfers` covers transfers over $100, `both` is the default |
| `/alerts`                                            | List your active alerts                                                                                     |
| `/unalert <address>`                                 | Stop watching a wallet                                                                                      |
| `/save <address> [name]`                             | Add a wallet to your [saved wallets](/docs/dashboard#saved-wallets)                                         |
| `/saved`                                             | List your saved wallets                                                                                     |
| `/unsave <address>`                                  | Remove a saved wallet                                                                                       |

Account [#account]

| Command               | What it does                                  |
| --------------------- | --------------------------------------------- |
| `/link`               | Link your Scanner account                     |
| `/credits`            | Scans remaining, 30-day usage, and scan costs |
| `/history`            | Your recent scans                             |
| `/feedback <message>` | Send feedback to the team                     |
| `/help`               | All commands and tips                         |

Discord commands [#discord-commands]

The Discord bot uses slash commands, so Discord shows each command's options as you type.

| Command                              | What it does                                                    |
| ------------------------------------ | --------------------------------------------------------------- |
| `/start`                             | Bot overview                                                    |
| `/setup`                             | Install link, permissions, and auto-scan status for this server |
| `/help`                              | All commands                                                    |
| `/scan address`                      | Open a wallet or token scan in Scanner. Solana or 0x            |
| `/contract`, `/x`, `/z`              | Open a token holder scan                                        |
| `/h`, `/nh`                          | Open a holder or notable-holder scan                            |
| `/c`, `/cx`                          | Open a token trader scan (Solana only)                          |
| `/bm`                                | Open a token bundle holder scan                                 |
| `/balance`, `/holdings`              | Native balance, liquid value, and token holdings                |
| `/trades`                            | Recent trades and PnL (Solana only)                             |
| `/who addresses`                     | Known KOL or entity labels for up to 10 wallets (Solana only)   |
| `/alpha period`                      | Top alpha traders for 1d, 7d, or 30d                            |
| `/recent`                            | Recently scanned wallets                                        |
| `/kol query`                         | Search known KOL wallets                                        |
| `/leaderboard`, `/calls`, `/mycalls` | Server call tracking                                            |
| `/link`                              | Get a code to link your Scanner account                         |
| `/credits`                           | Link to billing in your dashboard                               |

Alerts, saved wallets, KOL comparison, and scan history are Telegram-only. On Discord, use the [dashboard](/docs/dashboard) for those.
