# Token Swaps Alerts

{% hint style="info" %}
These notifications are available in Telegram groups/Discord servers and via Direct Messages.
{% endhint %}

| Plan    | Token Limit |
| ------- | ----------- |
| Free    | 3 tokens    |
| Premium | 20 tokens   |

***

### What You'll Get Notified About

Each swap notification includes:

| Field           | Description                                            |
| --------------- | ------------------------------------------------------ |
| Swap Direction  | Buy or Sell indicator                                  |
| Position Change | New Holder, Position Up, or Position Down              |
| Token Amounts   | From/To token quantities                               |
| USD Value       | Dollar value of the trade                              |
| DEX             | Which decentralized exchange the swap happened on      |
| Market Cap      | Current market cap (if available)                      |
| Custom Emoji    | Your chosen emoji displayed alongside the notification |

***

### Setup Token Swaps Tracker on Telegram

1. **Start Tracker Setting Process:**
   * Use the `/nova` command and select **"Token Swaps"**.
2. **Follow the command steps:**
   * Toggle notifications on/off
   * Enter the token's **smart contract address** (e.g., `SP123...::token-name`)
   * Choose notification mode: **Buys only** or **Buys & Sells**
   * Set a minimum transaction threshold: **$1**, **$10**, **$30**, **$100**, or **$1,000**
   * Select an **emoji** for your notifications
   * Upload a custom **image/GIF** or use the default
   * Review summary and confirm
3. **Success Confirmation:**
   * If you see the success message, congratulations!
   * You've set the token swap tracker successfully.

***

### Setup Token Swaps Tracker on Discord

1. **Start Tracker Setting Process:**
   * Use the `/nova` command and select **"Token Swaps"**.
2. **Follow the command steps:**
   * Toggle notifications on/off
   * **SKIP IF DM:** Select a "Channel" where to receive swap notifications
   * Confirm blockchain (Stacks)
   * Enter the token's **smart contract address**
   * Select an **emoji** for your notifications
   * Choose notification mode: **Buys only** or **Buys & Sells**
   * Set a minimum transaction threshold in USD
   * Upload a custom **image/GIF** or use the default
   * Review summary and confirm
3. **Success Confirmation:**
   * If you see the success message, congratulations!
   * You've set the token swap tracker successfully.

***

### Configuration Options

| Option             | Description                                   | Required |
| ------------------ | --------------------------------------------- | -------- |
| Contract address   | The Stacks token contract to monitor          | Yes      |
| Notification mode  | Buys only, or Buys & Sells                    | Yes      |
| Min. USD threshold | Ignore swaps below this dollar amount         | Yes      |
| Emoji              | Custom emoji displayed in notifications       | Yes      |
| Image              | Custom image/GIF uploaded to IPFS, or default | Optional |

\*\*\*

{% hint style="info" %}
You can only run one command session at a time. Use the `/cancel` command to abort a session.
{% endhint %}