Back to Details

revx-auth

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Auth & Account Setup (
revx configure
)

认证与账户设置（
revx configure
）

Install the CLI, generate API keys, and configure write-operation security.
Auto-resolve target. When invoked from another 
revx-*
skill due to an auth error, do not bounce the user back to manual setup. Diagnose the failure against the Error Reference below, run the fix yourself (e.g. 
chmod 600 ~/.config/revolut-x/private.pem
, 
revx configure generate-keypair
, 
revx configure set --api-key <key>
), then return to the calling skill and retry the original command. Only ask the user for inputs that only they can provide: the 64-character API key string, confirmation that they have registered the public key in their Revolut X profile, the keypair passphrase, or approval to overwrite an existing keypair.
安装CLI、生成API密钥并配置写入操作安全设置。
自动修复目标：当因认证错误从其他
revx-*
技能调用时，请勿让用户返回手动设置。根据下方的错误参考诊断故障，自行执行修复操作（例如
chmod 600 ~/.config/revolut-x/private.pem
、
revx configure generate-keypair
、
revx configure set --api-key <key>
），然后返回调用技能并重试原命令。仅向用户请求只有他们能提供的信息：64位字符的API密钥字符串、确认已在Revolut X个人资料中注册公钥、密钥对密码，或允许覆盖现有密钥对的确认。

Prerequisites

前置条件

  • Node.js >= 20 (check with 
    node -v
    )
  • npm (comes with Node.js)
  • Node.js >= 20（使用
    node -v
    检查版本）
  • npm（随Node.js一同安装）

Install

安装

bash
npm install -g @revolut/revolut-x-cli && npm link @revolut/revolut-x-cli
After install, 
revx
is available as a global command:
bash
revx --version                # Should print the version
bash
npm install -g @revolut/revolut-x-cli && npm link @revolut/revolut-x-cli
安装后，
revx
作为全局命令可用：
bash
revx --version                # 应输出版本号

Getting Started

快速开始

Step 1: Configure Authentication

步骤1：配置认证

bash
revx configure                 # Interactive setup wizard
This will:
  1. Generate an Ed25519 keypair (private + public key)
  2. Display your public key — copy it
  3. Prompt you to register the public key at exchange.revolut.com -> Profile -> API Keys
  4. Create a new API key — tick the "Allow usage via Revolut X MCP and CLI" checkbox
  5. Prompt for the 64-character API key you receive after registration
Or do it step-by-step:
bash
revx configure generate-keypair          # Creates Ed25519 keypair
bash
revx configure                 # 交互式设置向导
该命令将执行以下操作：
  1. 生成Ed25519密钥对（私钥+公钥）
  2. 显示你的公钥——请复制它
  3. 提示你在exchange.revolut.com -> 个人资料 -> API密钥页面注册公钥
  4. 创建新的API密钥——勾选**"允许通过Revolut X MCP和CLI使用"**复选框
  5. 提示你输入注册后获得的64位字符API密钥
或者分步执行：
bash
revx configure generate-keypair          # 创建Ed25519密钥对

Register public key at exchange.revolut.com -> Profile -> API Keys

在exchange.revolut.com -> 个人资料 -> API密钥页面注册公钥

Create API key — tick "Allow usage via Revolut X MCP and CLI"

创建API密钥——勾选"允许通过Revolut X MCP和CLI使用"

revx configure set --api-key <64-char-key>
undefined
revx configure set --api-key <64-char-key>
undefined

Step 2: Verify Configuration

步骤2：验证配置

bash
revx configure get             # Show config status (keys redacted)
revx configure path            # Print config directory path
bash
revx configure get             # 显示配置状态（密钥已脱敏）
revx configure path            # 打印配置目录路径

Config Commands

配置命令

bash
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
bash
revx configure                          # 交互式设置向导
revx configure get                      # 显示配置状态（密钥已脱敏）
revx configure set --api-key <key>      # 设置API密钥
revx configure generate-keypair         # 生成Ed25519密钥对
revx configure path                     # 打印配置目录路径

Config Location

配置文件位置

PlatformPath
macOS/Linux
~/.config/revolut-x/
Windows
%APPDATA%\revolut-x\
Override
REVOLUTX_CONFIG_DIR
env var
操作系统路径
macOS/Linux
~/.config/revolut-x/
Windows
%APPDATA%\revolut-x\
自定义路径
REVOLUTX_CONFIG_DIR
环境变量

Error Reference

错误参考

ErrorCauseFix
Auth not configuredMissing API key or private keyRun 
revx configure
Authentication failed (401)Invalid key or signatureRe-register public key at exchange.revolut.com
Network errorConnection/timeout failureCheck connectivity, retry
错误信息原因修复方法
未配置认证缺少API密钥或私钥运行
revx configure
认证失败（401）密钥或签名无效在exchange.revolut.com重新注册公钥
网络错误连接/超时失败检查网络连接，重试

Next Steps

后续步骤

Once configured, explore:
  • Check your balances and order history — see 
    revx-account
    skill
  • View market prices and candles — see 
    revx-market
    skill
  • Place your first order — see 
    revx-trading
    skill
配置完成后，可探索以下功能：
  • 查看账户余额和订单历史——查看
    revx-account
    技能
  • 查看市场价格和K线——查看
    revx-market
    技能
  • 下达首笔订单——查看
    revx-trading
    技能

Related Skills

相关技能

SkillPurpose
revx-market
Currencies, pairs, tickers, candles, order book
revx-account
Balances, order queries, trade history, events
revx-trading
Place and cancel orders
revx-monitor
Live price/indicator alerts
revx-telegram
Telegram notification setup
revx-strategy
Grid bot backtest, optimize, run
技能用途
revx-market
货币、交易对、行情、K线、订单簿
revx-account
余额、订单查询、交易历史、事件记录
revx-trading
下单与撤单
revx-monitor
实时价格/指标提醒
revx-telegram
Telegram通知设置
revx-strategy
网格机器人回测、优化、运行