pionex-wallet

Pionex Wallet スキル

すべてのアカウントタイプにわたる、Pionex ポートフォリオ全体の USDT/BTC の合計額を照会します。API 認証情報が必要です（pionex-ai-kit onboard）。

使用する場面

• ユーザーがポートフォリオの合計額、全体の残高、「Pionex アカウント全体の価値はいくらか」、「現物＋ボットの合計」、アカウントタイプ別（ボットと現物、デュアル投資）の内訳を尋ねた場合。
• ユーザーが統合ビューを求めている場合。現物コインだけでも、特定のボットだけでもありません。

コマンド

コマンド	種類	説明
pionex-trade-cli wallet balance_full	READ	ポートフォリオ全体の概要：USDT/BTC の総合計とアカウントタイプ別の内訳。
pionex-trade-cli wallet balance_full --app-lang en	READ	同じ内容を表示します。title フィールドの表示名は英語に固定されます。

書き込み操作はありません。--dry-run は適用されません。

前提条件

npm install -g @pionex/pionex-ai-kit
pionex-ai-kit onboard

出力構造

{
  "result": true,
  "data": {
    "totalInUsdt": "<grand total in USDT>",
    "totalInBtc":  "<grand total in BTC>",
    "botAccount": {
      "totalInUsdt": "<all bot types combined>",
      "detail": [
        { "type": "futures_lite", "title": "Futures Lite",    "totalInUsdt": "...", "count": 1 },
        { "type": "spot",         "title": "Spot Balances",   "totalInUsdt": "..." },
        { "type": "dual_manual",  "title": "Dual investment", "totalInUsdt": "..." },
        { "type": "pionex_card",  "title": "Pionex Card",     "totalInUsdt": "..." }
      ]
    },
    "traderAccount": { "title": "Trader Account", "totalInUsdt": "..." },
    "extractBalances": {
      "propTrading":      { "totalInUsdt": "..." },
      "trialFundCoupon":  { "totalInUsdt": "..." }
    },
    "prices": { "btc": "...", "eth": "...", "usdt": "1", ... }
  }
}

出力の要約方法

1. data.totalInUsdt と data.totalInBtc を総合計として報告します。
2. 内訳を示す場合は、data.botAccount.detail を反復処理し、各 title と totalInUsdt を報告します。
3. 0 以外の場合は data.traderAccount.totalInUsdt を含めます。
4. ユーザーから明示的に求められない限り、data.prices と data.extractBalances は省略します。
5. 表示時は小数点以下 2 桁に丸めます。

スキルの振り分け

対象	スキル
ポートフォリオ合計／全体の概要	pionex-wallet（このスキル）
現物コイン一覧（コインごとの残高）	pionex-portfolio
市場価格のみ	pionex-market
現物注文の発注／キャンセル	pionex-trade
先物／現物グリッドボットのライフサイクル	pionex-bot

例

• ユーザー：「Pionex アカウント全体の価値はいくらですか？」
• エージェント：pionex-trade-cli wallet balance_full を実行して、次のように報告します：

  合計：$3,958.80（約 0.0494 BTC）

  • Futures Lite ボット：$3,928.24
  • 現物残高：$0.49
  • デュアル投資：$30.06
  • Pionex Card：$0.00