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在以下位置取得您的 API 令牌:https://6551.io/mcp
安全警告:切勿將 .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
↓ balance 欄位(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/--to - 來自投資組合的
balance是 UI 單位;兌換需要 最小單位 → 乘以10^decimal - 如果餘額 < 所需金額 → 通知使用者,請勿繼續兌換
工作流程 B:投資組合概覽 + 分析
使用者:「顯示我的投資組合」
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ 總美元價值
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ 每個代幣的明細
↓ 按美元價值排序的前幾大持倉
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:呼叫並顯示
- 總價值:顯示美元金額
- 代幣餘額:顯示代幣名稱、數量(UI 單位)、美元價值
- 按美元價值降序排序
步驟 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 | 以美元計的總資產價值 |
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 | 以美元計的代幣價格 |
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) - 美元價值顯示 2 位小數
- 大額使用縮寫(
$1.2M) - 按美元價值降序排序
全域注意事項
--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 以取得預設值