# 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="https://1684109365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVOXpj9hcGfNWdz-V48%2Fuploads%2FKmRrpRHaRH0fR160zpfs%2Fimage.png?alt=media&#x26;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&#x26;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&#x26;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&#x26;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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.defined.fi/defined-docs/defined-classic/telegram-bot-guide/create-and-manage-buy-bots.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.