revx-auth

認証とアカウントの設定（revx configure）

CLI をインストールし、API キーを生成して、書き込み操作のセキュリティを設定します。

対象を自動解決します。 認証エラーが原因で別の revx-* スキルから呼び出された場合、ユーザーに手動設定へ戻るよう求めないでください。以下のエラーリファレンスに照らして失敗の原因を診断し、自分で修正を実行します（例：chmod 600 ~/.config/revolut-x/private.pem、revx configure generate-keypair、revx configure set --api-key <key>）。その後、呼び出し元のスキルに戻り、元のコマンドを再試行してください。ユーザーに求めるのは、本人だけが提供できる情報に限ります。具体的には、64 文字の API キー文字列、Revolut X プロフィールに公開鍵を登録したことの確認、または既存のキーペアを別の場所に移す許可です。

前提条件

• Node.js >= 20（node -v で確認）
• npm（Node.js に付属）

インストール

npm install -g @revolut/revolut-x-cli && npm link @revolut/revolut-x-cli

インストール後、revx をグローバルコマンドとして使用できます。

revx --version                # Should print the version

---

はじめに

ステップ 1：認証を設定する

revx configure                 # Interactive setup wizard

次の処理が行われます。

1. Ed25519 キーペア（秘密鍵と公開鍵）を生成します
2. 公開鍵を表示します。コピーしてください
3. 公開鍵を exchange.revolut.com -> Profile -> API Keys に登録するよう求めます
4. 新しい API キーを作成します。"Allow usage via Revolut X MCP and CLI" チェックボックスをオンにしてください
5. 登録後に受け取る 64 文字の API キーの入力を求めます

または、手順ごとに実行できます。

revx configure generate-keypair          # Creates Ed25519 keypair
# Register public key at exchange.revolut.com -> Profile -> API Keys
# Create API key — tick "Allow usage via Revolut X MCP and CLI"
revx configure set --api-key <64-char-key>

ステップ 2：設定を確認する

revx configure get             # Show config status (keys redacted)
revx configure path            # Print config directory path

設定コマンド

revx configure                          # Interactive setup wizard
revx configure get                      # Show config status (keys redacted)
revx configure set --api-key <key>      # Set API key
revx configure generate-keypair         # Generate Ed25519 keypair
revx configure path                     # Print config directory path

設定の保存場所

プラットフォーム	パス
macOS/Linux	~/.config/revolut-x/
Windows	%APPDATA%\revolut-x\
上書き	REVOLUTX_CONFIG_DIR env var

---

エラーリファレンス

エラー	原因	修正方法
認証が設定されていません	API キーまたは秘密鍵がありません	revx configure を実行してください
秘密鍵または設定ファイル <path> を読み取れません（EACCES）	このユーザーがファイルを読み取れません	ファイルの所有者がこのユーザーであることを確認してから、chmod 600 <path> を実行してください
<path> はファイルではありません	フォルダーが妨げになっています	フォルダーを別の場所に移す前に確認を求めてから、revx configure を実行してください
秘密鍵 <path> がありません	API キーは設定されていますが、鍵ファイルがなくなっています	ユーザーのコピーがある場合は、<path> に戻してください。ない場合は revx configure generate-keypair を実行し、新しい公開鍵を登録して、新しい API キーを作成してください
秘密鍵 <path> が空である、公開鍵が格納されている、パスフレーズで保護されている、OpenSSH 形式である、有効な PEM 秘密鍵ではない、または Ed25519 鍵ではない	鍵ファイルが破損しているか、種類が間違っています	まず確認を求めてください。その後、mv -n <path> <path>.old-$(date +%s) のように、まだ存在しない新しい名前に移し、revx configure generate-keypair を実行して、新しい公開鍵を登録し、新しい API キーを作成してください。古いファイルは絶対に削除しないでください
設定ファイル <path> が有効な JSON ではない、設定オブジェクトではない、API キーが英数字 64 文字ではない、または private_key_path がテキストではない	config.json が破損しています	revx configure set --api-key <key> を実行すると、ファイルが書き直されます
認証に失敗しました（401）	キーまたは署名が無効です	exchange.revolut.com で公開鍵を再登録してください
ネットワークエラー	接続またはタイムアウトの失敗です	接続を確認して、再試行してください

---

次のステップ

設定が完了したら、次の機能をお試しください。

• 残高、取引、注文履歴を確認する — revx-account スキルを参照してください
• 市場価格とローソク足を表示する — revx-market スキルを参照してください
• 最初の注文を行う — revx-trading スキルを参照してください

関連スキル

スキル	目的
revx-market	通貨、通貨ペア、ティッカー、ローソク足、注文板
revx-account	残高、取引履歴、注文の照会、取引履歴
revx-trading	注文の発注とキャンセル
revx-monitor	リアルタイム価格／インジケーターのアラート
revx-telegram	Telegram 通知の設定
revx-strategy	グリッドボットのバックテスト、最適化、実行