> 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

## **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="/files/tH7oXUAB5tKBB8ArL7wo" 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="/files/0PA8tnnIQE4CNYXDo78d" alt="" width="309"><figcaption></figcaption></figure>

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

<figure><img src="/files/jcNV421m4ciJ1KOoeTf7" 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="/files/1eedu9kvXW3ax12AcJKp" 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.