revx-monitor

监控（revx monitor）

实时价格和技术指标提醒。作为持续轮询进程运行。

需要身份验证。 运行这些命令前，请确保已安装并配置 revx。如果任何命令因身份验证问题而失败，例如出现 Auth not configured、No private key found、Authentication failed (401)、Invalid signature、insecure permissions，或在 ~/.config/revolut-x/ 中缺少密钥或配置文件，请立即调用 revx-auth 技能并自行应用修复。 不要中断用户并要求他们运行设置。只有在需要用户亲自执行的步骤时，才请用户协助（粘贴 API 密钥、在 Revolut X 个人资料中注册公钥、选择密码短语）。修复后，重试原始命令。

交易对符号采用 BASE-QUOTE 格式，中间以连字符分隔：BTC-USD、ETH-EUR、SOL-USD。

如果已配置 Telegram 连接器（参见 revx-telegram 技能），提醒会以通知的形式发送。

---

Claude 的行为说明

长时间运行的命令

所有 revx monitor <type> 命令都会无限期运行（通过轮询循环显示实时仪表板）。

处理方式：

1. 使用 Bash 工具运行命令，并设置 run_in_background: true——这样进程会异步运行，Claude 可以立即继续处理
2. 定期使用 Read 工具读取后台任务的输出文件，以监控状态并向用户报告重要事件（触发的提醒、错误）
3. 如果用户要求停止，请使用 TaskStop 工具并提供任务 ID
4. 同时向用户显示命令，以便他们可以选择在单独的终端中运行，体验完整的实时仪表板（带颜色、实时表格，按 Ctrl+C 停止）

示例——启动监控：

Bash 工具调用：

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

给用户的回复：

已在后台开始监控 BTC-USD 价格。我会定期检查是否有提醒。

如果你想查看实时仪表板，请在单独的终端中运行：

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

按 Ctrl+C 停止。如果已配置 Telegram，也会通过 Telegram 发送提醒。

---

所有监控类型

# 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

通用选项： --interval <seconds>（整秒，范围为 5 至 86400，默认值为 10）。超出此范围的值会被拒绝，不会自动调整。

触发警报时： 阈值监控（价格、RSI、布林带、价差、OBI 等）会在条件成立时立即发出警报，启动时也会检查。ema-cross 和 macd 只会在首次检查时进入待触发状态，只有出现新的交叉时才会发出警报，因此启动时已形成的趋势不会触发通知。每小时蜡烛图最多触发一次交叉警报，因此一小时内来回交叉只会发送一条消息。条件持续成立时，后续检查会显示简短的“仍满足”提示，而不会再次发出警报；同一小时内再次形成交叉时，会显示“本小时已报警”。只有至少成功发送一条 Telegram 消息时才会显示“已通知”，否则该行会显示通知失败。如果 Revolut X 拒绝 API 密钥（401 或 403），监控会立即发送一条消息，说明已屏蔽的密钥及修复方法，随后继续检查，并在密钥恢复可用时再发送一条消息。遇到 401 后，请使用 revx configure 修复密钥并重新启动监控。遇到 403 后，请在 Revolut X 中修复密钥权限，监控会自动继续运行。因其他原因导致数据中断超过 5 分钟时，监控会发送一条消息，并在数据恢复时再发送一条消息，说明中断持续时间。

输入检查： 监控启动前会检查每个选项；如果值无效，监控会停止并指出选项名称。数字应使用小数格式，例如 100000 或 0.0000001，也可使用指数格式，例如 1e-7，不能写成 100k 或 100,000。数值必须小于 1e15，且小数位最多为 18 位。周期必须为不超过 99 的整数，因为监控会读取最近 100 根小时蜡烛图。RSI、布林带和 MACD 的 --signal 至少为 2；--slow 加上 --signal 的值最多为 100。快速周期必须小于慢速周期。价格和价格变化阈值必须大于 0，价差阈值必须大于或等于 0，RSI 阈值必须大于 0 且小于 100，OBI 阈值必须介于 -1 到 1 之间，乘数必须大于 0。交易对必须是 Revolut X 当前支持交易的交易对。如果监控所需的蜡烛图数量不足，每次检查时都会显示提示。

监控默认值

类型	关键默认值
price	方向：above，阈值：必填
rsi	方向：above，阈值：70，周期：14
ema-cross	方向：bullish，快速周期：9，慢速周期：21
macd	方向：bullish，快速周期：12，慢速周期：26，信号周期：9
bollinger	轨道：upper，周期：20，标准差倍数：2
volume-spike	周期：20，乘数：2.0
spread	方向：above，阈值：0.5
obi	方向：above，阈值：0.3
price-change	方向：rise，阈值：5.0，回溯周期：24
atr-breakout	周期：14，乘数：1.5

---

常见工作流：通过 Telegram 设置价格提醒

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

另请参阅： revx-telegram 技能，了解 Telegram 连接器管理的完整信息。

---

相关技能

技能	用途
revx-telegram	配置提醒的 Telegram 通知
revx-market	了解市场数据和指标
revx-strategy	配合监控的自动化网格交易
revx-account	查看余额和订单状态
revx-auth	设置和配置 API 密钥