| name | gate-exchange-assetswap |
| description | Use this skill whenever the user wants Gate Exchange asset allocation optimization for spot holdings (list eligible assets, load config, evaluate/preview, place orders, query history). Trigger phrases include "asset allocation optimization", "allocation configuration", "portfolio allocation", "rebalance spot to stablecoin", "Top 5 market cap allocation", "optimize holdings to BTC", "preview allocation optimization", "allocation optimization order list". |
| user-invocable | true |
| disable-model-invocation | false |
| metadata | {"openclaw":{"emoji":"💱","os":["darwin","linux"],"primaryEnv":"GATE_API_KEY","requires":{"bins":"[Truncated]","env":"[Truncated]"},"install":["[Truncated]","[Truncated]","[Truncated]","[Truncated]"]}} |
Resolving 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).
Gate Exchange Asset Allocation Optimization
General Rules
⚠️ 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 gate-runtime-rules.md
- Only use the
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.
Skill Dependencies
gate-cli commands used
Query operations (read-only, profile scope)
gate-cli cex assetswap assetsgate-cli cex assetswap configgate-cli cex assetswap evaluategate-cli cex assetswap order listgate-cli cex assetswap order get
Execution operations (write, trade scope)
gate-cli cex assetswap order previewgate-cli cex assetswap order create
Authentication
- Interactive file setup: when
GATE_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).
- Env / flags:
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.
- API Key required: Yes
- Permissions: Profile (read) for listing, config, evaluation, and order queries; Trade for preview and order creation
- Portal: create or rotate keys outside the chat: https://www.gate.com/myaccount/profile/api-key/manage
Installation Check
- Required: Gate (main) MCP with asset allocation optimization tools enabled (MCP names
cex_assetswap_*); prefer gate-cli cex assetswap … when running from the host CLI.
- Install (MCP / IDE):
gate-mcp-cursor-installer, gate-mcp-codex-installer, gate-mcp-claude-installer, or gate-mcp-openclaw-installer.
- Credentials: When
GATE_API_KEY and GATE_API_SECRET are both set (non-empty) for the host, do not require gate-cli config init. 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).
- Sanity check: Before preview or order creation, confirm the runtime works (e.g.
gate-cli --version or deployment-specific checks).
Trigger Conditions
Activate this skill when the user wants any of the following:
- Multi-asset spot portfolio optimization or rebalancing into a strategy (conservative stablecoin, conviction single asset, or market-cap-weighted basket)
- To see which spot balances are eligible for asset allocation optimization
- Preview estimated execution, slippage, or risk hints before committing
- Submit an asset allocation optimization order after confirmation
- Query historical allocation optimization orders or one order’s status and child orders
Do not use this skill for: transfers between accounts or products, Launchpool or earn subscriptions, single manual spot limit/market orders without the allocation product, or dust handling below product thresholds (route to the appropriate transfer, earn, spot, or small-balance product skill instead).
Data privacy and collection
- AI interaction information: User prompts, follow-up instructions, and tool arguments used while following this skill qualify as AI interaction data under the Gate Privacy Policy (see §4.2.7). Do not ask for or repeat API keys, secrets, or unrelated personal data in user-visible output.
- Data flow: Account and trading data for this skill flow only through the configured Gate (main) MCP to Gate Exchange APIs via the asset-swap tools above (MCP
cex_assetswap_* or equivalent gate-cli cex assetswap … calls). Do not relay the same data to undocumented third-party services, scrapers, or custom backends as part of this workflow.
- Minimization: Pass only parameters required by each documented MCP call (symbols, amounts, strategy fields, pagination). Do not send full chat transcripts or unrelated context fields into tool payloads.
Domain Knowledge
Product: Asset Allocation Optimization exposes Exchange capability for restructuring multiple spot holdings into a target mix. One optimization may map to multiple internal execution legs at the order layer.
Strategy types (conceptual; exact enums and parameters come from gate-cli cex assetswap config):
| Strategy | Typical targets | Meaning |
|---|
| Conservative | USDT, GUSD, USDC (examples) | Consolidate into a single stablecoin; risk-off / idle cash posture |
| Conviction ("faith") | BTC, ETH, GT (examples) | Reallocate selected spot toward target weights in the chosen asset(s); intermediate steps follow the product and API |
| Market cap | Top 2, Top 5 (examples) | Index-like exposure weighted by market cap into a basket such as BTC, ETH, SOL, BNB, XRP (actual list from API) |
Listing rules (for agent interpretation; product may filter server-side):
- Default presentation may exclude major reserve assets (e.g. BTC, ETH, USDT, USDC) unless the user explicitly asks to include them in the sell set.
- Only spot available balances participate; locked balances from earn, borrow, staking, or similar are out of scope.
- Very small balances (e.g. below roughly USD 10 equivalent) may be hidden or routed to small-balance handling; exact thresholds follow API or product rules.
Out of scope for public skill documentation (do not document as standard Exchange MCP capabilities):
- Banner or UI-only feature flags
- Non-standard semantic "validate and fill parameters" helpers not published as Exchange MCP
Rate limiting: Align with wallet or Exchange API limits when documented (example: 200 requests per 10 seconds per user or key); confirm in published API docs.
Preview → create payload (mandatory for agents):
- After a successful
gate-cli cex assetswap order preview, construct the gate-cli cex assetswap order create body from the preview response data.order only: for each object in data.order.from and data.order.to, emit { "asset": <value>, "amount": <value> } using the preview’s asset and amount string fields (use amount, not amount_show, unless published API docs say otherwise).
- Preserve the array order of
to (and from if multiple legs) exactly as returned in data.order; do not reorder symbols for convenience.
- A preview request may use
ratio on to; the create call must still use the resolved asset + amount legs from the preview output. Creating with ratio-only to while omitting preview amounts often yields quote errors (for example code: 4).
- If the API returns additional preview-bound fields (for example top-level
usdt_evaluated_value or transaction_fee inside data), mirror them on create when the MCP or Exchange docs require it; otherwise the from / to legs from preview are the primary contract.
Main chain (mandatory order for placement):
- Case 1 — list eligible assets
- Case 2 — get strategy and parameter configuration
- Case 3 — pre-trade evaluation and preview (3a optional, 3b strongly required or mandatory per product rules)
- Case 4 — create order after explicit user confirmation of preview
Do not jump from Case 2 to Case 4 without Case 3b preview unless product rules explicitly allow it.
Supplemental queries (do not reorder the main chain):
- Case 5 — paginated order list
- Case 6 — single order detail
Order states (examples): configuring, completed, partially completed, failed — use API field names and values from responses.
Tool scope summary:
| Tool | Type | Scope |
|---|
gate-cli cex assetswap assets | Read | profile |
gate-cli cex assetswap config | Read | profile |
gate-cli cex assetswap evaluate | Read | profile |
gate-cli cex assetswap order list | Read | profile |
gate-cli cex assetswap order get | Read | profile |
gate-cli cex assetswap order preview | Write | trade |
gate-cli cex assetswap order create | Write | trade |
Compliance: Restricted regions, KYC, and disabled accounts are enforced by the API. On compliance errors, relay the message and stop; do not promise outcomes the platform does not guarantee.
Agent must not: guarantee PnL, VIP tier level changes, or bypass eligibility rules.
Workflow
Step 1: Resolve user goal and route requests outside asset allocation optimization
Classify the request as: (A) discovery only, (B) full optimization through preview and optional order, (C) history or single-order status.
From the user message and session context only, infer intent and routing. Do not call any cex_* MCP tool in this step. If the user wants a single conventional spot order, transfer, grid bot, or earn action, stop using this skill and route to the appropriate Gate Exchange skill.
Key data to extract:
goal: list_only | evaluate_only | preview | place_order | order_list | order_detailstrategy_hint: conservative | conviction | market_cap | unknown (confirm via config)symbols_or_scope: which assets the user wants to include or exclude
Step 2: Case 1 — List assets eligible for optimization
Call gate-cli cex assetswap assets with: parameters per MCP and API documentation (no undocumented fields).
Key data to extract:
eligible_assets: symbols, available amounts, valuation hints returned by the API- Whether the user must narrow the set for the next steps
Step 3: Case 2 — Load configuration
Call gate-cli cex assetswap config with: no required body unless the API specifies optional filters; obtain allowed strategies, targets, limits, and precision rules.
Key data to extract:
allowed_strategies and parameter shapes for TopN, target asset, and limits- Constraints the agent must enforce when building the next request payload
Step 4: Case 3a — Evaluation (optional)
When the user needs a quick estimate before final parameters, or while iterating on strategy choice:
Call gate-cli cex assetswap evaluate with: payload required by the API for the selected assets and strategy.
Key data to extract:
evaluation_summary: estimated notionals or other returned metrics- Any warnings or validation errors
Step 5: Case 3b — Preview order (required before create in normal flow)
After the user confirms the asset set and strategy parameters:
Call gate-cli cex assetswap order preview with: candidate selection and strategy fields per API docs.
Present preview outputs clearly: estimated fills, slippage or risk hints, and any server-side notices. Obtain explicit user confirmation after preview before Step 6.
If the market moves or the preview expires, repeat Step 5 (and Step 4 if needed) before creating an order.
Key data to extract:
preview_reference_fields: any quote, token, or expiry fields required for Step 6 (follow response schema exactly)create_from_legs: copy of data.order.from reduced to { asset, amount } per element (from preview amount, not amount_show)create_to_legs: copy of data.order.to reduced to { asset, amount } per element, same order as previewuser_confirmed: boolean — must be true to proceed
Step 6: Case 4 — Create optimization order
Only after successful preview and explicit confirmation:
Call gate-cli cex assetswap order create with: JSON body whose from is create_from_legs and to is create_to_legs from Step 5 (each leg asset + amount from data.order). Add any other preview-bound fields required by the API (for example values under data such as usdt_evaluated_value or transaction_fee) only when documentation or repeated failures indicate they are required. Do not substitute ratio-only to for this step when the preview already returned concrete amount per target asset.
Key data to extract:
order_id or equivalent identifier- Initial status and timestamps
- Next-step guidance (poll detail or show history)
Step 7: Case 5 — List orders (supplemental)
When the user asks for recent history:
Call gate-cli cex assetswap order list with: pagination parameters per API (for example recent months as defined by product).
Key data to extract:
orders[]: identifiers, statuses, created times- Pagination cursors or flags if present
Step 8: Case 6 — Order detail (supplemental)
When the user supplies an order id or picks one from a list:
Call gate-cli cex assetswap order get with: order_id string per MCP and API documentation.
Key data to extract:
- Aggregate status and per-child order states if returned
- Amounts consumed and received as returned by the API
Error Handling
| Situation | Action |
|---|
| Preview expired or price invalid | Re-run gate-cli cex assetswap order preview (and evaluation if needed); explain briefly |
| Create returns quote error after successful preview | Confirm create body uses asset + amount from data.order.from / data.order.to (preview order preserved); re-preview and retry; avoid ratio-only to if preview returned amounts |
| Insufficient available balance | Stop create; ask user to free balance or adjust selection |
| Rate limit | Back off and retry later; show the API message |
| Compliance or region block | Stop; relay compliance message; do not retry with workarounds |
| Partial completion | Report actual status from gate-cli cex assetswap order get; no guaranteed completion time |
Safety Rules
- Trading risk: Digital asset trading involves significant risk and may result in partial or total loss of your investment. See the Gate Risk Disclosure and User Agreement.
- Never call
gate-cli cex assetswap order create without a successful preview and clear user confirmation of preview contents, except where the user’s own explicit one-shot authorization is defined by runtime rules for this product (default: require confirmation).
- Never build the create payload with ratio-only target legs when the preview response already includes
data.order.to entries with amount; use those asset + amount pairs (and matching from legs) for create.
- Never fabricate order IDs, preview tokens, or success when the API returned an error.
- Display rates and amounts as estimates until execution; final settlement is authoritative.
- Do not expose API keys or secrets in user-visible output.
Judgment Logic Summary
| Condition | Action |
|---|
| User wants eligible spot assets for portfolio optimization | Case 1 only (gate-cli cex assetswap assets) |
| User needs strategy options or limits | Case 2 (gate-cli cex assetswap config) |
| User wants a quick estimate | Case 3a (gate-cli cex assetswap evaluate) |
| User is ready to see executable preview | Case 3b (gate-cli cex assetswap order preview) |
| User confirmed preview | Case 4 (gate-cli cex assetswap order create) |
| User asks for past optimizations | Case 5 (gate-cli cex assetswap order list) |
| User asks for one order’s progress | Case 6 (gate-cli cex assetswap order get) |
| User wants single spot order or grid bot | Route out of this skill |
| Preview failed or expired | Re-preview; do not create |
Report Template
## Asset allocation optimization
**Goal**: {list | evaluate | preview | order placed | history | detail}
**Eligible assets (summary)**: {N} items, {optional total valuation if API provides}
**Strategy**: {conservative | conviction | market_cap | from API}
**Preview** (if run):
- Key figures: {from API}
- Create legs (if placing order): {`from`/`to` as `asset`+`amount` from `data.order`}
- Risk or slippage notes: {from API}
**Order** (if created):
- Order ID: {id}
- Status: {status}
**History / detail** (if queried):
- {table or bullet list from API}
**Disclaimer**: Digital asset trading involves significant risk and may result in partial or total loss of your investment. Figures are from Gate Exchange APIs; final balances and fees follow account records. No PnL or VIP impact is guaranteed.
