alert-system

name	alert-system
description	Set price alerts, volume alerts, indicator alerts (RSI/MACD), and news alerts for crypto trading.
metadata	{"openclaw":{"emoji":"🚨","requires":{"bins":["python3"],"pip":["ccxt","ta","requests"]}}}

Alert System

Real-time alerts for price movements, technical indicators, and market events.

Overview

• Price Alerts - Trigger when price crosses threshold
• Volume Alerts - Unusual volume detection
• Indicator Alerts - RSI overbought/oversold, MACD crossovers
• News Alerts - Breaking crypto news

Alert Storage

Alerts stored in ~/.kit/alerts.json:

{
  "alerts": [
    {
      "id": "alert_001",
      "type": "price",
      "symbol": "BTC/USDT",
      "condition": "above",
      "value": 50000,
      "active": true,
      "notify": ["telegram", "sound"]
    }
  ]
}

Commands

Price Alert - Above

python3 -c "
import ccxt
import time

symbol = 'BTC/USDT'
target = 50000
exchange = ccxt.binance()

print(f'⏳ Watching {symbol} for price above \${target:,}...')
while True:
    ticker = exchange.fetch_ticker(symbol)
    price = ticker['last']
    if price >= target:
        print(f'🚨 ALERT: {symbol} is now \${price:,.2f} (above \${target:,})')
        break
    print(f'Current: \${price:,.2f}', end='\\r')
    time.sleep(10)
"

Price Alert - Below

python3 -c "
import ccxt
import time

symbol = 'BTC/USDT'
target = 45000
exchange = ccxt.binance()

print(f'⏳ Watching {symbol} for price below \${target:,}...')
while True:
    ticker = exchange.fetch_ticker(symbol)
    price = ticker['last']
    if price <= target:
        print(f'🚨 ALERT: {symbol} dropped to \${price:,.2f} (below \${target:,})')
        break
    time.sleep(10)
"

Percent Change Alert

python3 -c "
import ccxt
import time

symbol = 'BTC/USDT'
threshold_pct = 5  # 5% move
exchange = ccxt.binance()

ticker = exchange.fetch_ticker(symbol)
start_price = ticker['last']
print(f'⏳ Watching {symbol} for {threshold_pct}% move from \${start_price:,.2f}...')

while True:
    ticker = exchange.fetch_ticker(symbol)
    price = ticker['last']
    change_pct = ((price - start_price) / start_price) * 100
    
    if abs(change_pct) >= threshold_pct:
        direction = '📈' if change_pct > 0 else '📉'
        print(f'🚨 {direction} {symbol} moved {change_pct:+.2f}% to \${price:,.2f}')
        break
    time.sleep(30)
"

Volume Spike Alert

python3 -c "
import ccxt
import time

symbol = 'BTC/USDT'
volume_multiplier = 2  # 2x average volume
exchange = ccxt.binance()

# Get average volume (last 24 bars)
ohlcv = exchange.fetch_ohlcv(symbol, '1h', limit=24)
avg_volume = sum(c[5] for c in ohlcv) / len(ohlcv)

print(f'⏳ Watching {symbol} for volume spike (>{volume_multiplier}x avg)...')
print(f'Average hourly volume: {avg_volume:,.0f}')

while True:
    ticker = exchange.fetch_ticker(symbol)
    current_volume = ticker['quoteVolume'] / 24  # Rough hourly
    
    if current_volume > avg_volume * volume_multiplier:
        print(f'🚨 VOLUME SPIKE: {symbol} volume {current_volume:,.0f} ({current_volume/avg_volume:.1f}x average)')
        break
    time.sleep(60)
"

RSI Alert (Overbought/Oversold)

python3 -c "
import ccxt
import ta
import pandas as pd

symbol = 'BTC/USDT'
exchange = ccxt.binance()

# Fetch OHLCV data
ohlcv = exchange.fetch_ohlcv(symbol, '1h', limit=100)
df = pd.DataFrame(ohlcv, columns=['timestamp', 'open', 'high', 'low', 'close', 'volume'])

# Calculate RSI
df['rsi'] = ta.momentum.RSIIndicator(df['close'], window=14).rsi()
current_rsi = df['rsi'].iloc[-1]

print(f'{symbol} RSI(14): {current_rsi:.1f}')

if current_rsi >= 70:
    print('🔴 OVERBOUGHT - Consider taking profits')
elif current_rsi <= 30:
    print('🟢 OVERSOLD - Potential buying opportunity')
else:
    print('⚪ Neutral')
"

MACD Crossover Alert

python3 -c "
import ccxt
import ta
import pandas as pd

symbol = 'BTC/USDT'
exchange = ccxt.binance()

ohlcv = exchange.fetch_ohlcv(symbol, '4h', limit=100)
df = pd.DataFrame(ohlcv, columns=['timestamp', 'open', 'high', 'low', 'close', 'volume'])

macd = ta.trend.MACD(df['close'])
df['macd'] = macd.macd()
df['signal'] = macd.macd_signal()
df['histogram'] = macd.macd_diff()

current_hist = df['histogram'].iloc[-1]
prev_hist = df['histogram'].iloc[-2]

print(f'{symbol} MACD Histogram: {current_hist:.4f}')

if prev_hist < 0 and current_hist > 0:
    print('🟢 BULLISH CROSSOVER - MACD crossed above signal')
elif prev_hist > 0 and current_hist < 0:
    print('🔴 BEARISH CROSSOVER - MACD crossed below signal')
else:
    direction = 'Bullish' if current_hist > 0 else 'Bearish'
    print(f'⚪ No crossover - Currently {direction}')
"

Multi-Coin Price Monitor

python3 -c "
import ccxt
import time

watchlist = ['BTC/USDT', 'ETH/USDT', 'SOL/USDT', 'XRP/USDT']
exchange = ccxt.binance()

print('📊 Crypto Price Monitor')
print('=' * 50)

while True:
    for symbol in watchlist:
        ticker = exchange.fetch_ticker(symbol)
        price = ticker['last']
        change = ticker['percentage']
        emoji = '🟢' if change >= 0 else '🔴'
        print(f'{emoji} {symbol:12} \${price:>10,.2f}  {change:+6.2f}%')
    print('-' * 50)
    time.sleep(60)
"

Workflow

Setting Up Alerts

1. Define alert conditions (price, indicator, volume)
2. Add to ~/.kit/alerts.json
3. Run alert monitor as background service
4. Configure notification channels

Alert Types

Type	Trigger	Use Case
price_above	Price >= target	Take profit
price_below	Price <= target	Stop loss, buy dip
pct_change	X% move in Y time	Volatility
volume_spike	Volume > X * average	Breakout
rsi_high	RSI >= 70	Overbought
rsi_low	RSI <= 30	Oversold
macd_cross	MACD/Signal cross	Trend change

Notification Channels

• Telegram - Via K.I.T. bot
• Sound - System alert sound
• Email - For critical alerts
• Push - Mobile notification

Best Practices

1. Don't set alerts too close to current price (noise)
2. Use multiple confirmation (price + volume + indicator)
3. Set both entry and exit alerts
4. Review and clean up old alerts regularly