gate-exchange-tradfi

What this skill does

### 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`](https://github.com/gate/gate-skills/blob/master/skills/exchange-runtime-rules.md) §4 (or [`gate-runtime-rules.md`](https://github.com/gate/gate-skills/blob/master/skills/gate-runtime-rules.md) §4).


# Gate TradFi Suite

## 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 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 tradfi market categories`
- `gate-cli cex tradfi account info`
- `gate-cli cex tradfi order history`
- `gate-cli cex tradfi order list`
- `gate-cli cex tradfi position history`
- `gate-cli cex tradfi position list`
- `gate-cli cex tradfi market symbol`
- `gate-cli cex tradfi market kline`
- `gate-cli cex tradfi market ticker`
- `gate-cli cex tradfi market symbols`
- `gate-cli cex tradfi account assets`

**Execution Operations (Write)**

- `gate-cli cex tradfi position close`
- `gate-cli cex tradfi order create`
- `gate-cli cex tradfi order cancel`
- `gate-cli cex tradfi order update`
- `gate-cli cex tradfi position update`

### 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](https://github.com/gate/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:** Tradfi: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`](./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`](./references/gate-cli.md), then execute this skill's TradFi workflow.

- `SKILL.md` keeps routing and domain constraints.
- `references/gate-cli.md` is the authoritative `gate-cli` execution contract for query/mutation separation, confirmation gates, and post-action verification.

## Sub-Modules


| Module | Description | Trigger keywords |
| ------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| **Query orders** | Order list, order history | `orders`, `open orders`, `order history` |
| **Query positions** | Current position list, position history | `positions`, `my positions`, `position history`, `holdings`, `current position` |
| **Query market** | Category list, symbol list, ticker, symbol kline | `category`, `categories`, `symbol list`, `symbols`, `ticker`, `kline`, `candlestick`, `market` |
| **Query assets** | User balance/asset info, MT5 account info | `assets`, `balance`, `account`, `my funds`, `MT5`, `mt5 account` |
| **Place order** | Create new order (supports take-profit/stop-loss at creation) | `place order`, `create order`, `open order`, `buy`, `sell`, `long`, `short`, `take-profit`, `stop-loss` |
| **Amend order** | Change order price, take-profit, or stop-loss (size not supported) | `amend order`, `modify order`, `change price`, `take-profit`, `stop-loss` |
| **Cancel order** | Cancel one or more orders | `cancel order`, `revoke order`, `cancel` |
| **Modify position** | Change position take-profit/stop-loss only (leverage, margin not supported) | `modify position`, `take-profit`, `stop-loss`, `change take-profit`, `change stop-loss` |
| **Close position** | Full or partial close | `close position`, `close`, `close all`, `flat` |


## Routing Rules

| Intent | Example phrases | Route to |
| ------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Query orders** | "My TradFi orders", "order history", "show open orders", "order status" | Read `references/query-orders.md` |
| **Query positions** | "My positions", "position history", "current holdings", "what am I holding" | Read `references/query-positions.md` |
| **Query market** | "TradFi categories", "category list", "symbol list", "ticker", "kline for X", "market data" | Read `references/query-market.md` |
| **Query assets** | "My assets", "balance", "account balance", "MT5 account", "my MT5 info" | Read `references/query-assets.md` |
| **Place order** | "Place order", "buy EURUSD", "sell XAUUSD 0.1", "open long", "order with take-profit/stop-loss" | Read `references/place-order.md` |
| **Amend order** | "Amend order", "change price to X", "take-profit", "stop-loss" | Read `references/amend-order.md` |
| **Cancel order** | "Cancel order", "cancel all orders", "revoke order" | Read `references/cancel-order.md` |
| **Modify position** | "Modify position", "take-profit", "stop-loss", "change take-profit/stop-loss" | Read `references/modify-position.md` |
| **Close position** | "Close position", "close all", "close half", "flat" | Read `references/close-position.md` |
| **Unclear** | "TradFi", "show me my TradFi" | **Clarify**: list query and trading modules or ask which the user wants. |


## gate-cli command index

**Query (read-only)** — use only MCP-documented parameters.

| # | Tool | Purpose |
| ---| --------------------------------------- | ------- |
| 1 | `gate-cli cex tradfi order list` | List open orders. |
| 2 | `gate-cli cex tradfi order history` | Query order history list (filled/cancelled). |
| 3 | `gate-cli cex tradfi position list` | List current positions. |
| 4 | `gate-cli cex tradfi position history` | List historical positions/settlements. |
| 5 | `gate-cli cex tradfi market categories` | Query TradFi category list. |
| 6 | `gate-cli cex tradfi market symbols` | List symbols (by category if supported). |
| 7 | `gate-cli cex tradfi market ticker` | Get ticker(s) for symbol(s). |
| 8 | `gate-cli cex tradfi market symbol` | Get symbol config (required before place order: leverages, min_order_volume, step_order_volume). If no result, symbol may not exist — do not place order. |
| 9 | `gate-cli cex tradfi market kline` | Get kline/candlestick for symbol. |
| 10 | `gate-cli cex tradfi account assets` | Get user account/balance (assets). |
| 11 | `gat