gate-dex-trade-cli

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":"[Truncated]"},"install":["[Truncated]","[Truncated]"]}}

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)

# EVM: swap native ETH → USDT on Ethereum (chain_id = 1)
gate-dex quote --from-chain 1 --to-chain 1 --from - --to 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 0.01

# EVM: swap USDT → USDC on Arbitrum
gate-dex quote --from-chain 42161 --to-chain 42161 \
  --from 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 \
  --to 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 \
  --amount 100

# Solana: swap native SOL → USDC
gate-dex quote --from-chain 501 --to-chain 501 --from - \
  --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 0.1

# Cross-chain bridge: ETH on Ethereum → USDT on Arbitrum
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)

# EVM: swap native ETH → USDT
gate-dex swap --from-chain 1 --to-chain 1 --from - \
  --to 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 0.01

# EVM: swap ERC20 with custom slippage
gate-dex swap --from-chain 42161 --to-chain 42161 \
  --from 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 \
  --to 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 \
  --amount 100 --slippage 0.005

# Solana: swap SOL → USDC
gate-dex swap --from-chain 501 --to-chain 501 --from - \
  --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 0.05

# Cross-chain bridge: ETH on Ethereum → USDT on Arbitrum
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"

1. gate-dex quote --from-chain 1 --to-chain 1 --from - --to 0xdAC17... --amount 0.01
2. Show quote to user; wait for "confirm".
3. gate-dex swap --from-chain 1 --to-chain 1 --from - --to 0xdAC17... --amount 0.01
4. Display tx hash + etherscan link + order ID.

Example 2: Swap SOL → USDC User: "Swap 0.1 SOL for USDC"

1. gate-dex quote --from-chain 501 --to-chain 501 --from - --to EPjFWdd5... --amount 0.1
2. Show quote; user confirms.
3. gate-dex swap --from-chain 501 --to-chain 501 --from - --to EPjFWdd5... --amount 0.1
4. Display tx hash + solscan link.

Example 3: Unknown token symbol User: "Swap 10 USDT for ARB on Arbitrum"

1. gate-dex swap-tokens --chain arb --search ARB → get ARB contract address.
2. 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"

1. gate-dex bridge-tokens --src-chain eth --dest-chain arb → confirm the token pair is supported.
2. gate-dex quote --from-chain 1 --to-chain 42161 --from - --to 0xFd086bC7... --amount 0.1 --to-wallet 0xYourAddress
3. Show quote to user; wait for "confirm".
4. gate-dex swap --from-chain 1 --to-chain 42161 --from - --to 0xFd086bC7... --amount 0.1 --to-wallet 0xYourAddress
5. 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

1. 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.
2. Show quote first: Always run quote first so the user can see estimated output.
3. No tx-checkin binary: CLI handles GV checkin internally — do not run any external binary.
4. Audit unfamiliar tokens: Recommend gate-dex token-risk before swapping unknown tokens.
5. 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.