Address Tracking
Real-time push notifications when anything happens on a Counterparty address. The bot watches the blockchain so you don't have to.
How /track is Different
CounterTrader has three monitoring commands, each watching something different:
| Command | Watches | Alerts When |
|---|---|---|
| /watch | An asset's price | Floor price changes across venues |
| /alert | A price threshold | Asset crosses your target price |
| /track | An address's activity | Any on-chain event on that address |
Getting Started
The quickest way to start is to track your own wallet:
/track me
Starts monitoring your primary connected wallet
You'll get a confirmation with a link to customize your notification settings. From there, the bot checks your address every 3 minutes and DMs you when it detects activity.
Bootstrap Mode
The first time you track an address, the bot stores existing transaction hashes without sending notifications. This prevents you from being flooded with alerts for old activity.
Commands
/track
Show all tracked addresses and recent activity summary
/track me
Track your primary verified wallet
/track all
Track all your verified wallets (Premium)
/track 1ABC...xyz
Track an external address (Premium Plus)
/track remove 1ABC...xyz
Stop tracking an address
/track remove all
Clear all tracked addresses
/track settings 1ABC...xyz
Configure notification preferences for an address
Event Types
The bot detects six types of on-chain activity:
| Event | Description | Default |
|---|---|---|
| 🟢 Purchase | Asset bought via dispenser, DEX, or OTC | ON |
| 🔴 Sale | Asset sold via any venue | ON |
| 📥 Receive | Asset received from another address | ON |
| 📤 Send | Asset sent to another address | OFF |
| 🏪 Dispenser | New dispenser created by this address | ON |
| 📊 DEX Order | New DEX order placed by this address | OFF |
Sends and DEX orders are off by default because they can be noisy for active traders. Toggle them on per-address via /track settings.
Tier Access
| Tier | Requirement | Own Addresses | External | Events |
|---|---|---|---|---|
| Free | None | 1 | - | All 6 |
| Premium | 1+ CT | Unlimited | - | All 6 |
| Premium Plus | 2+ CT | Unlimited | 5 per extra CT* | All 6 |
*External address slots scale with your COUNTERTRADR balance: 2 CT = 5 slots, 3 CT = 10 slots, 4 CT = 15, and so on. Formula: (tokens - 1) × 5.
Notification Settings
Each tracked address has independent notification settings. Use /track settings <address> to:
- Toggle each of the 6 event types on or off
- Set a minimum USD value threshold — events below this are silently ignored (default: $10)
- Set a nickname for easier identification
Every alert DM includes Settings and Remove buttons for quick management without needing to type commands.
Whale Watching
Premium Plus Feature
Whale watching requires holding 2+ COUNTERTRADR tokens. Connect your wallet to check your balance.
Premium Plus users can track external addresses — any Counterparty address, not just their own. This is commonly called "whale watching": monitoring what the top collectors and traders are buying, selling, and moving.
/track 1WHALE...xyz
Start watching an external address
You'll get the same DM notifications as you do for your own addresses — purchases, sales, sends, receives — letting you see market activity before it shows up in price charts.
Privacy Note
All Counterparty activity is public blockchain data. Anyone can see these transactions on block explorers like tokenscan.io. The /track command simply delivers this public data as convenient push notifications — it does not expose any private information.
Use Cases
Security Monitoring (Free)
Track your own wallet and get alerted if anything leaves it unexpectedly. Enable "Sends" in your settings for complete outbound monitoring.
Portfolio Monitoring (Premium)
Track all your wallets at once. See purchases and sales across every venue without checking each address manually.
Whale Watching (Premium Plus)
Follow top collectors. See what they're accumulating before the rest of the market catches on. Use the min-value filter to only get notified about significant moves.
Tips
- Start with
/track me— it's free and useful for security alone - Enable "Sends" on your own wallet to catch unauthorized outbound transfers
- Set the min-value filter to $50+ for whale watching to avoid noise from small dispensers
- The bot checks every 3 minutes — you may see a slight delay compared to real-time block explorers