---
id: nova/alerts/token-swaps
title: "Token Swaps Alerts"
description: "Monitor any Stacks token in real time — get an alert whenever someone buys (or sells) your tracked tokens, with customizable thresholds and visuals."
product: nova
canonical: https://zeroauthoritydao.ai/docs/nova/alerts/token-swaps
related: [nova/alerts]
tokens: 531
---

# Token Swaps Alerts

Track a Stacks token with /nova and get an alert on every buy (or sell) above your chosen USD threshold, with DEX, amounts, position change and your own emoji and image.

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

***

## What Each Alert 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 alert        |

***

## Setup

1. Use the `/nova` command and select **"Token Swaps"**.
2. Follow the wizard steps:
   * Toggle alerts on/off
   * **(Discord only)** pick a channel for the alerts — skip in DMs
   * **(Discord only)** confirm the blockchain (Stacks)
   * Enter the token's **smart contract address** (e.g. `SP123...::token-name`)
   * Choose alert mode: **Buys only** or **Buys & Sells**
   * Set a minimum transaction threshold: **$1**, **$10**, **$30**, **$100**, or **$1,000**
   * Select an **emoji** for your alerts
   * Upload a custom **image/GIF** or use the default
   * Review the summary and confirm
3. When you see the success message, your token swaps alerts are live.

***

## Configuration Options

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