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:

Generate an Ed25519 keypair (private + public key)
Display your public key — copy it
Prompt you to register the public key at exchange.revolut.com -> Profile -> API Keys
Create a new API key — tick the "Allow usage via Revolut X MCP and CLI" checkbox
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                 # 交互式设置向导

该命令将执行以下操作：

生成Ed25519密钥对（私钥+公钥）
显示你的公钥——请复制它
提示你在exchange.revolut.com -> 个人资料 -> API密钥页面注册公钥
创建新的API密钥——勾选**"允许通过Revolut X MCP和CLI使用"**复选框
提示你输入注册后获得的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

配置文件位置

Platform	Path
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

错误参考

Error	Cause	Fix
Auth not configured	Missing API key or private key	Run `revx configure`
Authentication failed (401)	Invalid key or signature	Re-register public key at exchange.revolut.com
Network error	Connection/timeout failure	Check 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
```
技能

Skill	Purpose
`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`	网格机器人回测、优化、运行

revx-auth

Original

Translation

Auth & Account Setup (
`revx configure`
)

认证与账户设置（
`revx configure`
）

Prerequisites

前置条件

Install

安装

Getting Started

快速开始

Step 1: Configure Authentication

步骤1：配置认证

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使用"

Step 2: Verify Configuration

步骤2：验证配置

Config Commands

配置命令

Config Location

配置文件位置

Error Reference

错误参考

Next Steps

后续步骤

Related Skills

相关技能

revx-auth

Original

Translation

Auth & Account Setup (revx configure)

认证与账户设置（revx configure）

Prerequisites

前置条件

Install

安装

Getting Started

快速开始

Step 1: Configure Authentication

步骤1：配置认证

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使用"

Step 2: Verify Configuration

步骤2：验证配置

Config Commands

配置命令

Config Location

配置文件位置

Error Reference

错误参考

Next Steps

后续步骤

Related Skills

相关技能

Auth & Account Setup (
`revx configure`
)

认证与账户设置（
`revx configure`
）