OpenTrade Wallet Portfolio 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"
→ 合計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> → 24h変動、時価総額を補完
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、低ガス、高速確認)を推奨し、ユーザーの希望チェーンを尋ねる。一般的なセット:"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. トークンの詳細分析(時価総額、24h変動)を表示 → 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 | 文字列 | チェーン名(例:"XLayer") |
logoUrl | 文字列 | チェーンロゴURL |
shortName | 文字列 | チェーンの短縮名(例:"OKB") |
chainIndex | 文字列 | チェーン一意識別子(例:"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 | 文字列 | 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 | 文字列 | チェーン識別子 |
tokenContractAddress | 文字列 | トークンコントラクトアドレス |
symbol | 文字列 | トークンシンボル(例:"OKB") |
balance | 文字列 | UI単位のトークン残高(例:"10.5") |
rawBalance | 文字列 | 基本単位のトークン残高(例:"10500000000000000000") |
tokenPrice | 文字列 | USDでのトークン価格 |
isRiskToken | ブール値 | リスクありとフラグ付けされている場合は true |
4. opentrade portfolio token-balances
ウォレットアドレスの特定トークン残高を取得します。
opentrade portfolio token-balances --address <address> --tokens <tokens> [--exclude-risk <value>]
| パラメータ | 必須 | デフォルト | 説明 |
|---|---|---|---|
--address | はい | - | ウォレットアドレス |
--tokens | はい | - | トークンリスト:"chainIndex:tokenAddress" ペア、カンマ区切り。ネイティブトークンには空のアドレスを使用(例:ネイティブOKBの場合は "196:")。最大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アドレスは空データを返します — 混在しないでください
- ネットワークエラー: 1回再試行し、その後ユーザーに後で再試行するよう促す
- 地域制限(エラーコード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を参照