revx-account

アカウント、取引、注文の照会

残高と取引を確認し、注文を照会して、取引履歴を閲覧できます。

認証が必要です。 これらのコマンドを実行する前に、revx がインストールされ、設定されていることを確認してください。認証関連のエラー（Auth not configured、No private key found、Authentication failed (401)、Invalid signature、insecure permissions、または ~/.config/revolut-x/ にキーや設定ファイルがない場合）が発生したら、ただちに revx-auth スキルを実行し、修正を適用してください。セットアップを実行するようユーザーに尋ねて処理を中断しないでください。ユーザー自身にしか実行できない手順（API キーの貼り付け、Revolut X プロフィールへの公開鍵の登録、パスフレーズの選択）に限り、ユーザーに依頼してください。修正後、元のコマンドを再試行してください。

すべてのコマンドは、機械可読な出力を得るために --json または --output json をサポートしています。

シンボルは、ダッシュで区切る BASE-QUOTE 形式です：BTC-USD、ETH-EUR、SOL-USD。

---

残高

revx account balances                          # Non-zero balances
revx account balances --all                    # Include zero balances
revx account balances BTC                      # Single currency (case-insensitive)
revx account balances --currencies BTC,ETH,USD # Filter by multiple currencies

---

取引

revx transaction list                              # Last 30 days
revx transaction list --start-date 7d              # Last 7 days
revx transaction list --types buy,receive          # Types: buy, sell, receive, send, stake, un_stake, reward
revx transaction list --statuses completed,pending # Filter by status
revx transaction list --currencies BTC,USD         # Filter by either side
revx transaction list --limit 100 --json           # Limit and JSON output
revx transaction get <transaction-id>               # Full details of one transaction

フィルター： --start-date、--end-date、--types（buy、sell、receive、send、stake、un_stake、reward）、--statuses（pending、completed、cancelled、failed、reverted）、--currencies、--limit

デフォルト： 日付が指定されていない場合、直近30日分を返します。時刻形式：相対指定（7d、1w、today）、ISO 日付（2025-04-14）、Unix エポックミリ秒。

テーブル出力では、取引の UUID 全体を表示します。送金元側はマイナス記号付きの Source Amount、送金先側はプラス記号付きの Destination Amount で、アカウントフィールドはテーブルに表示されません。買いと売りでは両側が表示されます。送金とステーキングでは Source Amount のみ、受け取り、報酬、ステーキング解除では Destination Amount のみが表示されます。

JSON 出力では、支払いに source.currency と source.amount、受け取った資金に destination.currency と destination.amount を使用します。各側は省略可能ですが、少なくとも一方は存在します。各レッグには account.type（revolut、revolut_x、external_fiat、external_crypto）が含まれます。アカウント名と暗号資産アドレスは revx transaction get でのみ表示されます。処理時刻は processed_date です。

取引の詳細

revx transaction get <transaction-id> は、一覧では省略されるフィールドを含む取引を1件返します。

• 各レッグには fee と fee_currency、および type（revolut、revolut_x、external_fiat、external_crypto）、省略可能な display_name（メインの Revolut アカウントは Personal、貯蓄用ボールトは Savings、X のサブアカウントは Crypto Primary またはアカウント名、ステーキングの送金先は Staking）、さらに（外部の暗号資産ウォレットの場合）crypto_address を含む account オブジェクトが含まれることがあります。
• order_id — 買いまたは売りの裏付けとなる取引所の注文
• crypto_transaction_hash と network — 外部の暗号資産送金・受け取りに関するオンチェーン情報
• description — 存在する場合の自由記述メモ

手数料は最大1つのレッグに表示されます。これは、通貨が fee_currency と一致するレッグです（同一通貨での送金・受け取りの場合は送金元側）。stake、un_stake、reward、および外部からの入金（暗号資産または銀行）には、手数料は表示されません。受け取りと送金では、詳細に両側が含まれます。一覧では、送金は Source Amount のみ、受け取りは Destination Amount のみが表示されます。ステーキングでは一覧と詳細の両方で Source Amount のみが表示され、ステーキング解除と報酬では Destination Amount のみが表示されます。

省略可能なフィールドは、値が存在する場合にのみ表示されます。特定の取引の手数料、相手のアカウント、またはオンチェーンの詳細に関する質問には、このコマンドを使用してください。

---

未約定注文

revx order open
revx order open --symbols BTC-USD,ETH-USD --side buy
revx order open --order-states pending_new,new --order-types limit --limit 50
revx order open --order-types twap

フィルター： --symbols、--order-states（pending_new、new、partially_filled）、--order-types（limit、conditional、tpsl、twap）、--side、--limit

TWAP の行には、執行タイプ（成行または指値）、省略可能な指値価格、期間／頻度、および完了済み／合計スライスの進捗が表示されます。

注文履歴

revx order history
revx order history --symbols BTC-USD --start-date 7d --end-date today
revx order history --order-states filled,cancelled --limit 20
revx order history --order-types twap --start-date 7d

フィルター： --symbols、--order-states（filled、cancelled、rejected、replaced、partially_filled）、--order-types（market、limit、conditional、tpsl、twap）、--start-date、--end-date、--limit

デフォルト： 日付を指定しない場合、直近30日分を返します。時刻形式：相対指定（7d、1w、today）、ISO 日付（2025-04-14）、Unix エポック（ミリ秒）。

注文の詳細と約定

revx order get <order-id>              # Full order details
revx order fills <order-id>            # All fills for an order

注文の詳細には、必ず time_in_force が含まれます。値は gtc、ioc、fok のいずれかです（注文の発注／置換時に設定できるのは gtc／ioc のみですが、注文が fok として返される場合があります）。

約定、一部約定、またはキャンセルされた成行注文では、約定価格が記録されている場合、Price はその平均約定価格です。記録されていない場合は、注文送信時に記録された価格です。出力ではこの2つを区別できないため、実際の平均約定価格が必要な場合は Avg Fill Price を確認してください。

注文の詳細出力に含まれる任意のフィールド（存在する場合のみ表示）：

• amount ／ filled_amount — 決済通貨建ての注文サイズと、そのうち約定した数量
• average_fill_price — 出来高加重平均約定価格。filled_amount ／ filled_quantity（「Avg Fill Price」として表示）。キャンセル注文の一部約定を含め、数量が約定していれば常に表示されます
• total_fee ／ fee_currency — 請求された手数料の合計と、支払いに使用された通貨
• conditional ／ take_profit ／ stop_loss — 条件付き注文および TPSL 注文のトリガー定義。それぞれ、トリガー価格、方向（≥／≤）、注文タイプ（成行／指値）、有効期間、任意の指値価格が含まれます
• twap — TWAP 親注文のスケジュールと進捗状況：子注文の執行タイプ（market または limit）、任意の指値 price、秒単位の period と frequency、スライスの合計数／完了数、開始／終了時刻、および（order get の場合）リンクされた子注文 ID
• triggered_by — 条件付き注文、TP／SL、または TWAP トリガーによってこの注文が送信された場合に表示されます。reason: twap には TWAP 親注文 ID とスライスインデックスが含まれます。on_fill とは同時に表示されません
• on_fill — リンクされた TP／SL 決済戦略がこの注文に設定されている場合に表示されます。利確／損切りトリガーが含まれ、注文の約定後はリンクされた注文の id も含まれます。triggered_by とは同時に表示されません

TWAP の実行ツリー全体を確認するには、revx order get <twap-parent-id> を実行し、リンクされた各子 ID を revx order get <child-id> で確認してください。リンクされた子 ID は親注文の詳細レスポンスで確認できますが、未決済注文や履歴の一覧には表示されません。

---

取引

revx trade private BTC-USD                                # My trade history
revx trade private BTC-USD --start-date 7d --limit 100
revx trade private BTC-USD --start-date 2025-04-01 --end-date 2025-04-14
revx trade public BTC-USD                                 # Public trades
revx trade public BTC-USD --start-date 7d --end-date today

フィルター： --start-date、--end-date、--limit

デフォルト： 日付を指定しない場合、直近30日分を返します。時刻形式：相対指定（7d、1w、today）、ISO 日付（2025-04-14）、Unix エポック（ミリ秒）。

エイリアス：revx trade history ＝ private、revx trade all ＝ public。

---

繰り返しコマンドの権限処理（/loop）

/loop を使用して revx コマンドを一定間隔で実行する場合、反復のたびに権限確認が表示されます。承認を繰り返さずに済むようにするには、次の手順を実行します。

1. 各反復で必要となる正確な revx コマンドを特定します（例：revx account balances、revx order open）。
2. 各コマンドを個別の Bash ツール呼び出しとして実行します。&& やパイプで連結しないでください。これにより、各コマンドが単純な権限パターンに一致します。
3. 具体的なコマンドをユーザーに提示し、許可リストへの追加を依頼します。
4. update-config スキルを使って、.claude/settings.local.json に具体的な権限パターンを追加します。例：

   "Bash(revx account balances*)",
   "Bash(revx order open*)"
   

   包括的な Bash(revx *) は追加しないでください。ループに必要な正確なコマンドだけを追加します。
5. その後、/loop を開始します。

権限パターンの構文： Bash(revx account balances*) は glob ワイルドカードを使用します。末尾の * により、任意のフラグを追加できます。パターンではコロンではなく、スペースを区切り文字として使用します。&& や | を含む複合コマンドはサブコマンドに分割され、それぞれ個別に確認されます。

「10 分ごとに残高と未決済注文を確認する」場合の実行例：

1. 必要なコマンドを特定します：revx account balances と revx order open
2. ユーザーに伝えます：「各反復でこの 2 つのコマンドを実行します。権限の許可リストに追加してもよいですか？」
3. 承認後、update-config を使って Bash(revx account balances*) と Bash(revx order open*) を追加します。
4. /loop 10m check balance and open orders を開始します。
5. 各反復では個別の Bash 呼び出しを 2 回実行するため、以降の確認は不要です。

---

一般的なワークフロー

「BTC の価値はいくらですか？」

revx account balances BTC
revx market tickers BTC-USD

「最近の取引状況を確認する」

revx transaction list --start-date 7d
revx order history --start-date 7d
revx trade private BTC-USD --start-date 7d

---

関連スキル

スキル	目的
revx-trading	注文の発注とキャンセル
revx-market	価格と取引ペアの制約を確認
revx-monitor	価格とインジケーターのアラートを設定
revx-auth	API キーの設定と構成