revx-monitor

Original🇺🇸 English
Translated

Revolut X live price and indicator monitoring. Use when the user asks to "monitor prices", "set up alerts", "watch RSI", "track EMA crossover", "volume spike alert", "Bollinger band alert", "MACD alert", or runs revx monitor commands. This is a long-running background process.

19installs
Added on

NPX Install

npx skill4agent add revolut-engineering/revolut-x-api revx-monitor

Tags

Translated version includes tags in frontmatter

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:
json
{ "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:
bash
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

bash
# 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

TypeKey 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:
bash
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

bash
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

SkillPurpose
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