modelscope.cn

gate-exchange-assets

Gate Exchange asset and balance query skill.

Installation

$ npx skills add https://modelscope.cn

Summary

  • Gate Exchange asset and balance query skill.
  • Use when user asks to check total assets, account balance, specific currency holdings, or sub-account assets (spot, futures, margin, options, finance, Alpha, TradFi).
  • Trigger phrases: 'how much do I have', 'total assets', 'account balance', 'how many BTC', 'spot balance', 'futures account', 'margin account', 'options account', 'finance account', 'Alpha account', 'TradFi account'.
  • Read-only, no trading.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from modelscope.cn · top by installs.

npx skills add https://modelscope.cn

Browse all from modelscope.cn

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Version2026.3.12-3

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 9,338 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Gate Exchange Assets Assistant

Execute read-only asset and balance queries for Gate Exchange. Target users: external developers integrating Gate MCP, and end users (traders) who want quick asset overview, sub-account or currency-specific balance.

Domain Knowledge

MCP Tool Mapping (Gate gate-mcp)

MCP Tool Purpose Key Fields
cexwalletgettotalbalance Total balance (all sub-accounts, ~1min cache) total.amount, details (spot/futures/delivery/finance/quant/memebox/options/payment/margin/crossmargin)
cexspotgetspotaccounts Spot balance (filter by currency) currency, available, locked
cexunifiedgetunifiedaccounts Unified account (single/cross/portfolio margin) balances, unifiedaccounttotal, margin_mode
cexfxgetfxaccounts Perpetual (settle=usdt or btc) total, unrealised_pnl, available, point, bonus
cexdeliverylistdeliveryaccounts Delivery (settle=usdt) total, unrealised_pnl, available
cexoptionslistoptionsaccount Options totalvalue, unrealisedpnl, available
cexmarginlistmarginaccounts Isolated margin currency_pair, mmr, base/quote (available/locked/borrowed/interest)
cextradfiqueryuserassets TradFi assets USDx balance, margin
cexearnlistdualbalance, cexearnlistdualorders, cexearnliststructuredorders Finance Flexible savings / Dual currency / Structured
cexspotlistspotaccount_book Spot account book / ledger ledger entries

Account Name Mapping (details key → Display)

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)

Key Rules

  • Read-only. No trading, transfer, or order placement.
  • TradFi / payment: USDx and payment assets are NOT included in CEX total; display separately.
  • Unified account: When marginmode is classic/crossmargin/portfolio, spot may be merged into "trading account". Do NOT use internal terms like "advanced mode", "S1/S2".
  • Pair format: Futures use no-slash (BTCUSDT); spot/margin use slash (BTC/USDT).
  • Precision: Fiat valuation 2 decimals; dust (<$0.01) show as <$0.01; finance yesterday PnL up to 8 decimals.

Case Routing Map

I. Total & Overview (Case 1)

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" cexwalletgettotalbalance currency=USDT Total amount, account distribution, coin distribution; TradFi/payment listed separately if any

II. Specific Currency (Case 2)

Case Trigger Phrases MCP Tool Output
2 "How many BTC do I have", "How many USDT do I have" Concurrent: cexspotgetspotaccounts, cexunifiedgetunifiedaccounts, cexfxgetfxaccounts, cexdeliverylistdeliveryaccounts, cexmarginlistmarginaccounts, cexearnlistdualbalance, etc. Total {COIN} held, distribution by account

III. Specific Account + Currency (Case 3)

Case Trigger Phrases MCP Tool Output
3 "How much USDT in my spot account", "How much BTC in my spot account" cexspotgetspotaccounts currency={COIN} or cexunifiedgetunifiedaccounts currency={COIN} Account name, total, available, locked

IV. Sub-Account Queries (Case 4–15)

Case Account Trigger Phrases MCP Tool
4 Spot "What's in my spot account", "Show my spot account assets" cexspotgetspotaccounts or cexunifiedgetunifiedaccounts
5 Futures "How much in futures account", "USDT perpetual", "BTC perpetual", "Delivery" cexfxgetfxaccounts settle=usdt/btc, cexdeliverylistdeliveryaccounts
6 Trading (Unified) "How much in trading account", "How much in unified account" cexunifiedgetunifiedaccounts
7 Options "How much in options account", "Show my options assets" cexoptionslistoptionsaccount or cexunifiedgetunifiedaccounts
8 Finance "How much in finance account", "Show my finance account assets" cexearnlistdualbalance, cexearnlistdualorders, cexearnliststructuredorders
9 Alpha "How much in Alpha account", "Show my Alpha assets" cexwalletgettotalbalance details.meme_box
12 Isolated Margin "How much in isolated margin account", "Show my isolated margin assets" cexmarginlistmarginaccounts
15 TradFi "How much in TradFi account", "Show my TradFi assets" cextradfiqueryuserassets

V. Account Book (Legacy 5–7)

Case Intent MCP Tool
5 Account book for coin cexspotlistspotaccount_book
6 Ledger + current balance cexspotlistspotaccountbookcexspotgetspot_accounts
7 Recent activity cexspotlistspotaccount_book

Special Scenario Handling

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

Output Templates

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.

Acceptance Test Queries (Validation)

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

Cross-Skill Workflows

  • Before trading: User asks "Can I buy 100U BTC?" → This skill: cexspotgetspotaccounts currency=USDT → Route to gate-exchange-spot if sufficient.
  • After transfer: Route to this skill for updated balance when user asks.
  • Transfer card: When futures/options = 0, recommend [Transfer] and trigger transfer skill.

Safety Rules

  • Read-only only. Never call createorder, cancelorder, create_transfer, or any write operation.
  • If user intent includes trading, transfer, or order placement → route to appropriate skill.
  • Always clarify currency and scope (spot vs all wallets) when ambiguous.

For detailed scenario templates and edge cases, see [references/scenarios.md](references/scenarios.md).