Kraken Alert Patterns

Spread Alert

Detect when the bid-ask spread widens beyond a threshold (liquidity warning):

kraken ws ticker BTC/USD --event-trigger bbo -o json 2>/dev/null | while read -r line; do
  ASK=$(echo "$line" | jq -r '.data[0].ask // empty')
  BID=$(echo "$line" | jq -r '.data[0].bid // empty')
  [ -z "$ASK" ] || [ -z "$BID" ] && continue
  SPREAD=$(echo "$ASK - $BID" | bc)
  # Alert if spread exceeds threshold
done

Volume Spike Detection

Compare current 24h volume against a baseline:

kraken ticker BTCUSD -o json 2>/dev/null | jq -r '.[].v[1]'
# Agent compares to historical average
# Alert if volume > 2x baseline

Volatility Alert (OHLC-Based)

Read recent candles and compute range or standard deviation:

kraken ohlc BTCUSD --interval 60 -o json 2>/dev/null
# Agent calculates high-low range per candle
# Alert if range exceeds threshold

Balance Change Alert

Monitor for unexpected balance changes:

INITIAL=$(kraken balance -o json 2>/dev/null | jq -r '.USD // "0"')
# On each check:
CURRENT=$(kraken balance -o json 2>/dev/null | jq -r '.USD // "0"')
# Alert if |CURRENT - INITIAL| exceeds threshold

Streaming alternative:

kraken ws balances -o json 2>/dev/null
# Each line is a balance update event

Fill Notification

Alert on trade executions:

kraken ws executions -o json 2>/dev/null | while read -r line; do
  TYPE=$(echo "$line" | jq -r '.data[0].exec_type // empty')
  [ "$TYPE" = "trade" ] && echo "Fill: $line"
done

Futures Alerts

Monitor futures positions for margin or P&L thresholds:

kraken futures positions -o json 2>/dev/null
# Agent checks unrealized P&L against stop-loss threshold

Stream futures balance changes:

kraken futures ws balances -o json 2>/dev/null

Futures notifications (margin calls, liquidation warnings):

kraken futures ws notifications -o json 2>/dev/null

Multi-Pair Alert

Watch several pairs and alert on the first one that hits a condition:

kraken ws ticker BTC/USD ETH/USD SOL/USD -o json 2>/dev/null | while read -r line; do
  PAIR=$(echo "$line" | jq -r '.data[0].symbol // empty')
  LAST=$(echo "$line" | jq -r '.data[0].last // empty')
  [ -z "$PAIR" ] || [ -z "$LAST" ] && continue
  # Check pair-specific thresholds
done

Notification Delivery

The CLI outputs alerts to stdout. The agent is responsible for delivering notifications through its own channels (Slack, email, push notification, or presenting to the user in chat).

Pattern Summary

Hard Rules

• Alerts are informational; they do not execute trades automatically.
• Prefer streaming over high-frequency polling to reduce API load.
• Close streams when monitoring is no longer needed.