Alerts & Notifications¶

Stay informed about suspicious activity with real-time alerts from Chain Sentinel.

Overview¶

Chain Sentinel's alert system monitors the Solana blockchain 24/7 and notifies you of:

Potential rug pulls
Suspicious wallet activity
New scam tokens
Market manipulation
Unusual trading patterns

Alert Categories¶

🚨 Critical Alerts¶

Immediate action required:

Rug Pull in Progress¶

Liquidity drained > 70%
Creator wallet dumping
Honeypot activated
Freeze authority used

Response: Sell immediately if possible

Honeypot Detected¶

Token allows buying but not selling
Sell function disabled or restricted
Hidden fees > 50%

Response: Do not buy, warn others

Scam Ring Activation¶

Multiple coordinated wallets active
Known scammer deploying new token
Cluster of suspicious activity

Response: Avoid all related tokens

⚠️ Warning Alerts¶

Requires attention:

High Risk Token¶

AI prediction: SCAM (> 80% confidence)
Multiple risk indicators
Suspicious creator history

Response: Investigate before buying

Unusual Activity¶

Volume spike > 500%
Price manipulation detected
Wash trading patterns

Response: Monitor closely, be cautious

Large Holder Movement¶

Whale selling > 10% of holdings
Top holder transferring to exchange
Coordinated selling

Response: Consider reducing position

ℹ️ Info Alerts¶

For your awareness:

New Token from Watched Creator¶

Creator you're monitoring deployed new token
May be legitimate or scam

Response: Analyze before investing

Market Trend¶

Sector-wide movement
Correlation with major tokens
General market sentiment

Response: Context for your holdings

Milestone Reached¶

Token reached holder count milestone
Liquidity milestone
Volume milestone

Response: Positive indicator

Alert Channels¶

Email Notifications¶

Setup: 1. Go to Settings → Notifications 2. Enable "Email Alerts" 3. Verify email address 4. Choose frequency

Frequency Options: - Instant: Real-time (< 1 minute delay) - Hourly Digest: Summary every hour - Daily Digest: Summary once per day

Email Format:

Subject: 🚨 Critical Alert - Rug Pull Detected

Chain Sentinel Alert
Severity: CRITICAL
Time: 2026-01-10 12:34:56 UTC

Token: SCAM (SCAM)
Address: ABC...123

Alert: Rug Pull in Progress
- Liquidity dropped 85% in 10 minutes
- Creator sold 8M tokens ($65K)
- Only $7.5K liquidity remaining

Recommendation: SELL IMMEDIATELY

View Details: https://app.chainsentinel.net/tokens/ABC...123
Manage Alerts: https://app.chainsentinel.net/settings

Telegram Bot¶

Setup: 1. Go to Settings → Notifications 2. Click "Connect Telegram" 3. Open Telegram and search for @ChainSentinelBot 4. Send /start command 5. Click verification link from website

Commands: - /start - Connect your account - /status - Check connection status - /alerts - View recent alerts - /watchlist - View your watchlist - /help - Get help

Message Format:

🚨 CRITICAL ALERT

Token: SCAM (SCAM)

Rug Pull in Progress
Liquidity: -85% (10 min)
Creator sold: $65K

🔗 View Details
⚙️ Manage Alerts

Push Notifications (Mobile App)¶

Coming Soon: - Native mobile app for iOS and Android - Push notifications to your phone - Faster than email or Telegram - Works even when app is closed

Webhook Integration¶

For Developers:

Send alerts to your own system:

# Webhook endpoint receives POST requests
@app.route('/webhook', methods=['POST'])
def handle_alert():
    data = request.json

    alert_type = data['alert_type']
    severity = data['severity']
    token = data['token']

    # Your custom logic
    if severity == 'critical':
        send_sms_alert(token['address'])

    return {'status': 'ok'}

Webhook Payload:

{
  "alert_id": "alert_123456",
  "alert_type": "rug_pull",
  "severity": "critical",
  "timestamp": "2026-01-10T12:34:56Z",
  "token": {
    "address": "ABC...123",
    "name": "SCAM",
    "symbol": "SCAM",
    "prediction": "SCAM",
    "confidence": 98
  },
  "details": {
    "liquidity_change": -0.85,
    "time_window": "10m",
    "creator_sold": 8000000,
    "creator_sold_usd": 65000,
    "liquidity_remaining": 7500
  },
  "recommendation": "SELL_IMMEDIATELY",
  "url": "https://app.chainsentinel.net/tokens/ABC...123"
}

Setup: 1. Go to Settings → Webhooks 2. Add your webhook URL (must be HTTPS) 3. Select alert types to receive 4. Test webhook 5. Save

Alert Settings¶

Notification Preferences¶

Configure what alerts you receive:

Alert Type                  Email  Telegram  Webhook
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚨 Rug Pull                  ✅     ✅        ✅
🚨 Honeypot                  ✅     ✅        ✅
🚨 Scam Ring                 ✅     ✅        ✅
⚠️  High Risk Token          ✅     ✅        ❌
⚠️  Unusual Activity         ✅     ❌        ❌
⚠️  Large Holder Movement    ✅     ❌        ❌
ℹ️  New Token                ✅     ❌        ❌
ℹ️  Market Trend             ❌     ❌        ❌
ℹ️  Milestone                ❌     ❌        ❌

Quiet Hours¶

Disable alerts during specific times:

Quiet Hours: 11:00 PM - 7:00 AM (Local Time)

During quiet hours:
- Critical alerts: Still delivered
- Warning alerts: Held until 7:00 AM
- Info alerts: Held until 7:00 AM

Alert Throttling¶

Prevent alert spam:

Same Token:
- Max 1 alert per 5 minutes
- Max 10 alerts per hour
- Max 50 alerts per day

Same Alert Type:
- Max 5 alerts per hour
- Max 20 alerts per day

Alert History¶

View Past Alerts¶

Access your alert history:

Go to Alerts → History
Filter by:
Date range
Alert type
Severity
Token/wallet
Export to CSV

Example History:

Date                 Type        Severity  Token      Action
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026-01-10 12:34    Rug Pull    Critical  SCAM       Sold
2026-01-10 10:15    High Risk   Warning   MOON       Avoided
2026-01-09 18:42    New Token   Info      PUMP       Analyzed
2026-01-09 14:20    Unusual     Warning   DOGE       Monitored

Alert Analytics¶

Understand your alert patterns:

Alerts per day: Trend over time
Alert types: Distribution by category
Response time: How quickly you act
Accuracy: False positive rate
Saved losses: Estimated money saved

Smart Alerts¶

AI-Powered Filtering¶

Chain Sentinel uses AI to reduce false positives:

Context-Aware Alerts¶

Considers market conditions
Filters normal volatility
Adapts to your portfolio
Learns from your actions

Personalized Thresholds¶

Based on your risk tolerance
Adjusted for token size
Considers your holdings
Improves over time

Alert Clustering¶

Groups related alerts
Reduces notification spam
Provides context
Shows bigger picture

Predictive Alerts¶

Get warned before problems occur:

Early Warning System¶

Detects patterns before rug pull
Identifies suspicious preparation
Monitors creator behavior
Tracks cluster activity

Example:

⚠️ EARLY WARNING

Token: MOON (MOON)

Suspicious Activity Detected:
- Creator wallet received 10 SOL from known scammer
- Liquidity LP tokens moved to new wallet
- Similar pattern to previous rug pulls

Risk Level: HIGH
Estimated Time to Rug: 6-24 hours

Recommendation: Consider selling

Alert Response¶

Recommended Actions¶

For each alert type:

🚨 Rug Pull in Progress¶

Immediate: Try to sell if possible
Check: Can you actually sell? (honeypot test)
Document: Screenshot for evidence
Report: Submit to Chain Sentinel and authorities
Warn: Alert community on Twitter/Telegram

⚠️ High Risk Token¶

Research: Check token details on Chain Sentinel
Verify: Look for audit, team, social media
Test: Small buy/sell test if considering
Monitor: Add to watchlist if buying
Limit: Only invest what you can afford to lose

ℹ️ New Token from Watched Creator¶

Analyze: Run through Chain Sentinel
Compare: Check creator's history
Wait: Don't FOMO, observe for 24-48h
Verify: Confirm legitimacy
Decide: Buy only if confident

Alert Escalation¶

When to escalate:

Contact Support¶

Alert seems incorrect
Missing critical information
Technical issues
Feature requests

Report to Authorities¶

Confirmed scam with evidence
Large-scale fraud (> $100K)
Identity theft or doxxing
Threats or harassment

Community Warning¶

Share on Twitter with #ChainSentinel
Post in Telegram groups
Submit to scam databases
Help protect others

Subscription Tiers¶

Free Tier¶

✅ Email alerts (daily digest)
✅ Basic alert types
✅ 5 watchlist items
❌ Telegram alerts
❌ Real-time alerts
❌ Webhooks
❌ Custom thresholds

Pro Tier ($49/month)¶

✅ Email alerts (real-time)
✅ Telegram alerts
✅ All alert types
✅ 50 watchlist items
✅ Webhooks
✅ Custom thresholds
✅ Alert history (90 days)
✅ Priority support

Enterprise Tier (Custom)¶

✅ All Pro features
✅ Unlimited watchlist
✅ Custom alert types
✅ Dedicated Telegram channel
✅ API access
✅ Alert history (unlimited)
✅ White-label alerts
✅ 24/7 support

Upgrade to Pro

API Access¶

Manage alerts programmatically:

import requests

headers = {"X-API-Key": "your_api_key"}

# Get recent alerts
response = requests.get(
    "https://api.chainsentinel.net/alerts",
    headers=headers,
    params={"limit": 10, "severity": "critical"}
)
alerts = response.json()

# Mark alert as read
requests.post(
    "https://api.chainsentinel.net/alerts/123/read",
    headers=headers
)

# Update alert settings
requests.put(
    "https://api.chainsentinel.net/alerts/settings",
    headers=headers,
    json={
        "email_enabled": True,
        "telegram_enabled": True,
        "quiet_hours": {"start": "23:00", "end": "07:00"}
    }
)

See API Reference for full documentation.

Best Practices¶

Alert Management¶

Do's

✅ Enable critical alerts on all channels
✅ Use quiet hours for better sleep
✅ Review alert history weekly
✅ Adjust thresholds based on experience
✅ Test alerts before relying on them

Don'ts

❌ Don't ignore critical alerts
❌ Don't set sensitivity too high (alert fatigue)
❌ Don't rely solely on alerts (DYOR)
❌ Don't share alert credentials
❌ Don't disable all alerts

Response Time¶

Act quickly on critical alerts:

< 5 minutes: Rug pulls happen fast
< 1 hour: High risk situations
< 24 hours: General warnings

Alert Verification¶

Always verify before acting:

Check Chain Sentinel token page
Look at blockchain explorer
Check social media sentiment
Verify with multiple sources
Don't panic sell on single alert

Troubleshooting¶

Not Receiving Alerts¶

Email: - Check spam/junk folder - Verify email address - Check email filters - Test with "Send Test Alert"

Telegram: - Verify bot connection - Check Telegram notifications enabled - Restart Telegram app - Reconnect bot

Webhook: - Check webhook URL is accessible - Verify HTTPS certificate - Check webhook logs - Test with "Send Test Webhook"

Too Many Alerts¶

Reduce sensitivity level
Increase thresholds
Enable quiet hours
Use digest mode
Remove low-priority watchlist items

False Positives¶

Adjust alert thresholds
Review alert logic
Report false positives
Use AI filtering
Consider market conditions

Support¶

Need help with alerts?

📧 Email: support@chainsentinel.net
💬 Telegram: @chainsentinel_net
📖 FAQ: Frequently Asked Questions
🐛 Report Bug: GitHub Issues