# Rune Buy Alerts

## Celebrate new buys and holders

Alert a Telegram group chat when someone buys a Rune on [MagicEden](https://magiceden.io/runes/BILLION%E2%80%A2DOLLAR%E2%80%A2CAT), [OKX](https://www.dotswap.app/swap#R_BTC_BILLION%E2%80%A2DOLLAR%E2%80%A2CAT), or [DotSwap](https://www.dotswap.app/swap#R_BTC_BILLIONDOLLARCAT).

<div align="left"><figure><img src="/files/4oFQvgVZRlZNdxUZGPkz" alt=""><figcaption><p>Buy alert example</p></figcaption></figure> <figure><img src="/files/4V8GzLbrXerks3iSvebG" alt=""><figcaption><p>Sweep alert example</p></figcaption></figure></div>

## Setup

{% hint style="info" %}
**Telegram Command**

`/buys register BILLION•DOLLAR•CAT`

You can replace `BILLION•DOLLAR•CAT` with any other rune.
{% endhint %}

{% hint style="warning" %}
Alert features only work in Telegram **group** chats and configurable by the group chat owner.
{% endhint %}

1. Ensure `BillyBot` is added to your group chat as an admin. If not, follow the [**Quickstart**](/billybot/quickstart.md) guide.
2. Send a message: `/buys register RUNE•NAME` (replace RUNE•NAME with your rune)
3. Configure buy alerts using the other `/buys` commands 👇

## Configuration

* `/buys gif` - Set a custom gif image for all buy alerts (BillyBot requires admin permissions)
  * `/buys gif new-holder` - Set a custom for new holder buy alerts
  * `/buys gif big-buy` - Set a custom for ***big*** buy alerts (default: buys over $1,000)
* `/buys minimum $100` - Set minimum dollar amount for all buy alerts
* `/buys big-buy $1000` - Set minimum dollar amount for ***big*** buy alerts
* `/buys ticker $BDC` - Set custom ticker for amounts in the buy alert (example: 100 $BDC)
* `/buys` - See this list of supported buy alert commands

Make sure to configure the minimum USD amount if you only want to alert for higher value buys.

## Disabling alerts

Use `/buys unregister` to disable rune buy alerts 😔


---

# 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.billiondollarcat.com/billybot/rune-buy-alerts.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.