revx-monitor

Monitoring (revx monitor)

Live price and technical indicator alerts. Runs as a continuous polling process.

Auth required. Make sure revx is installed and configured before running these commands. If any command fails with an auth-related error — Auth not configured, No private key found, Authentication failed (401), Invalid signature, insecure permissions, or a missing key/config file at ~/.config/revolut-x/ — invoke the revx-auth skill immediately and apply the fix yourself. Do not interrupt the user to ask them to run setup. Only escalate to the user for steps only they can perform (pasting the API key, registering the public key in their Revolut X profile, choosing a passphrase). After the fix, retry the original command.

Symbols use BASE-QUOTE format with a dash: BTC-USD, ETH-EUR, SOL-USD.

If Telegram connectors are configured (see revx-telegram skill), alerts are sent as notifications.

---

Behavioral Instructions for Claude

Long-Running Commands

All revx monitor <type> commands run indefinitely (polling loops with live dashboard output).

How to handle:

1. Run the command using the Bash tool with run_in_background: true — this frees Claude immediately while the process runs asynchronously
2. Periodically read the background task output file with the Read tool to monitor status and report key events to the user (alerts triggered, errors)
3. If the user asks to stop, use the TaskStop tool with the task ID
4. Also print the command to the user so they can optionally run it in a separate terminal for the full live dashboard experience (with colors, real-time tables, Ctrl+C to stop)

Example — starting a monitor:

Bash tool call:

{ "command": "revx monitor price BTC-USD --direction above --threshold 100000", "run_in_background": true }

Response to user:

Started monitoring BTC-USD price in the background. I'll check for alerts periodically.

If you'd like to see the live dashboard, run this in a separate terminal:

revx monitor price BTC-USD --direction above --threshold 100000

Press Ctrl+C to stop. Alerts will also be sent to Telegram if configured.

---

All Monitor Types

# Price threshold
revx monitor price BTC-USD --direction above --threshold 100000

# RSI (Relative Strength Index)
revx monitor rsi ETH-USD --direction above --threshold 70 --period 14

# EMA crossover
revx monitor ema-cross BTC-USD --direction bullish --fast-period 9 --slow-period 21

# MACD crossover
revx monitor macd BTC-USD --direction bullish --fast 12 --slow 26 --signal 9

# Bollinger Bands breach
revx monitor bollinger BTC-USD --band upper --period 20 --std-mult 2

# Volume spike
revx monitor volume-spike BTC-USD --period 20 --multiplier 2.0

# Bid-ask spread
revx monitor spread BTC-USD --direction above --threshold 0.5

# Order book imbalance
revx monitor obi BTC-USD --direction above --threshold 0.3

# Price change percentage
revx monitor price-change BTC-USD --direction rise --threshold 5.0 --lookback 24

# ATR breakout
revx monitor atr-breakout BTC-USD --period 14 --multiplier 1.5

# List all types with descriptions
revx monitor types

Common option: --interval <seconds> (minimum 5, default 10)

Monitor Defaults

Type	Key Defaults
price	direction: above, threshold: required
rsi	direction: above, threshold: 70, period: 14
ema-cross	direction: bullish, fast: 9, slow: 21
macd	direction: bullish, fast: 12, slow: 26, signal: 9
bollinger	band: upper, period: 20, std-mult: 2
volume-spike	period: 20, multiplier: 2.0
spread	direction: above, threshold: 0.5
obi	direction: above, threshold: 0.3
price-change	direction: rise, threshold: 5.0, lookback: 24
atr-breakout	period: 14, multiplier: 1.5

---

Events (Alert History)

View past alert triggers and notification events:

revx events                            # Last 50 events
revx events --limit 10
revx events --category alert_triggered
revx events --json

---

Common Workflow: Set Up Price Alert with Telegram

revx connector telegram add --token <token> --chat-id <id> --test
revx monitor price BTC-USD --direction above --threshold 100000

See also: revx-telegram skill for full Telegram connector management.

---

Related Skills

Skill	Purpose
revx-telegram	Configure Telegram notifications for alerts
revx-market	Understand market data and indicators
revx-strategy	Automated grid trading with monitoring
revx-account	Check balances and order status
revx-auth	API key setup and configuration