> 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

Learn how to set up and configure 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="https://1366270868-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBEU5rdEjRFAAza5wsWRC%2Fuploads%2FuUNjvMmk6kE82nw4y3vb%2Fimage.png?alt=media&amp;token=e7b520d3-c86f-45ca-bfac-6ffe3dcff6bb" alt=""><figcaption><p>Buy alert example</p></figcaption></figure> <figure><img src="https://1366270868-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBEU5rdEjRFAAza5wsWRC%2Fuploads%2FByzeBYpS2zXrrf1ZcaH2%2Fimage.png?alt=media&amp;token=88259c4f-3b4e-480d-9106-36e9c8e02061" 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 😔