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 CrossEx Trading Suite

This skill is the unified entry point for Gate CrossEx cross-exchange trading. It supports lots of core operations: order management, position query, and history query. User intents are routed to corresponding workflows.

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)

• gate-cli cex cross-ex account get
• gate-cli cex cross-ex market fee
• gate-cli cex cross-ex market interest-rate
• gate-cli cex cross-ex position margin-leverage
• gate-cli cex cross-ex order get
• gate-cli cex cross-ex position leverage
• gate-cli cex cross-ex account book
• gate-cli cex cross-ex position adl-rank
• gate-cli cex cross-ex market discount-rate
• gate-cli cex cross-ex position margin-interests
• gate-cli cex cross-ex position margin-history
• gate-cli cex cross-ex order history
• gate-cli cex cross-ex position history
• gate-cli cex cross-ex order trades
• gate-cli cex cross-ex position margin-list
• gate-cli cex cross-ex order list
• gate-cli cex cross-ex position list
• gate-cli cex cross-ex market risk-limits
• gate-cli cex cross-ex market symbols
• gate-cli cex cross-ex market transfer-coins
• gate-cli cex cross-ex transfer list

Execution Operations (Write)

• gate-cli cex cross-ex order cancel
• gate-cli cex cross-ex position close
• gate-cli cex cross-ex convert create
• gate-cli cex cross-ex convert quote
• gate-cli cex cross-ex order create
• gate-cli cex cross-ex transfer create
• gate-cli cex cross-ex account update
• gate-cli cex cross-ex position set-margin-leverage
• gate-cli cex cross-ex order update
• gate-cli cex cross-ex position set-leverage

Authentication

• Interactive file setup: when GATEAPIKEY and GATEAPISECRET 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 GATEAPIKEY and GATEAPISECRET set on the host, or --api-key / --api-secret where supported — never ask the user to paste secrets into chat.
• Permissions: Crx:Write
• Portal: create or rotate keys outside the chat: https://www.gate.com/myaccount/profile/api-key/manage

Installation Check

• Required: gate-cli (run sh ./setup.sh from this skill directory if missing; optional GATECLISETUP_MODE=release).
• Add $HOME/.openclaw/skills/bin to PATH if you invoke gate-cli by name (or the directory where [setup.sh](./setup.sh) installs it).
• Credentials: When GATEAPIKEY and GATEAPISECRET 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 GATEAPIKEY / GATEAPISECRET in the matching skill from the skill library (never ask the user to paste secrets into chat).
• Sanity check: Do not proceed with authenticated calls until the CLI behaves as expected (e.g. gate-cli --version or a read-only gate-cli cex ... command from this skill); confirm credentials resolve before mutating operations.

Execution mode

Read and strictly follow [references/gate-cli.md](./references/gate-cli.md), then execute this skill's CrossEx workflow.

• SKILL.md keeps route dispatch and feature boundaries.
• references/gate-cli.md is the authoritative gate-cli execution contract for query/mutation sequencing, confirmation gates, and risk-aware updates.

Module Overview

Routing Rules

gate-cli command index

This skill uses the CrossEx MCP toolset with the cex_crx prefix as its only core tool family.

Scope rule: Only execute operations explicitly documented in this skill. Only call tools listed in the tables below or in references/*.md. Tools or operations not mentioned here must not be called.

Tool Naming Convention

• List operations in the cex_crx family query symbols, orders, positions, transfers, or history
• Get operations in the cex_crx family query a single account setting, fee, rate, or order detail
• Create operations in the cex_crx family create an order, transfer, convert quote, or convert order
• Update operations in the cex_crx family update account settings, leverage, or existing orders
• Cancel operations in the cex_crx family cancel an existing order
• Close operations in the cex_crx family close an existing position

Symbol And Rule Tools

Account Tools

Transfer And Convert Tools

Order Tools

Position And Leverage Tools

Usage Guidance

• Use the cex_crx MCP family as the default and only core MCP family for this skill.
• Use list/get tools to query symbol rules, fees, balances, leverage, or supported assets.
• Prefer history and account-book tools when the user asks for records, audit trails, or status verification.

Execution

1. Intent and Parameter Identification

• Determine module (orders/positions/history)
• Extract key parameters:

- Trading Pair: GATESPOTBTCUSDT, GATEMARGINXRPUSDT, GATEFUTUREETH_USDT - Exchange: GATE, BINANCE, OKX, BYBIT - Direction: BUY (buy/long), SELL (sell/short) - Quantity: USDT amount, coin quantity, contract size - Price: Limit, market - Leverage: Leverage multiplier (margin/futures only) - Position Side: LONG (long), SHORT (short, margin/futures only)

• Missing Parameters: If required parameters are missing, ask user

2. Pre-checks

• Trading Pair: Call gate-cli cex cross-ex market symbols to verify
• Account Balance: Call gate-cli cex cross-ex account get to check if available margin is sufficient
• Position Check:

- Margin Trading: Check existing positions to avoid direction conflicts - Futures Trading: Check dual-direction position mode

• Minimum Amount: Query minquoteamount (typically 3 USDT)
• Exchange Status: Verify target exchange is operating normally

3. Module Logic

Module A: Spot Trading

1. Parameter Confirmation:

- Trading pair format: GATESPOT{BASE}{QUOTE} - Buy parameters: quoteqty (USDT amount) - Sell parameters: qty (coin quantity)

1. Minimum Amount Check: Call gate-cli cex cross-ex market symbols to query minimum amount
2. Pre-order Confirmation: Display order summary (pair, direction, quantity, price), require user confirmation
3. Place Order: Call gate-cli cex cross-ex order create
4. Verification: Call gate-cli cex cross-ex order get to confirm order status

Module B: Margin Trading

1. Parameter Confirmation:

- Trading pair format: GATEMARGIN{BASE}{QUOTE} - Required parameters: qty (coin quantity), positionside (LONG or SHORT) - Optional parameters: quote_qty (USDT amount)

1. Leverage Check: Query current leverage, adjust if user specifies
2. Position Direction:

- Long (LONG): Buy coin, borrow USDT - Short (SHORT): Sell coin, borrow coin

1. Minimum Amount Check: Call gate-cli cex cross-ex market symbols to query minimum amount
2. Pre-order Confirmation: Display order summary (pair, direction, quantity, leverage), require confirmation
3. Place Order: Call gate-cli cex cross-ex order create with parameter position_side
4. Verification: Call gate-cli cex cross-ex position margin-list with a symbol filter to confirm position

Module C: Futures Trading

1. Parameter Confirmation:

- Trading pair format: GATEFUTURE{BASE}{QUOTE} - Required parameters: qty (contract size), positionside (LONG or SHORT)

1. Leverage Adjustment: If user specifies leverage, call gate-cli cex cross-ex position leverage and

gate-cli cex cross-ex position set-leverage

1. Contract Size Calculation (if ordering by value):

- Get quanto_multiplier and current price - Round down to ensure overspending is avoided

1. Minimum Size Check: Call gate-cli cex cross-ex market symbols to query minimum size
2. Pre-order Confirmation: Display order summary (pair, direction, size, leverage), require confirmation
3. Place Order: Call gate-cli cex cross-ex order create with parameter position_side
4. Verification: Call gate-cli cex cross-ex position list with a symbol filter to confirm position

Module D: Cross-Exchange Transfer

1. Transfer Type:

- Cross-exchange transfer: gate-cli cex cross-ex transfer create (Exchange A -> Exchange B)

1. Parameter Confirmation:

- Cross-exchange transfer: from, to, coin, amount - From/To Account Rules:

1. Supported Coin Check: Call gate-cli cex cross-ex market transfer-coins to verify
2. Balance Check: Confirm source account has sufficient balance
3. Pre-transfer Confirmation: Display transfer summary (source, destination, coin, quantity), require confirmation
4. Execute Transfer: Call gate-cli cex cross-ex transfer create
5. Verification: Call gate-cli cex cross-ex transfer list to query transfer history and confirm

Module E: Convert Trading

1. Convert Type:

- Flash convert quote: gate-cli cex cross-ex convert quote - Flash convert execution: gate-cli cex cross-ex convert create

1. Parameter Confirmation:

- Flash convert: fromcoin, tocoin, fromamount, exchangetype

1. Balance Check: Confirm source account has sufficient balance for the convert pair
2. Pre-convert Confirmation: Display source asset, target asset, rate, and expected receive amount, then require

confirmation

1. Quote: Call gate-cli cex cross-ex convert quote
2. Execute Convert: Call gate-cli cex cross-ex convert create with the returned quote_id
3. Verification: Call gate-cli cex cross-ex account get to confirm resulting balances

Module F: Order Management

1. Query Orders:

- Current open orders: Call gate-cli cex cross-ex order list - Order details: Call gate-cli cex cross-ex order get - Order History: Call gate-cli cex cross-ex order history (parameters: limit, page, from, to)

1. Cancel Orders:

- Single cancel: Call gate-cli cex cross-ex order cancel

1. Amend Orders:

- Check order status must be open - Call gate-cli cex cross-ex order update to amend price or quantity

1. Display Results: Display order information in table format

Module G: Position Query

1. Query Types:

- Futures positions: Call gate-cli cex cross-ex position list - Margin positions: Call gate-cli cex cross-ex position margin-list - Futures leverage: Call gate-cli cex cross-ex position leverage - Margin leverage: Call gate-cli cex cross-ex position margin-leverage

1. History Query:

- Position History: Call gate-cli cex cross-ex position history (parameters: limit, page, from, to) - Margin Position History: Call gate-cli cex cross-ex position margin-history - Trade History: Call gate-cli cex cross-ex order trades (parameters: limit, page, from, to)

1. Display Format:

- Current positions: Table format (pair, direction, quantity, entry price, unrealized PnL) - History records: Reverse chronological order, display recent N records

Module H: History Query

1. Order History:

- Call gate-cli cex cross-ex order history - Parameters: limit (max 100), page, from (start timestamp), to (end timestamp)

1. Trade History:

- Call gate-cli cex cross-ex order trades - Same parameters as above

1. Position History:

- Call gate-cli cex cross-ex position history - Same parameters as above

1. Margin Position History:

- Call gate-cli cex cross-ex position margin-history - Same parameters as above

1. Margin Interest History:

- Call gate-cli cex cross-ex position margin-interests - Same parameters as above

Report Template

After each operation, output a concise standardized result.

Safety Rules

• Credentials: Never prompt or induce the user to paste API Secret Key into chat; prefer secure local MCP configuration.
• User-to-User Transfer: This skill does not support P2P or user-to-user transfers; only transfers between the user's own accounts (e.g., SPOT ↔ CROSSEX) are allowed.
• Trade Orders: Display complete order summary (pair, direction, quantity, price, leverage), require user

confirmation before placing order

• Cross-Exchange Transfer: Display transfer details (source, destination, quantity, arrival time), require

confirmation

• Scope rule: Only call tools documented in this skill. If the user requests an operation not documented here,

respond that it is not supported by this skill.

• Batch Operations: Display operation scope and impact, require explicit confirmation

Example: "Reply 'confirm' to execute the above operation."

Error Handling