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. run_in_background: true を指定し、Bash ツールでコマンドを実行します。これにより、プロセスが非同期で実行されている間、Claude はすぐに次の処理に移れます
2. 定期的に Read ツールでバックグラウンドタスクの出力ファイルを読み込み、状況を監視して、重要なイベント（アラートの発生、エラー）をユーザーに報告します
3. ユーザーが停止を求めた場合は、タスク ID を指定して TaskStop ツールを使用します
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 にも送信されます。

---

すべてのモニタータイプ

# 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 は最初のチェックでのみ監視を開始し、新たなクロスオーバーが発生したときにアラートを発するため、開始時点ですでにトレンドが成立していても通知されません。クロスオーバーのアラートは 1 時間足あたり最大 1 回です。そのため、1 時間以内にクロスが何度も反転しても、メッセージは 1 回だけ送信されます。条件が成立している間、後続のチェックでは新たなアラートの代わりに短い「引き続き成立しています」という行が表示されます。また、1 時間以内に再びクロスオーバーが発生した場合は「今時間内にアラート済み」と表示されます。「通知済み」と表示されるのは、Telegram メッセージが 1 件以上配信された場合のみです。それ以外の場合は、通知に失敗したことを示す行が表示されます。Revolut X が API キーを拒否した場合（401 または 403）、モニターはマスクされたキーと修正方法を記載したメッセージをすぐに 1 件送信し、チェックを続けます。キーが再び使えるようになったときに、もう 1 件送信します。401 の後は、revx configure でキーを修正し、モニターを再起動してください。403 の後は、Revolut X でキーの権限を修正すると、モニターは自動的に再開します。その他の理由で 5 分間データが取得できない場合は、メッセージを 1 件送信し、データが戻ったときに、停止していた時間を記載したメッセージをもう 1 件送信します。

入力チェック： モニターの開始前にすべてのオプションがチェックされ、不正な値がある場合はオプション名を示して停止します。数値は 100000 や 0.0000001 のような小数、または 1e-7 のような指数形式で指定します。100k や 100,000 は使用できません。数値は 1e15 未満で、小数点以下は最大 18 桁までです。期間は整数で最大 99 です。これは、モニターが直近 100 本の 1 時間足を読み取るためです。RSI、ボリンジャー、MACD の --signal は 2 以上である必要があり、--slow と --signal の合計は 100 以下である必要があります。短期の期間は長期の期間より小さくなければなりません。価格と価格変動のしきい値は 0 より大きく、スプレッドのしきい値は 0 以上、RSI のしきい値は 0 より大きく 100 未満、OBI のしきい値は -1〜1、倍率は 0 より大きい値にしてください。ペアは、現在 Revolut X で取引されているものを指定してください。期間に対してローソク足の数が不足しているモニターは、チェックのたびにその旨を表示します。

モニターのデフォルト値

タイプ	主なデフォルト値
price	方向：上、しきい値：必須
rsi	方向：上、しきい値：70、期間：14
ema-cross	方向：強気、短期：9、長期：21
macd	方向：強気、短期：12、長期：26、シグナル：9
bollinger	バンド：上限、期間：20、標準偏差の倍率：2
volume-spike	期間：20、倍率：2.0
spread	方向：上、しきい値：0.5
obi	方向：上、しきい値：0.3
price-change	方向：上昇、しきい値：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

関連項目： Telegram コネクターの管理方法について詳しくは、revx-telegram スキルをご覧ください。

---

関連スキル

スキル	目的
revx-telegram	アラート用の Telegram 通知を設定する
revx-market	市場データと指標を理解する
revx-strategy	モニタリング機能を備えた自動グリッド取引
revx-account	残高と注文状況を確認する
revx-auth	API キーを設定する