gate-exchange-crossex

What this skill does

# 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](https://github.com/gate/gate-skills/blob/master/skills/gate-runtime-rules.md)
- **Only call MCP tools explicitly listed in this skill.** Tools not documented here must NOT be called, even if they
  exist in the MCP server.


---

## MCP Dependencies

### Required MCP Servers
| MCP Server | Status |
|------------|--------|
| Gate (main) | ✅ Required |

### MCP Tools Used

**Query Operations (Read-only)**

- cex_crx_get_crx_account
- cex_crx_get_crx_fee
- cex_crx_get_crx_interest_rate
- cex_crx_get_crx_margin_positions_leverage
- cex_crx_get_crx_order
- cex_crx_get_crx_positions_leverage
- cex_crx_list_crx_account_book
- cex_crx_list_crx_adl_rank
- cex_crx_list_crx_coin_discount_rate
- cex_crx_list_crx_history_margin_interests
- cex_crx_list_crx_history_margin_positions
- cex_crx_list_crx_history_orders
- cex_crx_list_crx_history_positions
- cex_crx_list_crx_history_trades
- cex_crx_list_crx_margin_positions
- cex_crx_list_crx_open_orders
- cex_crx_list_crx_positions
- cex_crx_list_crx_rule_risk_limits
- cex_crx_list_crx_rule_symbols
- cex_crx_list_crx_transfer_coins
- cex_crx_list_crx_transfers

**Execution Operations (Write)**

- cex_crx_cancel_crx_order
- cex_crx_close_crx_position
- cex_crx_create_crx_convert_order
- cex_crx_create_crx_convert_quote
- cex_crx_create_crx_order
- cex_crx_create_crx_transfer
- cex_crx_update_crx_account
- cex_crx_update_crx_margin_positions_leverage
- cex_crx_update_crx_order
- cex_crx_update_crx_positions_leverage

### Authentication
- API Key Required: Yes (see skill doc/runtime MCP deployment)
- Permissions: Crx:Write
- Get API Key: https://www.gate.io/myaccount/profile/api-key/manage

### Installation Check
- Required: Gate (main)
- Install: Run installer skill for your IDE
  - Cursor: `gate-mcp-cursor-installer`
  - Codex: `gate-mcp-codex-installer`
  - Claude: `gate-mcp-claude-installer`
  - OpenClaw: `gate-mcp-openclaw-installer`

## Module Overview

| Module        | Description                                                             | Trigger Keywords                                                              |
|---------------|-------------------------------------------------------------------------|-------------------------------------------------------------------------------|
| **Spot**      | Limit/market buy/sell, cross-exchange arbitrage                         | `spot buy`, `spot sell`, `buy spot`, `sell spot`                              |
| **Margin**    | Long/short trading, margin management, auto-borrowing                   | `margin long`, `margin short`, `long margin`, `short margin`                  |
| **Futures**   | USDT perpetual contracts, dual-direction positions, leverage adjustment | `futures long`, `futures short`, `open long`, `open short`                    |
| **Transfer**  | Cross-exchange fund transfer                                            | `fund transfer`, `cross-exchange transfer`, `transfer`, `move funds`          |
| **Convert**   | Flash convert and conversion quote workflow                             | `convert trading`, `flash convert`, `convert`, `quote convert`                |
| **Orders**    | Query, cancel, amend orders, order history                              | `query orders`, `cancel order`, `amend order`, `order history`, `list orders` |
| **Positions** | Query all position types, history records                               | `query positions`, `check positions`, `position history`, `positions`         |
| **History**   | Query order/position/trade/interest history                             | `history query`, `trade history`, `interest history`, `history`               |

## Routing Rules

| Intent                      | Example Phrases                                                                              | Route To                                    |
|-----------------------------|----------------------------------------------------------------------------------------------|---------------------------------------------|
| **Spot Trading**            | "Buy 100 USDT worth of BTC", "Sell 0.5 BTC", "Market buy ETH spot"                           | Read `references/spot-trading.md`           |
| **Margin Trading**          | "Long 50 USDT worth of XRP on margin", "Short BTC on margin", "10x leverage long"            | Read `references/margin-trading.md`         |
| **Futures Trading**         | "Open 1 BTC futures long position", "Market short ETH", "Adjust leverage to 20x"             | Read `references/futures-trading.md`        |
| **Cross-Exchange Transfer** | "Transfer 100 USDT from Gate to Binance", "Move ETH from OKX to Gate"                        | Read `references/transfer.md`               |
| **Convert Trading**         | "Flash convert 10 USDT to BTC", "Convert 50 USDT to ETH on Gate"                             | Read `references/convert-trading.md`        |
| **Order Management**        | "Query all open orders", "Cancel that buy order", "Amend order price", "Query order history" | Read `references/order-management.md`       |
| **Position Query**          | "Query all my positions", "Show futures positions", "Position history"                       | Read `references/position-query.md`         |
| **History Query**           | "Query trade history", "Position history", "Margin interest history", "Account ledger"       | Read `references/history-query.md`          |
| **Unclear**                 | "Show account" , "Help me" , "Please Check my account"                                       | **Clarify**: Query account, then guide user |

## MCP Tools

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

| Tool                                  | Purpose                                    |
|---------------------------------------|--------------------------------------------|
| `cex_crx_list_crx_rule_symbols`       | List supported CrossEx trading symbols     |
| `cex_crx_list_crx_rule_risk_limits`   | Query symbol risk limit rules              |
| `cex_crx_list_crx_transfer_coins`     | List assets supported for CrossEx transfer |
| `cex_crx_get_crx_fee`                 | Query CrossEx trading fee information      |
| `cex_crx_get_crx_interest_rate`       | Query CrossEx interest rates               |
| `cex_crx_list_crx_coin_discount_rate` | Query collateral discount rates            |

### Account Tools

| Tool                            | Purpose                                     |
|---------------------------------|---------------------------------------------|
| `cex_crx_get_crx_account`       | Query CrossEx account overview and balances |
| `cex_crx_update_crx_account`    | Update CrossEx account settings             |