OKX DeFi ポートフォリオ

複数のプロトコルとチェーン間でDeFiポジションと保有資産を確認するための2つのコマンド。

スキルのルーティング

• DeFiの預金/引き出し/請求 → okx-defi-invest を使用
• トークン価格/チャート → okx-dex-market を使用
• ウォレットトークン残高 → okx-wallet-portfolio を使用
• DEXスポットスワップ → okx-dex-swap を使用

クイックスタート

# チェーン全体のDeFi保有資産概要を取得
onchainos defi positions \
  --address 0xYourWallet \
  --chains ethereum,bsc,solana

# 特定のプロトコルの詳細保有資産を取得 (analysisPlatformIdはpositionsの出力から)
onchainos defi position-detail \
  --address 0xYourWallet \
  --chain ethereum \
  --platform-id 67890

コマンドインデックス

#	コマンド	説明
1	onchainos defi support-chains	DeFiでサポートされているチェーンを取得
2	onchainos defi support-platforms	DeFiでサポートされているプラットフォームを取得
3	onchainos defi positions --address <addr> --chains <chains>	ユーザーのDeFi保有資産概要を取得
4	onchainos defi position-detail --address <addr> --chain <chain> --platform-id <id>	プロトコルの詳細保有資産を取得

チェーンサポート

チェーン	名前 / エイリアス	chainIndex
Ethereum	ethereum, eth	1
BSC	bsc, bnb	56
Polygon	polygon, matic	137
Arbitrum	arbitrum, arb	42161
Base	base	8453
X Layer	xlayer, okb	196
Avalanche	avalanche, avax	43114
Optimism	optimism, op	10
Fantom	fantom, ftm	250
Sui	sui	784
Tron	tron, trx	195
TON	ton	607
Linea	linea	59144
Scroll	scroll	534352
zkSync	zksync	324
Solana	solana, sol	501

実行フロー

ステップ0: アドレス解決

ユーザーがウォレットアドレスを指定しない場合、DeFiコマンド実行前にエージェントウォレットから自動的に解決します:

1. onchainos wallet status          → ログイン状態を確認、アクティブアカウントを取得
2. onchainos wallet addresses       → チェーンカテゴリ別のアドレスを取得:
                                       - XLayer アドレス
                                       - EVM アドレス (Ethereum, BSC, Polygon等)
                                       - Solana アドレス
3. ターゲットチェーンにアドレスをマッチング:
   - EVM チェーン → EVM アドレスを使用
   - Solana     → Solana アドレスを使用
   - XLayer     → XLayer アドレスを使用

ルール:

• ユーザーが明示的なアドレスを指定した場合、それを直接使用 — このステップをスキップ
• ウォレットがログインしていない場合、ユーザーにログインするよう求める (→ okx-agentic-wallet) か、手動でアドレスを提供するよう求める
• ユーザーが「すべてのアカウントをチェック」または「すべてのウォレット」と言った場合、wallet balance --all ですべてのアカウントIDを取得し、各アカウントについて wallet switch <id> + wallet addresses を実行し、各アカウントのポジションをクエリ
• アカウントが同じタイプの複数のアドレスを持つ場合、解決されたアドレスを進める前にユーザーに確認

ステップ1: インテント識別

ユーザーの発言	アクション
ポジション / ポートフォリオ / 保有資産を表示	onchainos defi positions
プロトコルの詳細を表示	onchainos defi position-detail
表示後に引き出し / 請求	提案 → okx-defi-invest を使用

ステップ2: パラメータ収集

• 不明なウォレットアドレス → ステップ0 (wallet status → wallet addresses) で解決、またはログインしていない場合はユーザーに確認
• 不明なチェーン → ユーザーにクエリするチェーンを尋ねるか、一般的なもの (ethereum, bsc, solana) を提案
• 不明なplatform-id → まず defi positions を実行して analysisPlatformId を取得

ステップ3: 結果を表示

Positionsの結果表示

defi positions 出力を表示する場合、正確にこの順序でこれらの列を使用する必要があります — 代替や省略は不可:

#	Platform	analysisPlatformId	Chains	Positions	Value(USD)
1	Aave V3	12345	ETH,BSC	2	$120.00

ルール:

• analysisPlatformId はすべての行に必須 — ユーザーはこの値をコピーして position-detail を実行する必要があります
• analysisPlatformId を省略、非表示、または他のフィールドで置き換えない
• プラットフォームをグループ化しない — 値の大きさに関わらず、すべてのプラットフォームを独立した行として表示
• Raw JSON パス: walletIdPlatformList[*].platformList[*] — 各要素が1つのプラットフォーム行
  • platformName → Platform
  • analysisPlatformId → analysisPlatformId
  • networkBalanceList[*].network → Chains (カンマで結合)
  • investmentCount → Positions
  • currencyAmount → Value(USD)

Position詳細結果の表示

出力形態: { "ok": true, "data": [ { "walletIdPlatformDetailList": [...] }, ... ] } — data は配列です。data に対して直接 .get() を呼び出さないでください。リストとして反復処理します。

defi position-detail 出力を表示する場合、以下の正確な列で1つの統合テーブルにすべてのトークンをレンダリングします:

Type	Asset	Amount	Value(USD)	investmentId	aggregateProductId	Token Contract	Rewards
Supply	USDT	1.002285	$1.0025	127	71931	0x970223...7	0.000080 AVAX
Pending	sAVAX	0.00000091	$0.000012	–	–	–	Platform reward

ルール:

• 各トークン行が1行です。その親投資エントリから investmentId と aggregateProductId を結合します
• investmentId はすべての行に必須 — ユーザーは redeem/claim に必要です (via okx-defi-invest)
• aggregateProductId — 存在する場合は表示、その他は –
• Token Contract: 短縮なし完全なコントラクトアドレスを表示。ネイティブ/空の場合は – を表示
• Rewards: 保留中の報酬額とシンボルがあれば表示、ない場合は –。プラットフォーム報酬の場合は Platform reward を表示
• Type: investType をマップ → Supply/Borrow/Stake/Farm/Pool等。保留中報酬行は Pending を使用
• ヘルスレート: テーブルの下に別途表示。healthRate < 1.5 の場合は警告を表示

V3プールポジション — 追加フィールド

V3プールポジション (positionList が存在) の場合、ポジションごとに追加セクションを表示:

tokenId	Status	Range	tickLower	tickUpper
93828	ACTIVE	0.892 – 0.992 USDC/DAI	-33500	-30450

• tokenId: positionList[].tokenId から
• positionStatus: ACTIVE または INACTIVE
• range: positionList[].range から
• tickLower / tickUpper: positionList[].rangeInfo.tickLower / rangeInfo.tickUpper から
• これらのフィールドはV3オペレーション (流動性追加、引き出し、V3手数料請求) に重要

investTypeリファレンス

investType	説明
1	Save (貯蓄/イールド)
2	Pool (流動性プール)
3	Farm (イールドファーミング)
4	Vaults
5	Stake
6	Borrow
7	Staking
8	Locked
9	Deposit
10	Vesting

実行後の提案

完了したコマンド	提案
defi positions	1. 詳細を表示 → defi position-detail 2. 引き出し → okx-defi-invest 3. 報酬を請求 → okx-defi-invest
defi position-detail	1. ポジションを引き出し → テーブルの investmentId で okx-defi-invest を使用 2. 報酬を請求 → okx-defi-invest を使用 3. さらに追加 → okx-defi-invest を使用
defi position-detail (V3プール)	1. デプスチャートを表示 → defi depth-price-chart --investment-id <id> (via okx-defi-invest) 2. 価格履歴を表示 → defi depth-price-chart --investment-id <id> --chart-type PRICE

グローバルノート

• 重要 — アドレスチェーン互換性: --address と --chains パラメータは互換性がある必要があります。EVMアドレス (0x…) はEVMチェーンのみクエリ可能です。Solanaアドレス (base58) は solana のみクエリ可能です。1つの呼び出しで混在させないでください — APIはエラー84019 (アドレス形式エラー) を返します。
  • 0x… アドレス → EVMチェーンのみ渡す: ethereum,bsc,polygon,arbitrum,base,xlayer,avalanche,optimism,fantom,linea,scroll,zksync
  • base58アドレス → solana のみ渡す
  • Suiアドレス → sui のみ渡す
  • Tronアドレス (T…) → tron のみ渡す
  • TONアドレス → ton のみ渡す
  • ユーザーがEVMとSolanaの両方をまたいでポジションを望む場合、各アドレスで2つの別別の呼び出しを行う
• defi positions は --chains (複数形、カンマ区切り、例: --chains ethereum,bsc) を使用 — --chain を使用しないでください
• defi position-detail は --chain (単数) を使用 — --chains を使用しないでください
• ウォレットアドレスパラメータは両方のコマンドで --address です
• position-detail は positions 出力から analysisPlatformId を --platform-id として必要とします
• CLIはチェーン名を自動的に解決します (ethereum → 1, bsc → 56, solana → 501)