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

# Telegram BuyBot

> Add the official LFG.RICH BuyBot to your Telegram group and track live buys, borrows, prices, and token information.

The official LFG.RICH BuyBot helps communities follow live activity for LFG.RICH tokens directly inside Telegram groups.

<CardGroup cols={2}>
  <Card title="Live buy alerts" icon="bell">
    Show buy activity for official LFG.RICH tokens directly inside Telegram groups.
  </Card>

  <Card title="Borrow alerts" icon="landmark">
    Notify the community when users borrow against token collateral.
  </Card>

  <Card title="Token commands" icon="terminal">
    Use `/settoken`, `/deltoken`, `/tokens`, `/price`, `/info`, and `/lang` to manage the bot.
  </Card>

  <Card title="Group language" icon="language">
    Configure the bot language per Telegram group.
  </Card>
</CardGroup>

Bot username:

```txt theme={null}
@lfgdotrich_buybot
```

The bot tracks official LFG.RICH tokens on **BNB Smart Chain** and can post live alerts when a tracked token receives new buy or borrow activity.

<Info>
  The BuyBot is an information and notification tool. It does not trade for users, it does not ask for private keys, and it does not need wallet access.
</Info>

## What the BuyBot does

The BuyBot can help a token community:

* track one or more official LFG.RICH tokens inside a Telegram group;
* post live buy alerts when users buy the tracked token;
* post borrow alerts when users borrow against the tracked token;
* show current price information;
* show floor price information;
* show market cap, pool amount, 24h volume, 24h trades, holders, and chart links;
* support English and Chinese group messages.

## Before you start

You need:

* a Telegram group;
* permission to add the bot to the group;
* permission to give the bot admin rights so it can send messages;
* the LFG.RICH token contract address you want to track.

The token address must be a valid BSC contract address and must belong to a token created on LFG.RICH.

## Add the bot to your group

<Steps>
  <Step title="Open Telegram">
    Use the Telegram account that manages your token community group.
  </Step>

  <Step title="Search for @lfgdotrich_buybot">
    Find the official LFG.RICH BuyBot account.
  </Step>

  <Step title="Add the bot to your group">
    Add it to the Telegram group where you want alerts to appear.
  </Step>

  <Step title="Give the bot admin rights">
    The bot needs permission to send alert messages in the group.
  </Step>

  <Step title="Run /settoken">
    Start the token setup flow inside the group.
  </Step>

  <Step title="Choose the group language">
    Select the language the group should use for bot replies and alerts.
  </Step>

  <Step title="Send the official token contract address">
    Use the LFG.RICH token contract address, not a transaction hash, pair address, or pool ID.
  </Step>
</Steps>

<Info>
  Group setup must be completed by the group owner or by a group admin who has permission to add admins, because the bot needs admin rights to send alerts in the group.
</Info>

If Telegram does not show the bot commands in your group, use the command with the bot username:

```txt theme={null}
/settoken@lfgdotrich_buybot
```

## Track a token

Run:

```txt theme={null}
/settoken
```

The bot will ask you to choose a language, then it will ask for the token contract address.

Example token address:

```txt theme={null}
0x29Ede1E1254419Fe5a3c803fC2b015042075A49A
```

After the token is added, the bot starts tracking new activity for that token in the group.

<Warning>
  Only use the official LFG.RICH token contract address. Do not send pair addresses, pool IDs, or random copied addresses.
</Warning>

## Commands

| Command     | Who can use it | What it does                                                         |
| ----------- | -------------- | -------------------------------------------------------------------- |
| `/start`    | Anyone         | Shows the welcome message.                                           |
| `/help`     | Anyone         | Shows the list of available commands.                                |
| `/settoken` | Group admins   | Adds an LFG.RICH token tracker to the group.                         |
| `/deltoken` | Group admins   | Removes a tracked token from the group.                              |
| `/tokens`   | Anyone         | Lists the tokens currently tracked in the group.                     |
| `/price`    | Anyone         | Shows current price, floor price, and 24h change for tracked tokens. |
| `/info`     | Anyone         | Shows detailed token information for tracked tokens.                 |
| `/lang`     | Group admins   | Changes the bot language for the group.                              |

## Live alerts

When a tracked token receives new activity, the bot can post alerts in the group.

### Buy alerts

Buy alerts include:

* BNB amount;
* token amount;
* buyer wallet shortcut;
* current token price;
* market cap;
* pool amount;
* transaction link;
* LFG.RICH token page link.

### Borrow alerts

Borrow alerts include:

* borrowed BNB amount;
* collateral token amount;
* borrower wallet shortcut;
* transaction link;
* LFG.RICH token page link.

Borrow alerts are based on LFG.RICH protocol activity. They are informational only and do not mean the BuyBot is borrowing or trading for anyone.

## Price information

Use:

```txt theme={null}
/price
```

The bot shows price information for every tracked token in the group, including:

* current token price in USD and BNB;
* floor price;
* 24h price change.

The floor price is protocol data. For LFG.RICH V5 tokens, the floor is maintained by the Uniswap V4 Hook and is based on the token's all-time-high floor logic.

## Detailed token information

Use:

```txt theme={null}
/info
```

The bot shows detailed information for every tracked token in the group, including:

* price;
* floor price;
* market cap;
* pool amount;
* 24h volume;
* 24h trades;
* holder count;
* 24h price change;
* token page chart link.

## List tracked tokens

Use:

```txt theme={null}
/tokens
```

This shows the tokens currently tracked in the Telegram group.

## Remove a token

Run:

```txt theme={null}
/deltoken
```

The bot will show the currently tracked tokens and let a group admin choose which one to remove.

## Change language

Run:

```txt theme={null}
/lang
```

The bot currently supports English and Chinese group messages.

## Troubleshooting

### The commands do not appear in Telegram

Use the command with the bot username:

```txt theme={null}
/settoken@lfgdotrich_buybot
```

Also confirm the bot is still in the group and has permission to send messages.

### The bot does not send alerts

Check these points:

<Steps>
  <Step title="Confirm the token was added with /settoken">
    Run `/tokens` to check which tokens are configured for the group.
  </Step>

  <Step title="Confirm the address is the token contract">
    Do not use a transaction hash, pair address, or pool ID.
  </Step>

  <Step title="Confirm the token was created on LFG.RICH">
    The BuyBot is designed for official LFG.RICH tokens.
  </Step>

  <Step title="Confirm the bot can send messages">
    The bot must have permission to post in the group.
  </Step>

  <Step title="Confirm new activity occurred after setup">
    Alerts are generated from new buy or borrow activity after the token was added.
  </Step>
</Steps>

### The token address is rejected

Make sure you copied the token contract address from the LFG.RICH token page or an official source. The bot only tracks official LFG.RICH tokens.