mcpField
P
pionex-wallet

pionex-wallet

github.com/pionex-officialOther584 installsUpdated 14w ago
Repository

About pionex-wallet

pionex-wallet is a skill for querying the total value of a Pionex portfolio across account types. It reports USDT and BTC totals with account-level breakdowns and performs read-only queries.

Key features

  1. 01Query total portfolio value in USDT and BTC
  2. 02Break down totals by account type
  3. 03Display account titles in English

Use cases

  1. 01Check the combined value of a Pionex account
  2. 02Compare balances across bot and spot accounts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pionex-official/pionex-skills --skill pionex-wallet

After installing, type/pionex-walletin Claude Code to confirm it loaded.

Details

From the project README

Pionex Wallet Skill

Query the full Pionex portfolio overview: total USDT/BTC value across all account types. Requires API credentials (pionex-ai-kit onboard).

When to use

  • User asks: total portfolio value, overall balance, "how much is my whole Pionex account worth", "spot + bot total", breakdown by account type (bots vs spot vs dual investment).
  • User wants a consolidated view — not just spot coins, not just one bot.

Command

CommandTypeDescription
pionex-trade-cli wallet balance_fullREADFull portfolio overview: USDT/BTC grand total + per-account-type breakdown.
pionex-trade-cli wallet balance_full --app-lang enREADSame, force English display names in title fields.

No write operations — --dry-run is not applicable.

Prerequisites

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

Output Structure

{
  "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", ... }
  }
}
How to summarize the output
  1. Report data.totalInUsdt and data.totalInBtc as the grand total.
  2. For a breakdown, iterate data.botAccount.detail — report each title + totalInUsdt.
  3. Include data.traderAccount.totalInUsdt if non-zero.
  4. Skip data.prices and data.extractBalances unless the user explicitly asks.
  5. Round to 2 decimal places for display.

Skill routing

ScopeSkill
Total portfolio / full overviewpionex-wallet (this skill)
Spot coin list (per-coin balances)pionex-portfolio
Market prices onlypionex-market
Place / cancel spot orderspionex-trade
Futures/Spot Grid Bot lifecyclepionex-bot

Example

  • User: "What's my total Pionex account value?"
  • Agent: run pionex-trade-cli wallet balance_full, then report:

    Total: $3,958.80 (≈ 0.0494 BTC)

    • Futures Lite bots: $3,928.24
    • Spot Balances: $0.49
    • Dual Investment: $30.06
    • Pionex Card: $0.00

Comments

Markdown supported