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

# Telegram Quickstart

> Trade, scan tokens, and track wallets directly in Telegram

The Quickscope Telegram bot lets you trade and research tokens without leaving Telegram. Perfect for group chats, quick trades, and mobile trading.

## Getting Started

<Steps>
  <Step title="Start the Bot">
    Open [https://t.me/QuickscopeStagingBot](https://t.me/QuickscopeStagingBot) and send `/start`.
  </Step>

  <Step title="Connect Your Wallet">
    Send `/connect` and click the link to authorize via the web app.

    Your wallet syncs across web, mobile, and Telegram.
  </Step>

  <Step title="Start Trading">
    Scan a token or paste a contract address to see the trade menu.
  </Step>
</Steps>

## DM vs. Group vs. Channel

The bot works differently depending on where you use it:

| Context     | Best For        | Features                                       |
| ----------- | --------------- | ---------------------------------------------- |
| **DM**      | Private trading | Full menus, all commands, private receipts     |
| **Group**   | Social trading  | Scanning, calls, leaderboards, shared activity |
| **Channel** | Broadcasting    | Limited interaction, announcement-style        |

<Tip>
  Use DMs for actual trading. Use groups for scanning tokens and social features.
</Tip>

## Core Actions

### Scanning Tokens

Scan any token to see its info and trade menu:

```
/scan [contract address]
/scan [token name or symbol]
```

Or just paste a contract address directly. The bot will recognize it. You can also type `$symbol` (e.g., `$bonk`) to quickly scan by ticker.

**Scan results show:**

* Token name, price, market cap
* Volume and liquidity
* Holder count
* Quick trade buttons

For more on scanning and earning from your scans, see [Scanning & Sharing](/telegram/scanning).

### Trading

From any scan result, use the buttons to trade:

* **Buy buttons**: Preset amounts (0.1, 0.25, 0.5, 1, 2.5, 5 SOL by default)
* **Sell buttons**: Preset percentages (1%, 5%, 10%, 25%, 50%, 100% by default)
* **Custom amount**: Type a number to buy that amount in SOL

Trades execute using your saved settings (slippage, priority fee).

### Viewing Positions

Check your current holdings:

```
/positions
```

Shows all tokens you hold with current value and PnL.

## Quick Actions

The bot provides button menus after most commands. Common buttons:

| Button      | Action                           |
| ----------- | -------------------------------- |
| Buy amounts | Instant buy at that SOL amount   |
| Sell %s     | Sell that percentage of holdings |
| Chart       | View price chart                 |
| Holders     | See top holders                  |
| Refresh     | Update prices                    |

## Alerts

Quickscope's alert system is momentum-based – the bot monitors tokens for significant market cap movement and notifies you automatically when a token makes a sharp move. No manual price targets needed.

Group admins can tune alert sensitivity with `/triggerpercent` and `/triggerthresholds`. You can also forward group scans to your DM with `/forwardscans on` for centralised tracking.

For full details, see [Alerts](/telegram/alerts).

## Linking Your Web Account

Connect your Telegram to your Quickscope account to sync data and enable Telegram widgets on the desktop terminal.

<Tabs>
  <Tab title="From Web">
    1. Click **Connect Telegram** button in the top navigation
    2. Click **Log in as \[Your Name]** to authorize
    3. Sign a message with your wallet to complete the connection

    Authorization completes in a single step without needing to refresh.

    <Note>
      Quickscope can only view chats that have explicitly added the bot. The bot is used to populate Telegram widgets and enable full reward attribution.
    </Note>
  </Tab>

  <Tab title="From Telegram">
    1. Send `/connect` to the bot
    2. Click the link
    3. Authorize in your browser
  </Tab>
</Tabs>

Once linked, data syncs both ways. Telegram mentions appear on web, and web watchlists work in Telegram.

### Unlinking Telegram

If you need to disconnect your Telegram account, send `/unlink` or `/qgr` to the bot. You can also unlink from the web terminal under **Settings** › Telegram section.

## Key Commands

| Command         | Description                |
| --------------- | -------------------------- |
| `/start`        | Initialize the bot         |
| `/connect`      | Link your wallet           |
| `/help`         | Show all commands          |
| `/positions`    | View your holdings         |
| `/scan [token]` | Look up a token            |
| `/settings`     | Configure your preferences |

For the full command reference, see [Command Reference](/telegram/commands).

## Earn Rewards

Every action in Telegram can earn you rewards:

<CardGroup cols={2}>
  <Card title="Scan Tokens" icon="satellite-dish" href="/rewards/scan-rewards">
    Earn 20% of fees when others trade your scans
  </Card>

  <Card title="Trade" icon="right-left" href="/rewards/cashback">
    Get up to 30% cashback on your own trading fees
  </Card>

  <Card title="Refer Friends" icon="user-plus" href="/rewards/refer-earn">
    Earn 15% of their trading fees forever
  </Card>

  <Card title="Run a Group" icon="users" href="/telegram/group-leaders">
    Earn from all scans in your community
  </Card>
</CardGroup>

Check your rewards anytime with `/qri` or on the web Rewards tab.