OpenTrade 钱包投资组合 CLI 是做什么的?
4 个命令,用于支持的链、钱包总价值、所有代币余额以及特定代币余额。
起飞前检查
每次运行任何 opentrade 命令之前,务必按顺序执行以下步骤。不要将常规命令输出回显给用户;仅在安装、更新或处理失败时提供简短的状态更新。
-
确认已安装:运行
which opentrade。如果未找到,请安装:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh如果安装脚本失败,请要求用户按照以下说明手动安装:https://github.com/6551Team/openskills
-
检查更新:读取
~/.opentrade/last_check并与当前时间戳比较:cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true) now=$(date +%s)- 如果
cached_ts非空且(now - cached_ts) < 43200(12 小时),则跳过更新并继续。 - 否则(文件缺失或早于 12 小时),运行安装程序以检查更新:
如果安装了新版本,请告知用户并建议他们从 https://github.com/6551Team/openskills 更新 opentrade 技能以获取最新功能。curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
- 如果
-
如果在此会话期间任何
opentrade命令因意外错误而失败,请在放弃前尝试重新安装:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh -
在项目根目录找到或创建 .env 文件以覆盖默认 API 凭据。在执行 opentrade 操作前加载它。
OPEN_TOKEN=your_token_here在 https://6551.io/mcp 获取您的 API 令牌。
安全警告:切勿将 .env 提交到 git(将其添加到 .gitignore),切勿在日志、截图或聊天消息中暴露凭据。
路由器发现
重要:如果用户未指定交易路由器,您必须首先发现可用的路由器:
opentrade trade routers
响应格式:
{
"ok": true,
"data": [
{
"api": "v2",
"created_at": "2026-03-10 01:15:42",
"is_active": true,
"name": "6551dex test",
"quota_reward": 0,
"trader": "6551dex",
"updated_at": "2026-03-10 01:15:42"
},
{
"api": "v1",
"created_at": "2026-03-03 21:24:34",
"is_active": true,
"name": "okx test",
"quota_reward": 0,
"trader": "okx",
"updated_at": "2026-03-03 21:24:34"
}
]
}
用法:
- 从响应中提取
trader和api - 强制性:此会话中的所有后续
opentrade命令必须包含--trader <trader>和--api <api>标志 - 示例:
opentrade portfolio balance 0x... --chain ethereum --trader okx --api v1 - 默认回退:如果 API 返回空数据,请使用
--trader okx --api v1
技能路由
- 代币价格/K 线 → 使用
opentrade-market - 代币搜索/元数据 → 使用
opentrade-token - 执行交换 → 使用
opentrade-dex-swap - 交易广播 → 使用
opentrade-gateway
快速开始
# 获取余额查询支持的链
opentrade portfolio chains
# 获取 XLayer 和 Solana 上的总资产价值
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# 获取所有代币余额
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# 检查特定代币(XLayer 上的原生 OKB + USDC)
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
链名称支持
CLI 接受人类可读的链名称并自动解析。
| 链 | 名称 | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
地址格式说明:EVM 地址(0x...)适用于 Ethereum/BSC/Polygon/Arbitrum/Base 等。Solana 地址(Base58)和 Bitcoin 地址(UTXO)格式不同。不要在链类型之间混用格式。
命令索引
| # | 命令 | 描述 |
|---|---|---|
| 1 | opentrade portfolio chains | 获取余额查询支持的链 |
| 2 | opentrade portfolio total-value --address ... --chains ... | 获取钱包的总资产价值 |
| 3 | opentrade portfolio all-balances --address ... --chains ... | 获取钱包的所有代币余额 |
| 4 | opentrade portfolio token-balances --address ... --tokens ... | 获取特定代币余额 |
跨技能工作流
该技能通常在 交换前(用于验证余额是否充足)使用,或者作为 投资组合入口点 使用。
工作流 A:交换前余额检查
用户:“将 1 SOL 换成 BONK”
1. opentrade-token opentrade token search BONK --chains solana → 获取 tokenContractAddress
↓ tokenContractAddress
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains solana
→ 验证 SOL 余额 >= 1
↓ 余额字段(UI 单位)→ 转换为最小单位用于交换
3. opentrade-dex-swap opentrade swap quote --from 11111111111111111111111111111111 --to <BONK_address> --amount 1000000000 --chain solana
4. opentrade-dex-swap opentrade swap swap --from ... --to <BONK_address> --amount 1000000000 --chain solana --wallet <addr>
数据交接:
tokenContractAddress来自代币搜索 → 输入到交换的--from/--tobalance来自投资组合是 UI 单位;交换需要 最小单位 → 乘以10^decimal- 如果余额 < 所需金额 → 通知用户,不要进行交换
工作流 B:投资组合概览 + 分析
用户:“显示我的投资组合”
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ 总 USD 价值
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ 按代币细分
↓ 按 USD 价值排名的前几项持仓
3. opentrade-token opentrade token price-info <address> --chain <chain> → 补充 24 小时变化、市值等信息
4. opentrade-market opentrade market kline <address> --chain <chain> → 感兴趣代币的价格图表
工作流 C:卖出表现不佳的代币
1. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ 列出所有持仓
↓ 每个持仓的 tokenContractAddress + chainIndex
2. opentrade-token opentrade token price-info <address> --chain <chain> → 获取每个代币的 priceChange24H
3. 筛选出负变化 → 用户确认要卖出的代币
4. opentrade-dex-swap opentrade swap quote → opentrade swap swap → 执行卖出
关键转换:balance(UI 单位)× 10^decimal = amount(最小单位)用于交换。
操作流程
步骤 1:识别意图
- 检查总资产 →
opentrade portfolio total-value - 查看所有代币持仓 →
opentrade portfolio all-balances - 检查特定代币余额 →
opentrade portfolio token-balances - 不确定哪些链受支持 → 首先运行
opentrade portfolio chains
步骤 2:收集参数
- 缺少钱包地址 → 询问用户
- 缺少目标链 → 推荐 XLayer(
--chains xlayer,低 gas,快速确认)作为默认选项,然后询问用户偏好哪条链。常见集合:"xlayer,solana,ethereum,base,bsc" - 需要过滤风险代币 → 设置
--exclude-risk 0(仅适用于 ETH/BSC/SOL/BASE)
步骤 3:调用并显示
- 总价值:显示 USD 金额
- 代币余额:显示代币名称、数量(UI 单位)、USD 价值
- 按 USD 价值降序排列
步骤 4:建议后续操作
显示结果后,建议 2-3 个相关后续操作:
| 刚完成的操作 | 建议 |
|---|---|
portfolio total-value | 1. 查看代币级别的细分 → opentrade portfolio all-balances(此技能)2. 查看持仓前几项的价格趋势 → opentrade-market |
portfolio all-balances | 1. 查看某个代币的详细分析(市值、24 小时变化)→ opentrade-token 2. 交换代币 → opentrade-dex-swap 3. 查看代币价格图表 → opentrade-market |
portfolio token-balances | 1. 查看跨所有代币的完整投资组合 → opentrade portfolio all-balances(此技能)2. 交换此代币 → opentrade-dex-swap |
以对话方式呈现,例如:“您想查看您主要持仓的价格图表,还是交换其中一些代币?”——切勿向用户暴露技能名称或端点路径。
CLI 命令参考
1. opentrade portfolio chains
获取余额查询支持的链。无需参数。
opentrade portfolio chains
返回字段:
| 字段 | 类型 | 描述 |
|---|---|---|
name | String | 链名称(例如 "XLayer") |
logoUrl | String | 链徽标 URL |
shortName | String | 链短名称(例如 "OKB") |
chainIndex | String | 链唯一标识符(例如 "196") |
2. opentrade portfolio total-value
获取钱包地址的总资产价值。
opentrade portfolio total-value --address <address> --chains <chains> [--asset-type <type>] [--exclude-risk <bool>]
| 参数 | 必需 | 默认值 | 描述 |
|---|---|---|---|
--address | 是 | - | 钱包地址 |
--chains | 是 | - | 链名称或 ID,逗号分隔(例如 "xlayer,solana" 或 "196,501") |
--asset-type | 否 | "0" | 0=全部,1=仅代币,2=仅 DeFi |
--exclude-risk | 否 | true | true=过滤风险代币,false=包含。仅适用于 ETH/BSC/SOL/BASE |
返回字段:
| 字段 | 类型 | 描述 |
|---|---|---|
totalValue | String | 以 USD 计的总资产价值 |
3. opentrade portfolio all-balances
获取钱包地址的所有代币余额。
opentrade portfolio all-balances --address <address> --chains <chains> [--exclude-risk <value>]
| 参数 | 必需 | 默认值 | 描述 |
|---|---|---|---|
--address | 是 | - | 钱包地址 |
--chains | 是 | - | 链名称或 ID,逗号分隔,最多 50 条 |
--exclude-risk | 否 | "0" | 0=过滤掉风险代币(默认),1=包含。仅适用于 ETH/BSC/SOL/BASE |
返回字段(tokenAssets[] 中每个代币):
| 字段 | 类型 | 描述 |
|---|---|---|
chainIndex | String | 链标识符 |
tokenContractAddress | String | 代币合约地址 |
symbol | String | 代币符号(例如 "OKB") |
balance | String | 代币余额,以 UI 单位表示(例如 "10.5") |
rawBalance | String | 代币余额,以基础单位表示(例如 "10500000000000000000") |
tokenPrice | String | 代币价格,以 USD 计 |
isRiskToken | Boolean | true 表示标记为风险代币 |
4. opentrade portfolio token-balances
获取钱包地址的特定代币余额。
opentrade portfolio token-balances --address <address> --tokens <tokens> [--exclude-risk <value>]
| 参数 | 必需 | 默认值 | 描述 |
|---|---|---|---|
--address | 是 | - | 钱包地址 |
--tokens | 是 | - | 代币列表:"chainIndex:tokenAddress" 对,逗号分隔。使用空地址表示原生代币(例如 "196:" 表示原生 OKB)。最多 20 个项目。 |
--exclude-risk | 否 | "0" | 0=过滤掉(默认),1=包含 |
返回字段:与 all-balances 相同的模式(tokenAssets[])。
输入/输出示例
用户说:“检查我在 XLayer 和 Solana 上的钱包总资产”
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# → 显示:总资产 $12,345.67
用户说:“显示我钱包里的所有代币”
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# → 显示:
# OKB: 10.5 ($509.25)
# USDC: 2,000 ($2,000.00)
# USDT: 1,500 ($1,500.00)
# ...
用户说:“只检查 XLayer 上的 USDC 和原生 OKB 余额”
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
# → 显示:OKB: 10.5 ($509.25), USDC: 2,000 ($2,000.00)
边界情况
- 零余额:有效状态——显示
$0.00,不是错误 - 不支持的链:先调用
opentrade portfolio chains确认 - 链数超过 50:分批处理,每次请求最多 50 条
--exclude-risk不生效:仅在 ETH/BSC/SOL/BASE 上受支持- DeFi 持仓:使用
--asset-type 2单独查询 DeFi 持仓 - 地址格式不匹配:在 Solana 链上使用 EVM 地址将返回空数据——不要混用
- 网络错误:重试一次,然后提示用户稍后重试
- 区域限制(错误码 50125 或 80001):不要向用户显示原始错误码。而是显示一条友好的消息:
⚠️ 您所在的区域无法使用此服务。请切换到受支持的区域后重试。
金额显示规则
- 代币金额使用 UI 单位(
1.5 ETH),绝不使用基础单位(1500000000000000000) - USD 值保留 2 位小数
- 大金额使用简写(
$1.2M) - 按 USD 值降序排列
全局说明
--chains支持最多 50 个链 ID(逗号分隔,名称或数字均可)--asset-type:0=全部1=仅代币2=仅 DeFi(仅适用于total-value)--exclude-risk仅适用于 ETH(1)/BSC(56)/SOL(501)/BASE(8453)token-balances支持最多 20 个代币条目- CLI 自动解析链名称(例如
ethereum→1,solana→501) - CLI 通过环境变量内部处理身份验证——有关默认值,请参见前提条件步骤 4