Gate Exchange Crossex

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 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.
• 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 GATE_CLI_SETUP_MODE=release).
• Add $HOME/.openclaw/skills/bin to PATH if you invoke gate-cli by name (or the directory where setup.sh installs it).
• Credentials: When 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).
• 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, 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: GATE_SPOT_BTC_USDT, GATE_MARGIN_XRP_USDT, GATE_FUTURE_ETH_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 min_quote_amount (typically 3 USDT)
• Exchange Status: Verify target exchange is operating normally

3. Module Logic

Module A: Spot Trading

1. Parameter Confirmation:

• Trading pair format: GATE_SPOT_{BASE}_{QUOTE}
• Buy parameters: quote_qty (USDT amount)
• Sell parameters: qty (coin quantity)

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

Module B: Margin Trading

1. Parameter Confirmation:

• Trading pair format: GATE_MARGIN_{BASE}_{QUOTE}
• Required parameters: qty (coin quantity), position_side (LONG or SHORT)
• Optional parameters: quote_qty (USDT amount)

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

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

4. Minimum Amount Check: Call gate-cli cex cross-ex market symbols to query minimum amount
5. Pre-order Confirmation: Display order summary (pair, direction, quantity, leverage), require confirmation
6. Place Order: Call gate-cli cex cross-ex order create with parameter position_side
7. 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: GATE_FUTURE_{BASE}_{QUOTE}
• Required parameters: qty (contract size), position_side (LONG or SHORT)

2. Leverage Adjustment: If user specifies leverage, call gate-cli cex cross-ex position leverage and gate-cli cex cross-ex position set-leverage
3. Contract Size Calculation (if ordering by value):

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

4. Minimum Size Check: Call gate-cli cex cross-ex market symbols to query minimum size
5. Pre-order Confirmation: Display order summary (pair, direction, size, leverage), require confirmation
6. Place Order: Call gate-cli cex cross-ex order create with parameter position_side
7. 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)

2. Parameter Confirmation:

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

  Coin	Mode	Valid from / to	Defaults
  USDT	Cross-Exchange	SPOT ↔ CROSSEX	CROSSEX_{exchange_type} → CROSSEX
  USDT	Sub-Exchange	SPOT ↔ CROSSEX_{exchange_type} or CROSSEX_{exchange_type} ↔ CROSSEX_{exchange_type}	CROSSEX → CROSSEX_GATE
  Non-USDT	Any	Must use CROSSEX_{exchange_type} (never CROSSEX alone). Cross-exchange transfers allowed (e.g., CROSSEX_BINANCE ↔ CROSSEX_GATE).	—

3. Supported Coin Check: Call gate-cli cex cross-ex market transfer-coins to verify
4. Balance Check: Confirm source account has sufficient balance
5. Pre-transfer Confirmation: Display transfer summary (source, destination, coin, quantity), require confirmation
6. Execute Transfer: Call gate-cli cex cross-ex transfer create
7. 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

2. Parameter Confirmation:

• Flash convert: from_coin, to_coin, from_amount, exchange_type

3. Balance Check: Confirm source account has sufficient balance for the convert pair
4. Pre-convert Confirmation: Display source asset, target asset, rate, and expected receive amount, then require confirmation
5. Quote: Call gate-cli cex cross-ex convert quote
6. Execute Convert: Call gate-cli cex cross-ex convert create with the returned quote_id
7. 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)

2. Cancel Orders:

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

3. Amend Orders:

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

4. 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

2. 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)

3. 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)

2. Trade History:

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

3. Position History:

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

4. Margin Position History:

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

5. 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