# The calls commands

# The calls commands

Three commands read the calls database: `/mycalls`, `/viewallcalls`, and `/leaderboard`.

## Common to all three

*Where each command works*

| Command | Works in | Who |
| --- | --- | --- |
| /mycalls | Private chat or group | Anyone |
| /viewallcalls | Group only | Anyone in the chat |
| /leaderboard [window] | Group only | Anyone in the chat |

- The leading slash is optional, `@botname` after the command is accepted, and matching is case-insensitive.
- None of the three appears in the bot's `/` command menu.
- Forum topics are not separated: the group commands cover every call made anywhere in the group.
- While the scanner is off, all three reply with nothing, then answer again once it's back on.

## /mycalls

Lists your own calls on this bot, newest first, one row per coin. An anonymous admin post gets no reply.

*Row fields, in order*

| Field | Content |
| --- | --- |
| Number and symbol | `N. $MSAI` |
| Call market cap | `called at $MSAI`, or `no market cap at the call` |
| ATH since the call | `ATH $MSAI (Nx · +N%)`; dropped when the call had no market cap |
| Live market cap | `now $MSAI` |
| Age | `<age> ago` |

#### Header and a row

| Input | Output |
| --- | --- |
| Header | `🎯 <b>Your calls</b> · 2 coins` |
| Row | `1. <b>$MSAI</b> · called at <b>$500M</b> · ATH <b>$500M</b> (<b>1.00x</b> · +0.0%) · now $250M · 1m ago` |

*Reply when the sender has made no calls*

```
You haven't called any coins yet — paste a contract address in a group to make a call.
```

## /viewallcalls

Lists every call made in the current group, one row per coin, best all-time-high multiple first. Calls that never had a market cap sort last.

*Row fields, in order*

| Field | Content |
| --- | --- |
| Number, symbol, caller | `N. $MSAI by <caller>` |
| Call → ATH | `$MSAI → ATH $MSAI (Nx · +N%)`, or `no market cap at the call` |
| Age | `<age> ago` |

#### Header and a row

| Input | Output |
| --- | --- |
| Header | `🏆 <b>All calls in Test Group</b> · 2` |
| Row | `1. <b>$MSAI</b> by <a href="tg://user?id=777">@chris</a> · <b>$420M</b> → ATH <b>$1.26B</b> (<b>3.00x</b> · +200%) · 1m ago` |

*Reply when the group has no calls*

```
No calls in this group yet — paste a contract address to make the first one.
```

## /leaderboard [window]

Ranks the group's calls the same way `/viewallcalls` does, within a time window. Calls with no market cap are left out.

*Accepted window tokens, case-insensitive*

| Window | Tokens | Label shown |
| --- | --- | --- |
| All time | nothing, or `all` | all time |
| 1 day | `1`, `1d`, `d`, `24h` | last 24 h |
| 7 days | `7`, `7d`, `w`, `1w` | last 7 days |
| 30 days | `30`, `30d`, `m`, `1m` | last 30 days |

Where a coin has more than one call inside the window, the earliest one is the row shown.

#### Header (all time)

| Input | Output |
| --- | --- |
| Header | `🏆 <b>Leaderboard · Test Group</b> · all time · 2` |

*Row shape is identical to `/viewallcalls`.*

*Reply to an unrecognized window, e.g. /leaderboard 99y*

```
🏆 <b>/leaderboard</b> — all time · <b>1d</b> · <b>7d</b> · <b>30d</b>
```

*Reply when no call in the window is rankable, e.g. all time*

```
No ranked calls in this group (all time) — paste a contract address to make one.
```

- [Turning the scanner on and off](/scanner/calls-toggle)