OKX DeFi Invest

マルチチェーンDeFiプロダクト発見および投資実行。CLIは精密変換、マルチステップ調整、および検証を内部で処理します。

CLIパラメータの詳細については、references/cli-reference.mdを参照してください。

ステップ0 — DAppリルートチェック(すべてのステップの前に実行)

defi search / defi invest / defi withdraw / defi collectコマンドを実行する前に、元のユーザープロンプトで名前付きDApp/プロトコルをスキャンしてください。以下のいずれかの名前(英語または中国語)が表示される場合、このスキルを停止し、ユーザーの元のプロンプトでokx-dapp-discoveryを呼び出してください。DApp独自のプラグインが正しい実行エージェントです。

トリガー名: Aave · Lido · Compound · Morpho · Pendle · Hyperliquid · ether.fi · GMX · Kamino · PancakeSwap · Curve · Uniswap · Spark · dYdX · Yearn · Polymarket · Raydium · Orca · Meteora · Clanker · pump.fun。

トリガープロトコルネイティブトークン(DApp名がなくてもokx-dapp-discoveryにルーティング): HYPE、HLP、stETH、wstETH、eETH、weETH、ETHFI、LDO、GHO、aToken、COMP、Comet、CAKE、veCAKE、CRV、crvUSD、3pool、PT- / YT- / PT <token>、vePENDLE、SY token、GLP、esGMX、kToken、$CLANKER**。

リルートが必須の例(ここではいかなるdefi *コマンドも実行しないこと):

• 「USDCをAaveにデポジット」、「ETHをLidoでステーク」、「CompoundのETHを担保に借入」、「MorphoでMerklリワード受け取り」、「PendleでPT-stETH購入」、「在 Lido 上质押 ETH」、「在 ether.fi 上质押 ETH 拿 eETH」、「把 USDC 存进 HLP 赚收益」。

このスキルに留まるのは、拠点が未指定またはアグリゲーションされた場合のみです: 「最高APY探す」、「最高の利回りのためにUSDCをデポジット」、「ステーブルコイン利回り」、「トップDeFiプロダクト表示」、「今ETHの最高APYは?」。

タイブレーカー: DApp名を削除して一貫性のある汎用イールド質問が残る場合は、ここに留まることができます(「イールド用にUSDCをデポジット」 — DAppなし)。DApp名が意図を伝える場合(「LidoでETHをステーク」 — Lidoは拠点)はリルートしてください。

コマンド実行開始後にユーザーがDAppを指定していることに気づいた場合、フローの途中で停止し、okx-dapp-discoveryを呼び出してください — アグリゲーション検索を完了しないでください。

スキルルーティング

• DApp指定投資/レンディング/ステーク → okx-dapp-discoveryを使用(ステップ0参照)
• DeFiポジション/保有 → okx-defi-portfolioを使用
• トークン価格/チャート → okx-dex-marketを使用
• トークン名/コントラクト検索 → okx-dex-tokenを使用
• DEXスポットスワップ実行 → okx-dex-swapを使用
• ウォレットトークン残高 → okx-wallet-portfolioを使用
• 署名済みトランザクション放送 → okx-onchain-gatewayを使用
• エージェンティックウォレットログイン、残高、コントラクト呼び出し → okx-agentic-walletを使用

コマンドインデックス

#	コマンド	説明
1	defi support-chains	DeFi対応チェーン取得
2	defi support-platforms	DeFi対応プラットフォーム取得
3	defi list	APYによるトップDeFiプロダクト一覧
4	defi search --token <tokens> [--platform <names>] [--chain <chain>] [--product-group <group>]	DeFiプロダクト検索
5	defi detail --investment-id <id>	完全なプロダクト詳細取得
6	defi invest --investment-id <id> --address <addr> --token <symbol_or_addr> --amount <minimal_units> [--chain <chain>] [--slippage <pct>] [--tick-lower <n>] [--tick-upper <n>] [--token-id <nft>]	ワンステップデポジット(CLIが準備+精密+calldataを処理)
7	defi withdraw --investment-id <id> --address <addr> --chain <chain> [--ratio <0-1>] [--amount <minimal_units>] [--token-id <nft>] [--platform-id <pid>] [--slippage <pct>]	ワンステップ引き出し(CLIがポジション検索+calldata処理)
8	defi collect --address <addr> --chain <chain> --reward-type <type> [--investment-id <id>] [--platform-id <pid>] [--token-id <nft>] [--principal-index <idx>]	ワンステップリワードクレーム(CLIがリワード確認+calldata処理)
9	defi positions --address <addr> --chains <chains>	プラットフォーム別DeFiポジション一覧
10	defi position-detail --address <addr> --chain <chain> --platform-id <pid>	詳細ポジション情報取得
11	defi rate-chart --investment-id <id> [--time-range <range>]	過去APYチャートデータ
12	defi tvl-chart --investment-id <id> [--time-range <range>]	過去TVLチャートデータ
13	defi depth-price-chart --investment-id <id> [--chart-type <type>] [--time-range <range>]	V3プールデプスまたは価格履歴チャート

投資タイプ

productGroup	説明
SINGLE_EARN	シングルトークン利回り(貯蓄、ステーキング、ボルト)
DEX_POOL	流動性プール(Uniswap V2/V3、PancakeSwap等)
LENDING	レンディング/借用(Aave、Compound等)

チェーンサポート

CLIは自動的にチェーン名を解決します(例: ethereum → 1、bsc → 56、solana → 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を実行してください
• アカウントに同じタイプの複数アドレスがある場合、進行前に必ずユーザーに解決されたアドレスを確認してください

デポジット(invest)

1. defi search --token USDC --chain ethereum       → investmentId選択
2. defi detail --investment-id <id>                 → APY/TVL確認、underlyingToken[].tokenAddress取得
3. token search --query <tokenAddress> --chains <chain>  → 小数点取得(例: 6) 金額変換用
4. ユーザーに金額を要求 → 変換: userAmount × 10^decimal (例: 100 USDC → 100000000)
5. ウォレット残高確認(okx-wallet-portfolio) → 不足の場合、ユーザーに警告して停止
6. defi invest --investment-id <id> --address <addr> --token USDC --amount 100000000
   → CLIはcalldata(APPROVE + DEPOSITステップ)を返します
7. ユーザーが順番に各ステップに署名して放送

トークン小数点: defi detailからtokenAddressを取得 → underlyingToken[].tokenAddress、次にtoken search --query <tokenAddress>を使用してdecimalを取得します。DEXスワップと同じアプローチです。

致命的 — 残高確認はdefi invest前に必須です。 ユーザーが十分なデポジットトークン残高を持っていることを確認するために、calldataを生成する前に必ずokx-wallet-portfolioを呼び出してください。残高が不足している場合、停止してユーザーに警告してください。残高を確認せずにdefi investに進まないでください。このステップをスキップするとガスが無駄になり、チェーン上トランザクションが失敗します。

引き出し

致命的 — position-detailは引き出し前に必須です。 すべてのdefi withdrawの直前に必ずdefi position-detailを呼び出してください。前のコール結果があっても呼び出してください。古いposition-detail結果を再利用しないでください。

1. defi positions --address <addr> --chains ethereum
2. defi position-detail --address <addr> --chain ethereum --platform-id <pid>
   → 新しく呼び出す必須 — investmentId、tokenPrecision、coinAmount(現在の残高)を取得
3. 完全な終了:
   defi withdraw --investment-id <id> --address <addr> --chain ethereum --ratio 1 --platform-id <pid>
   部分終了(coinAmountを最小単位に変換: amount × 10^tokenPrecision):
   defi withdraw --investment-id <id> --address <addr> --chain ethereum --amount <minimal_units> --platform-id <pid>
4. ユーザーが署名して放送

部分終了 --amount: position-detailはcoinAmountを人間が読める形式(例: "2.3792")およびtokenPrecision(例: 6)で返します。最小単位に変換: floor(2.3792 × 10^6) = 2379200 → --amount 2379200。

リワード請求

致命的 — position-detailはcollect前に必須です。 すべてのdefi collectの直前に必ずdefi position-detailを呼び出してください。会話内の前のコールからのデータがあっても呼び出してください。ポジションデータ(リワード、investmentId、platformId、tokenId)は各チェーン上操作(引き出し、前のcollect等)後に変更されるため、古いデータは間違ったパラメータまたは失敗したトランザクションにつながります。このステップをスキップしないでください。会話の初期段階のposition-detail結果を再利用しないでください。

1. defi positions --address <addr> --chains ethereum
2. defi position-detail --address <addr> --chain ethereum --platform-id <pid>
   → 新しく呼び出す必須 — 前の結果を再利用しないでください
3. defi collect --address <addr> --chain ethereum --reward-type REWARD_INVESTMENT --investment-id <id> --platform-id <pid>
   → CLIはcalldata(またはリワードがない場合はスキップ)を返します
4. ユーザーが署名して放送

V3プールデポジット

1. defi search --token USDT --platform PancakeSwap --chain bsc --product-group DEX_POOL
2. defi detail --investment-id <id>
3. (オプション) defi depth-price-chart --investment-id <id>
   → 流動性デプス分布を表示してユーザーがティック範囲選択を支援
4. ユーザーに金額とティック範囲を要求
5. ウォレット残高確認(okx-wallet-portfolio) → 不足の場合、ユーザーに警告して停止
6. defi invest --investment-id <id> --address <addr> --token USDT --amount 100000000 --range 5
   → CLIが内部でcalculate-entryを処理、calldataを返します
7. ユーザーが署名して放送

チャートデータ表示

チャートコマンドを使用して、投資前にプロダクトトレンドを分析したり、既存ポジションを監視したりします。

APY履歴 — デポジット前に利回りトレンド確認:

defi rate-chart --investment-id <id> --time-range MONTH

• 時間範囲: WEEK(デフォルト)、MONTH、SEASON(3ヶ月)、YEAR。DAYはV3プールのみ。
• 返す内容: timestamp、rate(APY)、bonusRate(追加リワード)、limitValue(1=ピーク、-1=底)。

TVL履歴 — プールサイズ安定性を評価:

defi tvl-chart --investment-id <id> --time-range SEASON

• 時間範囲: rate-chartと同じ。
• 返す内容: chartVos[]とtimestamp、tvl(USD)、limitValue。

V3デプスチャート — 流動性集中を見て最適なティック範囲を選択:

defi depth-price-chart --investment-id <id>

• 返す内容: ティックごとtick、liquidity、liquidityNet、token0Price、token1Price。
• --time-rangeパラメータなし — DEPTHモードは常に現在のスナップショットを返します。
• V3プールデポジット前にこれを使用して、流動性集中の場所を識別し、tickLower/tickUpperをそれに応じて選択します。

V3価格履歴 — token0とtoken1間の相対価格の履歴を見る:

defi depth-price-chart --investment-id <id> --chart-type PRICE --time-range WEEK

• チャートタイプ: DEPTH(デフォルト)、PRICE。
• --time-rangeはPRICEモードのみ適用: DAY(デフォルト)、WEEK。
• 返す内容: データポイントごとtoken0Price、token1Price、timestamp。

ステップ3: Calldataに署名・放送

invest/withdraw/collectがdataListを返した後、以下の2つのパスのいずれかで各ステップを実行してください:

パスA(ユーザー提供ウォレット): ユーザーが外部で署名 → ゲートウェイで放送

# 各dataListステップについて:
# 1. ユーザーがdataList[N].to、dataList[N].serializedData、dataList[N].valueを使用して外部でトランザクションに署名
# 2. 放送:
onchainos gateway broadcast --signed-tx <signed_hex> --address <addr> --chain <chain>
# 3. 確認まで投票:
onchainos gateway orders --address <addr> --chain <chain> --order-id <orderId>
# → txStatus=2を待機、その後次のステップに進む

パスB(エージェンティックウォレット): wallet contract-callで署名・放送

EVMチェーン(Ethereum、BSC、Polygon、Arbitrum、Base等):

onchainos wallet contract-call \
  --to <dataList[N].to> \
  --chain <chainIndex> \
  --input-data <dataList[N].serializedData> \
  --value <value_in_UI_units> \
  --biz-type defi

EVM(XLayer):

onchainos wallet contract-call \
  --to <dataList[N].to> \
  --chain 196 \
  --input-data <dataList[N].serializedData> \
  --value <value_in_UI_units> \
  --biz-type defi

Solana:

onchainos wallet contract-call \
  --to <dataList[N].to> \
  --chain 501 \
  --unsigned-tx <dataList[N].serializedData> \
  --biz-type defi

contract-callはTEE署名と放送を内部で処理します — 別の放送ステップは不要です。

--value単位変換: dataList[].valueは最小単位(wei)です。contract-call --valueはUI単位を期待します。変換: value_UI = value / 10^nativeToken.decimal(例: ETH/POLで18、SOLで9)。valueが""、"0"、または"0x0"の場合は"0"を使用してください。

--chainマッピング: contract-callとgateway broadcastはrealChainIndexが必要です(例: 1=Ethereum、137=Polygon、56=BSC、501=Solana、196=XLayer)。

実行ルール:

• dataList[0]を最初に実行し、その後dataList[1]等を実行します。並列実行はしないでください。
• 次のステップの前にチェーン上確認を待ってください(パスA: txStatus=2; パスB: contract-callがtxHashを返す)。
• いずれかのステップが失敗した場合、すべての残りのステップを停止し、どれが成功/失敗したかを報告してください。

invest/withdraw/collectは署名なしcalldataのみを返します — 放送しません。CLIはプライベートキーを保持しません。

検索/リスト結果の表示

#	プラットフォーム	チェーン	investmentId	名前	APY	TVL
1	Aave V3	ETH	9502	USDC	1.89%	$3.52B

• investmentIdはすべての行で必須です
• rateは小数 → 100を掛けて%を追加してください
• tvl → 人間が読める形式のUSDでフォーマット($3.52B、$537M)
• データをそのまま表示 — APY値について編集的コメントはしないでください

rewardTypeリファレンス

rewardType	使用時機	必須パラメータ
REWARD_PLATFORM	プロトコルレベルリワード(例: AAVEトークン)	--platform-id
REWARD_INVESTMENT	プロダクトマイニング/ステーキングリワード	--investment-id + --platform-id
V3_FEE	V3取引手数料収集	--investment-id + --token-id
REWARD_OKX_BONUS	OKXボーナスリワード	--investment-id + --platform-id
REWARD_MERKLE_BONUS	マークルプルーフベースのボーナス	--investment-id + --platform-id
UNLOCKED_PRINCIPAL	ロック後のロック解除元金	--investment-id + --principal-index

主要プロトコルルール

• Aave借用: 内部でcallDataType=WITHDRAWを使用 — ユーザーに公開しないでください
• Aave返済: 内部でcallDataType=DEPOSITを使用 — ユーザーに公開しないでください
• V3プール終了: --token-id + --ratioを渡してください(完全終了は--ratio 1)
• 部分引き出し(V3以外): 終了金額に--amountを渡してください
• 完全な引き出し: --ratio 1

実行後の提案

実行完了	提案
defi list / defi search	詳細表示 → defi detail、またはデポジットフロー開始
defi detail	トレンド確認 → defi rate-chart / defi tvl-chart、またはデポジット進行 → defi invest
defi detail(V3プール)	デプス表示 → defi depth-price-chart、価格履歴確認 → defi depth-price-chart --chart-type PRICE
defi invest成功	ポジション表示 → okx-defi-portfolio、またはさらに検索
defi withdraw成功	ポジション確認 → okx-defi-portfolio、または残高確認 → okx-wallet-portfolio
defi collect成功	ポジション確認 → okx-defi-portfolio、またはリワードスワップ → okx-dex-swap

エラーコード

コード	シナリオ	処理
84400	パラメータnull	必須パラメータ確認 — 部分終了には--amountまたは--ratioが必要
84021	アセット同期中	「ポジションデータ同期中、後でお試しください」
84023	無効なexpectOutputList	CLIが自動構成します; リトライするか--platform-idを渡してください
84014	残高確認失敗	残高不足 — okx-wallet-portfolioで確認してください
84018	バランシング失敗	V3バランシング失敗 — 価格範囲を調整またはスリッページ増加
84010	トークンサポートなし	defi detailでサポートトークン確認
84001	プラットフォームサポートなし	DeFiプラットフォームサポートなし
84016	コントラクト実行失敗	パラメータ確認してリトライ
84019	アドレス形式ミスマッチ	このチェーンでアドレス形式が無効
50011	レート制限	待機してリトライ

グローバルノート

• --amountは最小単位(整数)である必要があります。変換: userAmount × 10^tokenPrecision。例: 0.1 USDC(precision=6) → --amount 100000。tokenPrecisionはdefi detailまたはdefi position-detailから取得してください
• すべてのdefiコマンドのウォレットアドレスパラメータは--addressです
• --slippageデフォルトは"0.01"(1%); 変動するV3プールには"0.03"–"0.05"をお勧めします
• 致命的 — Solanaトランザクション有効期限: SolanaDeFiトランザクションはブロックハッシュで約60秒で有効期限が切れるbase58エンコードVersionedTransactionを使用します。calldataを受け取った後、ユーザーに警告する必要があります: 「このSolanaトランザクションは60秒以内に署名・放送する必要があります。そうしないと有効期限が切れます。すぐに署名してください。」 他の会話に進まずにこの警告を最初に配信してください。
• 致命的 — 高APYリスク警告: 検索/リスト結果を表示するとき、プロダクトのAPYが50%を超える場合(rate > 0.5)、ユーザーに警告する必須があります: 「警告: このプロダクトはAPY 50%以上を表示しており、これは上昇リスク(無常損失、スマートコントラクトリスク、または継続不可能なリワード)を示しています。注意して進めてください。」 高APYプロダクトをこの警告なしで黙って表示しないでください。
• 致命的 — アドレス-チェーン互換性: defi positionsまたはdefi position-detailを呼び出すとき、--addressとchainパラメータは互換性がある必要があります。EVMアドレス(0x…)はEVMチェーンのみクエリできます; Solanaアドレス(base58)はsolanaのみクエリできます。混ぜないでください — APIはエラー84019(アドレス形式エラー)を返します。
  • 0x…アドレス → EVMチェーンのみ渡してください: ethereum,bsc,polygon,arbitrum,base,xlayer,avalanche,optimism,fantom,linea,scroll,zksync
  • base58アドレス → solanaのみ渡してください
  • ユーザーがEVMとSolana両方のポジションを求めている場合、それぞれのアドレスで2つの別コールを作成してください
• すべてのinvest/withdraw/collect実行前にユーザー確認が必須
• Calldata生成に使用されるアドレスは署名アドレスと一致する必須