SuperAPI AI 工具集

revolut-x-balance

办公与效率

查看项目

更新于 10-16 07:59

技能介绍

用途:查询 Revolut X 账户余额,并在下单前验证资金是否充足。

主要能力:获取全部账户余额(available 可用、reserved 预留、staked 质押、total 总额);验证下单所需资金;结合行情数据把持仓换算为法币价值。查询命令为 python scripts/revx_sign.py GET /api/1.0/balances,返回余额对象的 JSON 数组。字段含义:available 可用于新订单的资金,reserved 被未成交订单锁定的资金,staked 正在赚取质押奖励的资金,total 为三者之和。

使用方式:所有端点均需认证,配置参见 revolut-x-auth;接口统一使用基于路径的版本 /api/1.0/。典型流程是先调用余额端点获取数据,再以 currency、available、reserved、total 等关键字段展示为表格。验证资金时,找到对应币种条目并比较 available 与目标金额;计算组合法币价值时,需另行取行情端点 /api/1.0/tickers 的 last_price 并逐项相乘求和。

适用场景:查询余额、下单前校验资金、估算持仓法币总值。

限制与错误处理:需先完成 API 密钥与签名设置,并确保 REVX_API_KEY 与 REVX_PRIVATE_KEY 环境变量正确;返回 401 表示密钥或签名无效,需重新执行 revolut-x-auth 设置;返回 429 表示超出速率限制,应按 Retry-After 头部指示(毫秒)等待后重试。available 不含被未成交订单锁定的资金,故应以其作为下单前校验依据;余额为零的币种仍可能出现在响应中。相关技能包括 revolut-x-auth(认证与签名)、revolut-x-orders(下单)、revolut-x-configuration(可用币种与交易对约束)、revolut-x-market-data(获取行情价格)。更多字段定义参见 schemas.md 与 Revolut X REST API 文档。