> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primal.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram bot

> Free Solana signals in Telegram: lane-routed calls, on-demand contract audits, and market-cap charts from the @primaldottrade bot.

The [@primaldottrade](https://t.me/primaldottrade) bot brings the signal engine to Telegram. The
best plays on Solana, the moment they fire, each backed by a full on-chain audit: dev, holders,
rug checks, top traders, and the market participants behind the move.

## Start it

DM [@primaldottrade](https://t.me/primaldottrade) and hit start. The setup lives right on the
first message: Settings, Help, Add to Group, and the terminal link.

<Frame>
  <img src="https://mintcdn.com/primaltrade/qOuXysqDLnz2ASPU/images/tg-start.png?fit=max&auto=format&n=qOuXysqDLnz2ASPU&q=85&s=1d7852ac7402b7a8cdcb4e24f19c8db2" alt="The /start reply: the primal. banner, what the bot does, and the setup buttons" width="388" data-path="images/tg-start.png" />
</Frame>

## Two ways to run it

* **DM it.** Open the bot, hit start, pick your feeds. Calls arrive as they qualify.
* **Add it to a group.** The bot registers the chat and posts calls and audits there. Group
  admins control the settings.

## Commands

| Command        | What it does                           |
| -------------- | -------------------------------------- |
| `/start`       | What the bot is, and the setup buttons |
| `/settings`    | Set up this chat: feeds, preferences   |
| `/feeds`       | Toggle feeds on and off                |
| `/trending`    | Hottest tokens right now               |
| `/leaderboard` | Best calls over 1d, 3d, 1w, 4w         |
| `/help`        | The command menu                       |

## Feeds

A chat subscribes to any subset of four feeds. Each call routes only to the chats subscribed to
its lane, so a Conviction-only group never sees Discovery noise.

| Feed              | What arrives                                                              |
| ----------------- | ------------------------------------------------------------------------- |
| 📡 **Discovery**  | First evidence. Earliest calls, highest risk                              |
| 🟠 **Heating**    | Escalating activity, more confirmation arriving                           |
| 🟢 **Conviction** | The most validated lane                                                   |
| 💎 **Prime**      | The qualifying calls from the [Alpha Prime](/alpha/prime-trending) record |

Toggle any of them from `/feeds` or `/settings`. Changes apply in place, per chat.

## What a call looks like

Every call and every audit renders the same way: the token card, the lane, live market state,
the stats block, the security verdicts, and the receipt line showing when the call was first
seen and at what market cap.

<Frame>
  <img src="https://mintcdn.com/primaltrade/qOuXysqDLnz2ASPU/images/tg-card.png?fit=max&auto=format&n=qOuXysqDLnz2ASPU&q=85&s=a64f1cba5cb1dd2f38d8e68da292c296" alt="A live call: token card, Heating lane, stats and security blocks, and the first-seen receipt with Audit and Chart buttons" width="388" data-path="images/tg-card.png" />
</Frame>

## The audit

Tap 🔬 **Audit** on any call, or paste any contract address into the chat (the bot catches CAs
inside image captions and edits too). The reply is the grouped breakdown: Dex paid status, the
rug block (mint and freeze authority, exit liquidity, suspicious holders), the holder cohorts,
the dev's history (launches, migrations, buys and sells), and the top traders verdict with their
current bag, weekly net, and realized profit.

<Frame>
  <img src="https://mintcdn.com/primaltrade/qOuXysqDLnz2ASPU/images/tg-audit.png?fit=max&auto=format&n=qOuXysqDLnz2ASPU&q=85&s=6085964117181dab3c7d42806253b71b" alt="The audit reply: Dex Paid, Rug, Holders, Dev, and Top Traders blocks with verdicts" width="388" data-path="images/tg-audit.png" />
</Frame>

## The chart

Tap 📈 **Chart** and the bot renders a market-cap candlestick card on demand: 12 candles at your
chosen timeframe (5m, 15m, 1h, 4h), the ATH marker, and the live cap tagged on the axis. Audit
and Refresh ride along, so the loop from chart to audit to fresh data never leaves the chat.

<Frame>
  <img src="https://mintcdn.com/primaltrade/qOuXysqDLnz2ASPU/images/tg-chart.png?fit=max&auto=format&n=qOuXysqDLnz2ASPU&q=85&s=a77cf7487ded9957d762a02766fc2435" alt="The chart reply: a 12-candle market-cap candlestick with ATH marker, timeframe buttons, Audit and Refresh" width="388" data-path="images/tg-chart.png" />
</Frame>

## Calls carry receipts

Every call the bot posts shows the entry market cap and time, and the leaderboard judges past
calls by exactly what subscribers saw. Same rule as the
[terminal's record](/alpha/prime-trending): it never repaints.

<Card title="Open the terminal" icon="bolt" href="https://primal.trade">
  The bot is the alert. The terminal is the execution.
</Card>
