Watchlist¶
Monitor tokens and wallets for suspicious activity with real-time alerts.
Overview¶
The Watchlist feature allows you to:
- Track specific tokens or wallets
- Get notified of suspicious activity
- Monitor scam rings
- Receive early warnings of rug pulls
Adding to Watchlist¶
Add a Token¶
- Search for a token on the Dashboard
- Click on the token to view details
- Click "Add to Watchlist" button
- Configure alert settings
- Click "Save"
Add a Wallet¶
- Search for a wallet address
- Click on the wallet to view details
- Click "Add to Watchlist" button
- Configure alert settings
- Click "Save"
Alert Types¶
Token Alerts¶
🚨 Rug Pull Warning¶
Triggered when:
- Liquidity drops > 50% in 1 hour
- Creator wallet sells > 20% of holdings
- Honeypot detected (can't sell)
- Freeze authority activated
Example:
🚨 RUG PULL WARNING
Token: SCAM (SCAM)
Address: ABC...123
Alert: Liquidity dropped 80% in 15 minutes
Before: $50,000
After: $10,000
Creator wallet sold 5M tokens ($40K)
Recommendation: SELL IMMEDIATELY if you can
📉 Price Drop Alert¶
Triggered when:
- Price drops > 30% in 1 hour
- Price drops > 50% in 24 hours
- Unusual selling pressure
Example:
📉 PRICE DROP ALERT
Token: MOON (MOON)
Address: DEF...456
Price: $0.05 → $0.02 (-60%)
Time: 2 hours
Volume: $100K (10x normal)
Possible causes:
- Whale dumping
- Bad news
- Market manipulation
📈 Unusual Activity¶
Triggered when:
- Volume spikes > 500%
- New large holders appear
- Suspicious transaction patterns
- Wash trading detected
Example:
📈 UNUSUAL ACTIVITY
Token: PUMP (PUMP)
Address: GHI...789
Alert: Volume spike +800%
Normal: $10K/day
Current: $80K/day
New whale holder: JKL...012 (10% of supply)
Possible pump & dump scheme
Wallet Alerts¶
🏭 New Token Created¶
Triggered when:
- Watched wallet deploys new token
- Especially useful for known scammers
Example:
🏭 NEW TOKEN CREATED
Creator: ABC...123 (Known Scammer)
Risk Score: 85/100
New Token: SCAM2 (SCAM2)
Address: MNO...345
Liquidity: $5,000
Initial Holders: 3
⚠️ WARNING: This creator has 15 previous scam tokens
Recommendation: AVOID
💸 Large Transfer¶
Triggered when:
- Transfer > $10,000 (configurable)
- Transfer to exchange (possible dump)
- Transfer to mixer (money laundering)
Example:
💸 LARGE TRANSFER
Wallet: DEF...456
Token: MOON (MOON)
Transfer: 10M MOON ($50K)
Destination: Binance Deposit Address
Possible rug pull in progress
Monitor liquidity closely
🔗 Cluster Activity¶
Triggered when:
- Multiple wallets in same cluster become active
- Coordinated buying/selling
- Scam ring activation
Example:
🔗 CLUSTER ACTIVITY
Cluster: Scam Ring #42
Wallets: 8 active
Activity:
- All wallets funded 0.1 SOL (same source)
- All buying same token: SCAM (SCAM)
- Coordinated timing (within 5 minutes)
⚠️ Possible wash trading or pump scheme
Alert Channels¶
Email Notifications¶
Receive alerts via email:
- Go to Settings → Notifications
- Enable "Email Alerts"
- Verify your email address
- Configure alert frequency:
- Instant (real-time)
- Hourly digest
- Daily digest
Example Email:
Subject: 🚨 RUG PULL WARNING - SCAM (SCAM)
Chain Sentinel Alert
Token: SCAM (SCAM)
Address: ABC...123
Liquidity dropped 80% in 15 minutes
Creator wallet sold 5M tokens ($40K)
View Details: https://app.chainsentinel.net/tokens/ABC...123
---
Manage Alerts: https://app.chainsentinel.net/settings
Telegram Notifications¶
Get instant alerts on Telegram:
- Go to Settings → Notifications
- Click "Connect Telegram"
- Start chat with @ChainSentinelBot
- Send
/startcommand - Click verification link
Example Telegram Message:
Webhook Integration¶
Send alerts to your own system:
- Go to Settings → Webhooks
- Add webhook URL
- Select alert types
- Test webhook
- Save
Webhook Payload:
{
"alert_type": "rug_pull_warning",
"severity": "critical",
"timestamp": "2026-01-10T12:34:56Z",
"token": {
"address": "ABC...123",
"name": "SCAM",
"symbol": "SCAM"
},
"details": {
"liquidity_change": -0.80,
"time_window": "15m",
"creator_sold": 5000000,
"creator_sold_usd": 40000
},
"recommendation": "SELL_IMMEDIATELY"
}
Alert Settings¶
Sensitivity Levels¶
Configure how sensitive alerts should be:
🔴 High Sensitivity¶
- All suspicious activity
- Minor price changes (> 10%)
- Small transfers (> $1K)
- More false positives
Use for: - High-risk tokens - Known scammer wallets - Active trading
🟡 Medium Sensitivity (Default)¶
- Significant activity
- Moderate price changes (> 30%)
- Medium transfers (> $10K)
- Balanced accuracy
Use for: - Most tokens - General monitoring - Passive investing
🟢 Low Sensitivity¶
- Critical events only
- Major price changes (> 50%)
- Large transfers (> $100K)
- Fewer false positives
Use for: - Established tokens - Long-term holds - Reduce noise
Custom Thresholds¶
Set your own alert thresholds:
Price Drop: > 40% in 1 hour
Liquidity Drop: > 60% in 1 hour
Transfer Amount: > $25,000
Volume Spike: > 300% of average
Watchlist Management¶
View Watchlist¶
Access your watchlist:
- Click "Watchlist" in navigation
- See all monitored items
- Filter by type (tokens/wallets)
- Sort by risk score or activity
Edit Watchlist Item¶
Modify alert settings:
- Click on watchlist item
- Click "Edit Settings"
- Update thresholds or channels
- Click "Save"
Remove from Watchlist¶
Stop monitoring:
- Click on watchlist item
- Click "Remove from Watchlist"
- Confirm removal
Watchlist Limits¶
Free Tier¶
- 5 items in watchlist
- Email alerts only
- Daily digest
- Basic alert types
Pro Tier ($49/month)¶
- 50 items in watchlist
- Email + Telegram alerts
- Real-time alerts
- All alert types
- Custom thresholds
- Webhook integration
Enterprise Tier (Custom)¶
- Unlimited items
- All Pro features
- Priority alerts
- Custom alert types
- Dedicated support
- API access
Best Practices¶
What to Watch¶
High Priority
- Tokens you own (protect your investment)
- Known scammer wallets (early warning)
- High-risk tokens (monitor for rug pull)
- Whale wallets (track large holders)
Medium Priority
- Tokens you're considering buying
- Creator wallets of your tokens
- Competitor tokens
- Market trend indicators
Alert Fatigue¶
Avoid too many alerts:
- Start with high-value items - Your largest holdings
- Use appropriate sensitivity - Don't set too sensitive
- Consolidate alerts - Use digest mode for low-priority items
- Review regularly - Remove items you no longer care about
- Prioritize channels - Critical alerts → Telegram, Others → Email
Response Plan¶
When you get an alert:
- Verify the alert - Check token page for details
- Assess severity - Is it critical or just unusual?
- Check multiple sources - Twitter, Telegram, other tools
- Make decision - Sell, hold, or buy more?
- Act quickly - Rug pulls happen fast
API Access¶
Manage watchlist programmatically:
import requests
headers = {"X-API-Key": "your_api_key"}
# Add to watchlist
requests.post(
"https://api.chainsentinel.net/watchlist",
headers=headers,
json={
"type": "token",
"address": "ABC...123",
"alerts": ["rug_pull", "price_drop"],
"sensitivity": "medium"
}
)
# Get watchlist
response = requests.get(
"https://api.chainsentinel.net/watchlist",
headers=headers
)
items = response.json()
# Remove from watchlist
requests.delete(
"https://api.chainsentinel.net/watchlist/123",
headers=headers
)
See API Reference for full documentation.
Troubleshooting¶
Not Receiving Alerts¶
- Check email spam folder - Alerts may be filtered
- Verify email address - Must be confirmed
- Check alert settings - Ensure alerts are enabled
- Test notification - Send test alert
- Check subscription - Some alerts require Pro tier
Too Many Alerts¶
- Reduce sensitivity - Switch to medium or low
- Increase thresholds - Higher price/volume changes
- Use digest mode - Hourly or daily instead of instant
- Remove low-priority items - Focus on important tokens
- Disable specific alert types - Keep only critical ones
False Positives¶
- Adjust thresholds - Reduce sensitivity
- Review alert logic - Understand what triggers alerts
- Check market conditions - High volatility = more alerts
- Whitelist known activity - Exclude expected events
- Report issues - Help us improve detection
Support¶
Need help with watchlist?
- 📧 Email: support@chainsentinel.net
- 💬 Telegram: @chainsentinel_net
- 📖 FAQ: Frequently Asked Questions