Smithery is now a part of Arcade.dev! Read more in our announcement here
Gate multi-account asset and balance query skill. Use when the user asks to check total assets, account balance, or specific coin holdings across all accounts...
gate-cli (binary path)Resolve gate-cli in order: (1) command -v gate-cli and gate-cli --version succeeds; (2) ${HOME}/.local/bin/gate-cli if executable; (3) ${HOME}/.openclaw/skills/bin/gate-cli if executable. Canonical rules: exchange-runtime-rules.md Β§4 (or gate-runtime-rules.md Β§4).
β οΈ STOP β You MUST read and strictly follow the shared runtime rules before proceeding.
Do NOT select or call any tool until all rules are read. These rules have the highest priority.
β Read ./references/gate-runtime-rules.md
gate-cli commands explicitly listed in this skill. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.Query Operations (Read-only)
gate-cli cex delivery account getgate-cli cex earn dual balancegate-cli cex earn dual ordersgate-cli cex futures account getgate-cli cex margin account listgate-cli cex options account getgate-cli cex spot account getgate-cli cex spot account bookgate-cli cex tradfi account assetsgate-cli cex unified account getgate-cli cex wallet balance totalGATE_API_KEY and GATE_API_SECRET are not both set on the host, run gate-cli config init to complete the wizard for API key, secret, profiles, and defaults (see gate-cli).gate-cli config init is not required when credentials are already supplied β e.g. both GATE_API_KEY and GATE_API_SECRET set on the host, or --api-key / --api-secret where supported β never ask the user to paste secrets into chat.gate-cli (run sh ./setup.sh from this skill directory if missing; optional GATE_CLI_SETUP_MODE=release).$HOME/.openclaw/skills/bin to PATH if you invoke gate-cli by name (or the directory where setup.sh installs it).GATE_API_KEY and GATE_API_SECRET are both set (non-empty) for the host, do not require gate-cli config init β that is equivalent valid config for gate-cli. When both are unset or empty, remind the operator to run gate-cli config init or to configure GATE_API_KEY / GATE_API_SECRET in the matching skill from the skill library (never ask the user to paste secrets into chat).gate-cli --version or a read-only gate-cli cex ... command from this skill); confirm credentials resolve before mutating operations.Read and strictly follow references/gate-cli.md, then execute this skill's assets-query workflow.
SKILL.md keeps intent routing and rendering rules.references/gate-cli.md is the authoritative gate-cli execution contract for multi-account data collection, normalization, and degraded output handling.gate-cli)| MCP Tool | Purpose | Key Fields |
|---|---|---|
gate-cli cex wallet balance total |
Total balance (all sub-accounts, ~1min cache) | total.amount, details (spot/futures/delivery/finance/quant/meme_box/options/payment/margin/cross_margin) |
gate-cli cex spot account get |
Spot balance (filter by currency) | currency, available, locked |
gate-cli cex unified account get |
Unified account (single/cross/portfolio margin) | balances, unified_account_total, margin_mode |
gate-cli cex futures account get |
Perpetual (settle=usdt or btc) | total, unrealised_pnl, available, point, bonus |
gate-cli cex delivery account get |
Delivery (settle=usdt) | total, unrealised_pnl, available |
gate-cli cex options account get |
Options | total_value, unrealised_pnl, available |
gate-cli cex margin account list |
Isolated margin | currency_pair, mmr, base/quote (available/locked/borrowed/interest) |
gate-cli cex tradfi account assets |
TradFi assets | USDx balance, margin |
gate-cli cex earn dual balance, gate-cli cex earn dual orders, cex_earn_list_structured_orders (no gate-cli mapping in gate-cli/cmd/cex; see MCP_LEGACY_TOOL_RESOLUTION.md Β§δΊ) |
Finance | Flexible savings / Dual currency / Structured |
gate-cli cex spot account book |
Spot account book / ledger | ledger entries |
| API key | Display |
|---|---|
| spot | Spot account / Trading account |
| futures | Futures account (USDT perpetual) |
| delivery | Delivery contract account |
| options | Options account |
| finance | Finance account |
| quant | Quant/bot account |
| meme_box | Alpha account |
| margin | Isolated margin account |
| cross_margin | Cross margin account |
| payment | Payment account (not in total) |
<$0.01; finance yesterday PnL up to 8 decimals.| Case | Trigger Phrases | MCP Tool | Output |
|---|---|---|---|
| 1 | "How much do I have", "Show my CEX total assets", "Account asset distribution", "Account overview", "Check my balance" | gate-cli cex wallet balance total currency=USDT |
Total amount, account distribution, coin distribution; TradFi/payment listed separately if any |
| Case | Trigger Phrases | MCP Tool | Output |
|---|---|---|---|
| 2 | "How many BTC do I have", "How many USDT do I have" | Concurrent: gate-cli cex spot account get, gate-cli cex unified account get, gate-cli cex futures account get, gate-cli cex delivery account get, gate-cli cex margin account list, gate-cli cex earn dual balance, etc. |
Total {COIN} held, distribution by account |
| Case | Trigger Phrases | MCP Tool | Output |
|---|---|---|---|
| 3 | "How much USDT in my spot account", "How much BTC in my spot account" | gate-cli cex spot account get currency={COIN} or gate-cli cex unified account get currency={COIN} |
Account name, total, available, locked |
| Case | Account | Trigger Phrases | MCP Tool |
|---|---|---|---|
| 4 | Spot | "What's in my spot account", "Show my spot account assets" | gate-cli cex spot account get or gate-cli cex unified account get |
| 5 | Futures | "How much in futures account", "USDT perpetual", "BTC perpetual", "Delivery" | gate-cli cex futures account get settle=usdt/btc, gate-cli cex delivery account get |
| 6 | Trading (Unified) | "How much in trading account", "How much in unified account" | gate-cli cex unified account get |
| 7 | Options | "How much in options account", "Show my options assets" | gate-cli cex options account get or gate-cli cex unified account get |
| 8 | Finance | "How much in finance account", "Show my finance account assets" | gate-cli cex earn dual balance, gate-cli cex earn dual orders, cex_earn_list_structured_orders (no gate-cli mapping in gate-cli/cmd/cex; see MCP_LEGACY_TOOL_RESOLUTION.md Β§δΊ) |
| 9 | Alpha | "How much in Alpha account", "Show my Alpha assets" | gate-cli cex wallet balance total details.meme_box |
| 12 | Isolated Margin | "How much in isolated margin account", "Show my isolated margin assets" | gate-cli cex margin account list |
| 15 | TradFi | "How much in TradFi account", "Show my TradFi assets" | gate-cli cex tradfi account assets |
| Case | Intent | MCP Tool |
|---|---|---|
| 5 | Account book for coin | gate-cli cex spot account book |
| 6 | Ledger + current balance | gate-cli cex spot account book β gate-cli cex spot account get |
| 7 | Recent activity | gate-cli cex spot account book |
| Scenario | Handling |
|---|---|
| Total < 10 USDT | Show small-asset tip; recommend [Deposit] or [Dust conversion] |
| Unified account migration | "Your account is upgrading to unified account, asset data may be incomplete, please retry in ~5 minutes" |
| Dust (>10 dust coins) | "~${total_val} dust across {N} currencies" β [Dust conversion] |
| API timeout/error | "Data fetch error, please retry later" β [Refresh] |
| Account/coin balance = 0 | Do NOT show "your xx account is 0"; skip that item |
| USDT + TradFi | Show TradFi (USDx) separately; "TradFi in USDx, 1:1 with USDT, not in CEX total" |
| GTETH / voucher tokens | Explain: On-chain earn voucher, cannot withdraw to chain |
| ST token | Risk warning, suggest checking official announcements |
| Delisted token | Explain delisting, suggest withdrawal |
| Unified account, user asks "spot" | Inform spot merged into trading account; show trading account balance |
Case 1 β Total Balance:
Your total CEX asset valuation β ${total.amount} USDT
π Updated: {time} (UTC+8)
π° Account distribution: details keys (spot/futures/delivery etc.) amount, show only amount > 0
Case 2 β Specific Currency:
You hold {total_qty} {COIN} (β ${total_val} USDT)
π Updated: {time} (UTC+8)
π° Asset distribution: {account}: {qty} {COIN}, β ${val} ({pct}%)
Case 15 β TradFi:
Your TradFi account details:
Net value: {net_value} USDx | Balance: {balance} USDx | Unrealised PnL: {unrealised_pnl} USDx
Margin: {margin} USDx | Available margin: {available_margin} USDx | Margin ratio: {ratio}% (max 999+%)
β TradFi account in USDx, 1:1 with USDT, not in CEX total valuation.
| Scenario | Query |
|---|---|
| Total balance β normal | How much do I have? |
| Total balance β overview | Show my CEX total assets |
| Total balance β small (<10U) | My account asset distribution |
| Specific currency β normal | How many BTC do I have? |
| Specific currency β zero | How much DOGE do I have? |
| Specific account+currency | How much USDT in my spot account? |
| Spot account | What's in my spot account? |
| Futures β with assets | How much in futures account |
| Futures β USDT+BTC perpetual | Show my perpetual contract assets |
| Futures β no assets | Show my USDT perpetual assets |
| Trading account | How much in trading account |
| Options | Show my options assets |
| Alpha | How much in Alpha account |
| Isolated margin | Show my isolated margin assets |
| TradFi | How much in TradFi account |
gate-cli cex spot account get currency=USDT β Route to gate-exchange-spot if sufficient.For detailed scenario templates and edge cases, see references/scenarios.md.
