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
| Command |
Type |
Description |
pionex-trade-cli wallet balance_full |
READ |
Full portfolio overview: USDT/BTC grand total + per-account-type breakdown. |
pionex-trade-cli wallet balance_full --app-lang en |
READ |
Same, 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
- Report
data.totalInUsdt and data.totalInBtc as the grand total.
- For a breakdown, iterate
data.botAccount.detail — report each title + totalInUsdt.
- Include
data.traderAccount.totalInUsdt if non-zero.
- Skip
data.prices and data.extractBalances unless the user explicitly asks.
- Round to 2 decimal places for display.
Skill routing
| Scope |
Skill |
| Total portfolio / full overview |
pionex-wallet (this skill) |
| Spot coin list (per-coin balances) |
pionex-portfolio |
| Market prices only |
pionex-market |
| Place / cancel spot orders |
pionex-trade |
| Futures/Spot Grid Bot lifecycle |
pionex-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
1---2name: pionex-wallet3description: Use when the user asks for their total Pionex portfolio value, full balance overview across all account types (spot + bots + dual investment + trader account), USDT/BTC grand total, or wants to know how much they have in bots vs spot. Read-only; requires API credentials. For spot coin list only, use pionex-portfolio instead.4license: MIT5---67# Pionex Wallet Skill89Query the full Pionex portfolio overview: total USDT/BTC value across all account types. Requires API credentials (`pionex-ai-kit onboard`).1011## When to use1213- 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).14- User wants a consolidated view — not just spot coins, not just one bot.1516## Command1718| Command | Type | Description |19|---------|------|-------------|20| `pionex-trade-cli wallet balance_full` | READ | Full portfolio overview: USDT/BTC grand total + per-account-type breakdown. |21| `pionex-trade-cli wallet balance_full --app-lang en` | READ | Same, force English display names in `title` fields. |2223No write operations — `--dry-run` is not applicable.2425## Prerequisites2627```bash28npm install -g @pionex/pionex-ai-kit29pionex-ai-kit onboard30```3132## Output Structure3334```json35{36 "result": true,37 "data": {38 "totalInUsdt": "<grand total in USDT>",39 "totalInBtc": "<grand total in BTC>",40 "botAccount": {41 "totalInUsdt": "<all bot types combined>",42 "detail": [43 { "type": "futures_lite", "title": "Futures Lite", "totalInUsdt": "...", "count": 1 },44 { "type": "spot", "title": "Spot Balances", "totalInUsdt": "..." },45 { "type": "dual_manual", "title": "Dual investment", "totalInUsdt": "..." },46 { "type": "pionex_card", "title": "Pionex Card", "totalInUsdt": "..." }47 ]48 },49 "traderAccount": { "title": "Trader Account", "totalInUsdt": "..." },50 "extractBalances": {51 "propTrading": { "totalInUsdt": "..." },52 "trialFundCoupon": { "totalInUsdt": "..." }53 },54 "prices": { "btc": "...", "eth": "...", "usdt": "1", ... }55 }56}57```5859### How to summarize the output60611. Report `data.totalInUsdt` and `data.totalInBtc` as the grand total.622. For a breakdown, iterate `data.botAccount.detail` — report each `title` + `totalInUsdt`.633. Include `data.traderAccount.totalInUsdt` if non-zero.644. Skip `data.prices` and `data.extractBalances` unless the user explicitly asks.655. Round to 2 decimal places for display.6667## Skill routing6869| Scope | Skill |70|-------|-------|71| Total portfolio / full overview | **pionex-wallet** (this skill) |72| Spot coin list (per-coin balances) | **pionex-portfolio** |73| Market prices only | **pionex-market** |74| Place / cancel spot orders | **pionex-trade** |75| Futures/Spot Grid Bot lifecycle | **pionex-bot** |7677## Example7879- User: "What's my total Pionex account value?"80- Agent: run `pionex-trade-cli wallet balance_full`, then report:81 > Total: **$3,958.80** (≈ 0.0494 BTC)82 > - Futures Lite bots: $3,928.2483 > - Spot Balances: $0.4984 > - Dual Investment: $30.0685 > - Pionex Card: $0.00