> For the complete documentation index, see [llms.txt](https://docs.digitaldon.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitaldon.net/the-telegram-bot/commands.md).

# Command reference

Everything you can type at the bot. Seven commands, and you'll use one of them 95% of the time.

| Command                 | Where    | What it does                                                            |
| ----------------------- | -------- | ----------------------------------------------------------------------- |
| `/start`                | anywhere | Welcome message, a quick example, and an **➕ Add me to a group** button |
| `/help`                 | anywhere | This reference, inside Telegram                                         |
| `/don <token>`          | anywhere | **The main event.** Analyse a token by ticker, name or contract address |
| `/pnl <contract>`       | groups   | Call card: the group's first scan of a token vs. its peak since         |
| `/lb`                   | groups   | Leaderboard: the group's best callers over 1D / 1W / 2W / 1M / all time |
| `/setup`                | groups   | Reopen the group settings card. **Admins only**                         |
| `/autoscan on\|ta\|off` | groups   | Set auto-scan without opening the menu. **Admins only**                 |

`/leaderboard` works as a full-length alias for `/lb`.

***

## `/don <token>`

```
/don BONK
/don dogwifhat
/don EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
/don 0x4200000000000000000000000000000000000006
```

Accepts a ticker, a project name, or a contract address on any [supported chain](/getting-started/chains.md). If a ticker matches tokens on more than one chain you get a picker rather than a guess.

Returns a chart image plus the full analysis card — score, both trade plans, the category reads, on-chain sentiment. Full walkthrough: [Reading the analysis card](/the-telegram-bot/analysis-card.md).

Under the card, two optional buttons: **📣 Social Sentiment** and **👥 Holder Analysis**.

{% hint style="info" %}
**In a private chat, `/don` is optional.** Paste a contract or ticker on its own and you get the same card. In groups the command is required — otherwise the bot would have to answer every message in the chat.
{% endhint %}

## `/pnl <contract>`

Groups only. Renders a shareable card showing the group's **first** scan of that token versus its peak since — receipts for who called it and what it did.

Full detail: [PNL cards](/in-your-group/pnl-cards.md).

Requires the 🃏 **PNL cards** switch to be on. If an admin has turned it off, the command stays silent.

## `/lb`

Groups only. Ranks the group's callers by how their calls actually performed.

```
/lb          → last 24 hours (default)
/lb 1w       → last 7 days
/lb 2w       → last 14 days
/lb 1m       → last 30 days
/lb all      → all time
```

The same five timeframes are available as buttons under the board, which is the easier path — tapping one re-renders the board in place instead of posting a new message.

Full detail: [Leaderboard](/in-your-group/leaderboard.md).

Requires the 🏆 **Leaderboard** switch to be on.

## `/setup`

Admins only, groups only. Reopens the settings card — the same one the bot posts when it joins. Four switches, one tap each. See [Setting it up](/the-telegram-bot/setup.md).

Run in a private chat, it tells you it's a group command.

## `/autoscan on|ta|off`

Admins only, groups only. The typed equivalent of the auto-scan switches:

| Argument | Effect                                                              |
| -------- | ------------------------------------------------------------------- |
| `on`     | Auto-scan every pasted contract, including fresh launches           |
| `ta`     | Auto-scan only tokens with enough chart history for a real analysis |
| `off`    | Never answer a pasted contract                                      |

`ta` is the default state for a new group.

## `/help`

Prints the command list inside Telegram. It only advertises what's actually reachable — if an optional feature is switched off on this instance, its command and button aren't listed.

***

## Commands you won't see

A handful of additional commands exist for whoever operates the bot instance. They're restricted to the operator, they aren't listed in `/help` for anyone else, and they aren't documented here. Running one as a normal user gets you nothing useful.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.digitaldon.net/the-telegram-bot/commands.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.