> For the complete documentation index, see [llms.txt](https://docs.billiondollarcat.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.billiondollarcat.com/billybot/rune-buy-alerts.md).

# 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 😔