| name | gate-dex-trade-cli |
| version | 2026.5.7-1 |
| updated | 2026-05-07 |
| description | gate-dex CLI swap skill: one-shot DEX swap (quote → GV checkin → sign → broadcast) via the swap command. GV checkin built in — no external binary. Supports EVM multi-chain and Solana, with ERC20 approve flow. Use this skill whenever the user wants to swap, exchange, buy, sell, convert, or bridge tokens via the gate-dex CLI. Trigger phrases include swap, exchange, buy, sell, convert, bridge, cross-chain, quote, swap history, swap detail, swap-tokens, bridge-tokens. |
| homepage | https://git.fulltrust.link/web3/ai/gate-dex-cli |
| user-invocable | true |
| metadata | {"openclaw":{"emoji":"🔄","os":["linux","darwin"],"requires":{"bins":["gate-dex"]},"install":[{"id":"download-linux-x64","kind":"download","os":["linux"],"url":"https://gate-dex-cli.gateweb3.cc/latest/gate-dex-linux-x64","bins":["gate-dex"],"label":"Download gate-dex (Linux x64)"},{"id":"download-macos-arm64","kind":"download","os":["darwin"],"url":"https://gate-dex-cli.gateweb3.cc/latest/gate-dex-darwin-arm64","bins":["gate-dex"],"label":"Download gate-dex (macOS arm64)"}]}} |
Gate DEX CLI — Swap
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 call MCP tools explicitly listed in this skill. Tools not documented here must NOT be called, even if they
exist in the MCP server.
- Only use the
gate-dex CLI subcommands explicitly listed in this skill and its references. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.
One-shot DEX swap via CLI. GV checkin + sign + broadcast are all built into the swap command. No external tx-checkin binary needed. Supports EVM and Solana.
Skill Boundaries
| This skill | Route to other skill |
|---|
| Swap tokens (same-chain) | Auth / login issues → gate-dex-wallet-cli |
| Cross-chain bridge | Balance, address, token list → gate-dex-wallet-cli |
| Swap quote (preview) | Token transfers (send) → gate-dex-wallet-cli |
| Swap / bridge history & order detail | K-line, token info, token security → gate-dex-market-cli |
| Swappable & bridge token discovery | — |
Applicable Scenarios
- "Swap ETH for USDT", "exchange tokens", "buy SOL", "convert", "trade"
- Get a swap quote before executing
- View swap history or a specific swap order detail
- List swappable tokens or cross-chain bridge tokens
CLI Commands
Quote (preview only, no signing)
gate-dex quote --from-chain 1 --to-chain 1 --from - --to 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 0.01
gate-dex quote --from-chain 42161 --to-chain 42161 \
--from 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 \
--to 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 \
--amount 100
gate-dex quote --from-chain 501 --to-chain 501 --from - \
--to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 0.1
gate-dex quote --from-chain 1 --to-chain 42161 --from - \
--to 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 --amount 0.1 \
--to-wallet 0xYourArbitrumAddress
Returns estimated output amount, price impact, route, and fee. No signing.
One-Shot Swap (quote + GV checkin + sign + broadcast)
gate-dex swap --from-chain 1 --to-chain 1 --from - \
--to 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 0.01
gate-dex swap --from-chain 42161 --to-chain 42161 \
--from 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 \
--to 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 \
--amount 100 --slippage 0.005
gate-dex swap --from-chain 501 --to-chain 501 --from - \
--to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 0.05
gate-dex swap --from-chain 1 --to-chain 42161 --from - \
--to 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 --amount 0.1 \
--to-wallet 0xYourArbitrumAddress
| Option | Required | Description |
|---|
--from-chain <id> | Yes | Source chain ID |
--to-chain <id> | No | Destination chain ID (defaults to same as from-chain) |
--from <token> | Yes | Source token contract; use - for native token (ETH/SOL/BNB) |
--to <token> | Yes | Destination token contract |
--amount <n> | Yes | Human-readable input amount |
--slippage <n> | No | Slippage tolerance as decimal (default 0.03 = 3%) |
--native-in <0|1> | No | 1 if source token is native (ETH/SOL); default 0 |
--native-out <0|1> | No | 1 if destination token is native; default 0 |
--wallet <addr> | No | Source wallet address (auto-detected from auth) |
--to-wallet <addr> | No | Destination wallet address (required for cross-chain bridge) |
Swap History
gate-dex swap-history
Swap Order Detail
gate-dex swap-detail <order_id>
List Swappable Tokens
gate-dex swap-tokens
gate-dex swap-tokens --chain eth
gate-dex swap-tokens --chain sol --search USDC
Use --search to look up a token address by symbol.
List Cross-Chain Bridge Tokens
gate-dex bridge-tokens
gate-dex bridge-tokens --src-chain eth --dest-chain arb
Internal Flow of swap Command
The agent does not run any of these steps manually — the CLI handles everything:
EVM same-chain flow:
1. Load auth; fetch wallet address
2. Get quote
3. Check if ERC20 approve is needed → auto-approve if needed (GV checkin for approve)
4. Re-quote after approve
5. Build swap transaction
6. GV security checkin (built-in) for swap tx
7. Server-side signing
8. Broadcast
9. Print tx hash + order ID
EVM cross-chain bridge flow (from-chain ≠ to-chain):
1. Load auth; fetch wallet address
2. Get cross-chain bridge quote (--from-chain / --to-chain / --to-wallet required)
3. Check if ERC20 approve is needed on source chain → auto-approve if needed
4. Build bridge transaction on source chain
5. GV security checkin (built-in)
6. Server-side signing
7. Broadcast on source chain
8. Print source tx hash + order ID (destination arrival is async, monitor via swap-detail)
Solana flow:
1. Load auth; fetch Solana address
2. Get quote
3. Build transaction (base64 → base58 conversion handled internally)
4. GV security checkin (built-in, includes priority fee)
5. Server-side signing
6. Broadcast via Solana mainnet RPC
7. Print tx hash + order ID
CRITICAL: There is no tx-checkin binary to run. Do NOT attempt to run a checkin binary before swap. The CLI has GV checkin built in.
Chain IDs
| Chain | ID | Native Token |
|---|
| Ethereum | 1 | ETH |
| BSC | 56 | BNB |
| Polygon | 137 | MATIC |
| Arbitrum | 42161 | ETH |
| Optimism | 10 | ETH |
| Avalanche | 43114 | AVAX |
| Base | 8453 | ETH |
| Solana | 501 | SOL |
Native token address: Use - as the token address for native tokens (ETH, SOL, BNB, etc.).
Slippage Guidelines
| Token type | Recommended slippage |
|---|
| Stablecoins (USDT ↔ USDC) | 0.005 (0.5%) |
| Major tokens (ETH, BTC, SOL) | 0.01–0.03 (1%–3%) |
| Mid-cap tokens | 0.03 (3%) |
| Meme / low-liquidity tokens | 0.05–0.10 (5%–10%) |
Common Token Addresses
| Chain | USDT | USDC |
|---|
| Ethereum (1) | 0xdAC17F958D2ee523a2206206994597C13D831ec7 | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| Arbitrum (42161) | 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 | 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 |
| BSC (56) | 0x55d398326f99059fF775485246999027B3197955 | 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d |
| Solana (501) | Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
Workflow
Step 1: Auth check
Call gate-dex status to verify the session.
Key data to extract:
is_authenticated: boolean- If not logged in → instruct the user to run
gate-dex login (delegated to gate-dex-wallet-cli).
Step 2: Collect parameters
Required: from-chain, to-chain (defaults to from-chain), from-token, to-token, amount. Optional: slippage, to-wallet (cross-chain only).
If a token symbol is given without an address → call gate-dex swap-tokens --chain <chain> --search <symbol> and confirm the resolved address with the user.
Key data to extract:
from_chain, to_chain, from_token, to_token, amount, slippage, to_wallet
Step 3: Get quote
Call gate-dex quote --from-chain <id> --to-chain <id> --from <token> --to <token> --amount <n>.
Key data to extract:
estimated_out, price_impact, route, fee, slippage_used
Step 4: User confirmation in chat (MANDATORY)
Render the Swap Confirmation Template and wait for an explicit "confirm" reply.
- "cancel" → abort.
- "modify" → return to Step 2.
Step 5: Execute
Call gate-dex swap --from-chain <id> --to-chain <id> --from <token> --to <token> --amount <n> [--slippage <n>] [--to-wallet <addr>]. The CLI handles GV check-in, signing, and broadcast internally.
Key data to extract:
tx_hash, order_id, explorer_url
Step 6: Render the report
Format the output per Report Template below. Surface the mandatory Risk Disclosure.
NEVER run gate-dex swap before receiving explicit user confirmation in Step 4.
Judgment Logic Summary
| User Intent | Trigger Phrases | Action |
|---|
| Same-chain swap | "swap", "exchange", "convert", "buy", "sell" + same chain | quote → confirm → swap (Steps 3–5) |
| Cross-chain bridge | "bridge", "cross-chain", different from-chain / to-chain | bridge-tokens → quote (with --to-wallet) → confirm → swap |
| Quote only | "how much would I get", "estimate", "preview" with no execution intent | Step 3 only; do not execute |
| Resolve token address | "what's the address", "find token X" | gate-dex swap-tokens --search |
| List swappable tokens | "what tokens can I swap" | gate-dex swap-tokens |
| List bridge pairs | "what cross-chain pairs are supported" | gate-dex bridge-tokens |
| Order history | "my swap history", "past trades" | gate-dex swap-history |
| Order detail | "details of order X", bridge settlement check | gate-dex swap-detail <order_id> |
| Authentication failure | Not logged in from CLI | Route to gate-dex-wallet-cli for login |
Swap Confirmation Template
========== Swap Confirmation ==========
From: {amount} {from_symbol} on {from_chain}
To: ~{estimated_out} {to_symbol} on {to_chain}
Slippage: {slippage}%
Route: {route_path}
Fee: {fee_usd} USD
========================================
Reply "confirm" to execute, "cancel" to abort.
Report Template
After a successful swap call:
========== Swap Result ==========
Status: Submitted
From: {amount} {from_symbol} on {from_chain}
To: ~{estimated_out} {to_symbol} on {to_chain}
Tx hash: {tx_hash}
Explorer: {explorer_url}
Order ID: {order_id}
=================================
{Cross-chain note (if applicable): destination arrival is asynchronous; track via gate-dex swap-detail <order_id>.}
Risk Disclosure: Digital asset trading involves significant risk and may result in partial or total loss of your investment. For informational purposes only; not investment, financial, tax, or legal advice.
For quote (preview only):
========== Swap Quote (Preview) ==========
{Same fields as Swap Confirmation Template}
==========================================
No transaction has been signed or broadcast.
For swap-history / swap-detail: render a compact list/table of order id, chain pair, token pair, status, timestamp.
Conversation Examples
Example 1: Swap ETH → USDT on Ethereum
User: "Swap 0.01 ETH for USDT on Ethereum"
gate-dex quote --from-chain 1 --to-chain 1 --from - --to 0xdAC17... --amount 0.01- Show quote to user; wait for "confirm".
gate-dex swap --from-chain 1 --to-chain 1 --from - --to 0xdAC17... --amount 0.01- Display tx hash + etherscan link + order ID.
Example 2: Swap SOL → USDC
User: "Swap 0.1 SOL for USDC"
gate-dex quote --from-chain 501 --to-chain 501 --from - --to EPjFWdd5... --amount 0.1- Show quote; user confirms.
gate-dex swap --from-chain 501 --to-chain 501 --from - --to EPjFWdd5... --amount 0.1- Display tx hash + solscan link.
Example 3: Unknown token symbol
User: "Swap 10 USDT for ARB on Arbitrum"
gate-dex swap-tokens --chain arb --search ARB → get ARB contract address.- Proceed with quote and swap using the resolved address.
Example 4: Cross-chain bridge ETH (Ethereum) → USDT (Arbitrum)
User: "Bridge 0.1 ETH from Ethereum to USDT on Arbitrum"
gate-dex bridge-tokens --src-chain eth --dest-chain arb → confirm the token pair is supported.gate-dex quote --from-chain 1 --to-chain 42161 --from - --to 0xFd086bC7... --amount 0.1 --to-wallet 0xYourAddress- Show quote to user; wait for "confirm".
gate-dex swap --from-chain 1 --to-chain 42161 --from - --to 0xFd086bC7... --amount 0.1 --to-wallet 0xYourAddress- Display source chain tx hash; note that destination arrival is async — user can track via
gate-dex swap-detail <order_id>.
Error Handling
| Error | Handling |
|---|
Not logged in | Run gate-dex login |
| Insufficient balance | Abort; show shortfall |
| Quote expired | CLI re-quotes automatically before signing |
| Slippage too low | Suggest higher slippage (0.05 for volatile tokens) |
| GV checkin failed (built-in) | CLI displays error; suggest retry |
| Broadcast failed | Display error code; do not auto-retry |
| User cancels | Abort immediately |
Security Rules
- Confirm before swap: Always get explicit user confirmation before running
gate-dex swap. Without explicit user confirmation in chat, no swap command may be executed — only quote and other read-only commands are allowed.
- Show quote first: Always run
quote first so the user can see estimated output.
- No tx-checkin binary: CLI handles GV checkin internally — do not run any external binary.
- Audit unfamiliar tokens: Recommend
gate-dex token-risk before swapping unknown tokens.
- Transaction irreversibility: On-chain swaps and bridges are generally irreversible. Always re-verify chain, token addresses, amount, and (for bridge) destination wallet with the user before executing.
Risk Disclosure
Mandatory in trade output: Digital asset trading involves significant risk and may result in partial or total loss of your investment. Cross-chain bridge transactions add settlement-time and counterparty risk; destination arrival is asynchronous.
The above is for informational purposes only and does not constitute investment, financial, tax, or legal advice. AI-assisted outputs are for general information only and do not constitute any representation, warranty, or guarantee by Gate. This skill is intended for users aged 18 or above with full civil capacity; availability may vary by jurisdiction.
