mcpField
R
revx-account

revx-account

github.com/revolut-engineering其他74106 次安装1 周前更新
代码仓库

关于 revx-account

revx-account 是一项技能，通过 revx 命令行查询 Revolut X 余额、交易、订单和成交记录。它提供多种筛选条件及机器可读的 JSON 输出，适用于账户与交易活动查询。

主要功能

  1. 01按币种查询余额
  2. 02按日期和状态筛选交易
  3. 03查看未结订单与订单历史
  4. 04检查订单详情和成交记录
  5. 05查看私人及公开成交
  6. 06输出 JSON 格式数据

适用场景

  1. 01查看近期账户交易
  2. 02检查未结订单及成交情况
  3. 03查询手续费或链上交易详情
  4. 04对照私人和公开成交记录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/revolut-engineering/revolut-x-api --skill revx-account

安装后在 Claude Code 中输入/revx-account确认已加载。

详细介绍

账户、交易与订单查询

查看余额和交易、查询订单、浏览交易历史记录。

需要身份验证。 运行这些命令前，请确保已安装并配置 revx。如果任何命令因身份验证问题失败，例如出现 Auth not configured、No private key found、Authentication failed (401)、Invalid signature、insecure permissions，或在 ~/.config/revolut-x/ 中缺少密钥／配置文件，请立即调用 revx-auth skill 并自行应用修复。 不要中断用户并要求他们运行设置。只有在需要用户亲自完成的步骤上才向用户求助（粘贴 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> 返回一笔交易，并包含列表中未显示的字段：

  • 每条交易腿可能包含 fee 和 fee_currency，以及一个 account 对象，其中包含 type（revolut、revolut_x、external_fiat、external_crypto）、可选的 display_name（主 Revolut 账户显示为 Personal，储蓄金库显示为 Savings，X 子账户显示为 Crypto Primary 或账户名称，质押目标显示为 Staking），以及（对于外部加密货币钱包）crypto_address
  • order_id — 买入或卖出所对应的交易场所订单
  • crypto_transaction_hash 和 network — 外部加密货币发送／接收的链上信息
  • description — 有内容时显示的自由文本备注

费用最多出现在一条交易腿上：即货币与 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 epoch 毫秒。

订单详情和成交记录

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 就是平均执行价格；否则，它是提交时记录的价格。输出不会区分两者，因此需要实际平均成交价时，请查看 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 订单的触发条件；每项均包含触发价格、方向（≥/≤）、订单类型（market/limit）、有效时间，以及可选的限价
  • 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>，然后使用 revx order get <child-id> 检查每个关联的子订单 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 epoch 毫秒。

别名：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. 告知用户：“我会在每次迭代中运行这两条命令——可以将它们添加到你的权限允许列表吗？”
  3. 获得批准后，通过 update-config 添加 Bash(revx account balances*) 和 Bash(revx order open*)
  4. 启动 /loop 10m check balance and open orders
  5. 每次迭代都会分别调用两次 Bash——不会再出现提示

常见工作流

“我的 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-authAPI 密钥设置和配置

评论

支持 Markdown