pionex-wallet
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.
How do I install this agent skill?
npx skills add https://github.com/pionex-official/pionex-skills --skill pionex-walletIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill allows the agent to retrieve Pionex portfolio balances using the official Pionex AI Kit CLI tool. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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.totalInUsdtanddata.totalInBtcas the grand total. - For a breakdown, iterate
data.botAccount.detail— report eachtitle+totalInUsdt. - Include
data.traderAccount.totalInUsdtif non-zero. - Skip
data.pricesanddata.extractBalancesunless 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/pionex-official/pionex-skills/pionex-wallet">View pionex-wallet on skillZs</a>