> For the complete documentation index, see [llms.txt](https://docs.defined.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.defined.fi/defined-docs/defined-classic/telegram-bot-guide/create-and-manage-buy-bots.md).

# Create & Manage Buy-Bots

Show buys of a token in your Telegram group or Channel

## **Features**

1. **Real-Time Alerts:**
   * Tracks and displays purchases of a specified token on its associated network.
   * Shows key details, including:
     * **Purchase Amount**: The amount spent on the token.
     * **Buyer Wallet Address**: The address of the buyer.
     * **Token Information**: Additional token details.
2. **Customization:**
   * **Image Upload**: Allows users to upload an image that appears above each buy notification.
   * **Emoji Customization**: Set a specific emoji to highlight purchases.
   * **Emoji Frequency**: Adjust the number of emojis displayed based on the purchase size. (eg: 1 emoji for every $50 spent)

<figure><img src="https://1684109365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVOXpj9hcGfNWdz-V48%2Fuploads%2FKmRrpRHaRH0fR160zpfs%2Fimage.png?alt=media&amp;token=05cd0c8c-8494-4e07-bab2-7d31bf07e25a" alt="" width="303"><figcaption><p>Sample Buy-Bot notification</p></figcaption></figure>

## Managing your Buy-Bot

Once @defined\_bot is added to your Telegram group, you can select the "DM for settings" button, which will allow you to create buy-bots and track wallets for your select group. Only group admins can adjust settings for your buy-bot.

<figure><img src="https://1684109365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVOXpj9hcGfNWdz-V48%2Fuploads%2FWpqWBD0Hs7EFqejySgxN%2Fimage.png?alt=media&amp;token=004fa51b-e803-4921-8704-c72a277e0eb4" alt="" width="309"><figcaption></figcaption></figure>

After selecting "DM for settings" you will receive this message from @Defined\_bot:

<figure><img src="https://1684109365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVOXpj9hcGfNWdz-V48%2Fuploads%2FTRONNSPB2JvcHqUEiA4x%2Fimage.png?alt=media&amp;token=181a6623-787d-40e4-8180-72b4974b08e0" alt="" width="318"><figcaption></figcaption></figure>

Alternatively, you can enter the "/admin" command in your DM with @defined\_bot and select which group's bot you'd like to manage. This is useful when you manage several buy-bots in different Telegram groups/channels.

<figure><img src="https://1684109365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVOXpj9hcGfNWdz-V48%2Fuploads%2FeaHEDrcPYC2aAsSyP60m%2Fimage.png?alt=media&amp;token=714e4e31-2bec-47e9-aefd-d5f8ce0b95b4" alt="" width="368"><figcaption></figcaption></figure>

You are now able to manage your buy-bot and tracked wallets for your group!

***

## **Commands**

The following commands can be used in your Telegram Group/Channel but will be in view of everyone in the chat. Use "DM for Settings" to make changes in private.

* **`/buybot <address> <network> [emoji] [emoji-frequency]`**\
  Start buy notifications for a specific token.

  * **Parameters:**
    * `<address>`: Token contract address (e.g., `0x1f9840a85d5af5bf1d1762f925bdaddc4201f984`).
    * `<network>`: Blockchain network (e.g., Ethereum, Solana).
    * `[emoji]`: (Optional) Emoji to display with notifications (e.g., 🟢).
    * `[emoji-frequency]`: (Optional) Number of emojis to display per $ amount spent.

  **Example:**\
  `/buybot 0x1f9840a85d5af5bf1d1762f925bdaddc4201f984 Ethereum 🟢 100`

  * Tracks buys of the token on the Ethereum network.
  * Displays a green circle (🟢) emoji with notifications.
  * Displays one🟢 emoji for every $100 USD spent.
* **`/buybot stop`**\
  Stop all buy notifications from the bot in the Telegram channel.