Gate DEX CLI — Market & Token Data

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.

Read-only market data via CLI. K-line, liquidity, trading stats, token info/risk/rank, new listings, chain config, and raw RPC. No GV checkin or signing involved.

Skill Boundaries

---

Applicable Scenarios

• "K-line for token 0x...", "price chart", "candlestick data"
• "Token info for 0x...", "price of this token", "market cap"
• "Is this token safe?", "audit contract", "honeypot check", "security scan"
• "Token rankings", "top gainers", "price change leaderboard"
• "New tokens", "recently listed", "new listings"
• "Liquidity pool data", "trading volume", "tx stats"
• "List swappable tokens", "find token address by symbol"
• "Chain config", "RPC call", "eth_getBalance", "getBalance"

---

CLI Commands

K-Line (Candlestick)

gate-dex kline --chain eth --address 0xTokenAddress
gate-dex kline --chain sol --address <token_mint>

Returns OHLCV candlestick data for the token.

Liquidity Pool Events

gate-dex liquidity --chain eth --address 0xTokenAddress

Returns recent liquidity add/remove events.

Trading Volume Stats

gate-dex tx-stats --chain eth --address 0xTokenAddress

Returns trading volume, transaction count, buy/sell stats.

Token Info (Price, Market Cap)

gate-dex token-info --chain eth --address 0xTokenAddress
gate-dex token-info --chain sol --address <token_mint>

Returns price, market cap, 24h volume, price change, total supply.

Token Security Audit

gate-dex token-risk --chain eth --address 0xTokenAddress
gate-dex token-risk --chain sol --address <token_mint>

Returns security risk: honeypot check, contract ownership, trading restrictions, liquidity lock status.

Always run token-risk before swapping an unfamiliar token.

Token Rankings

gate-dex token-rank                     # all chains
gate-dex token-rank --chain eth         # Ethereum only
gate-dex token-rank --chain arb --limit 20

New Token Listings

gate-dex new-tokens
gate-dex new-tokens --chain eth
gate-dex new-tokens --chain sol --start 2026-04-01T00:00:00Z

Swappable Token List

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.

Cross-Chain Bridge Tokens

gate-dex bridge-tokens
gate-dex bridge-tokens --src-chain eth --dest-chain arb

Chain Configuration

gate-dex chain-config          # all chains
gate-dex chain-config eth
gate-dex chain-config sol

Raw JSON-RPC Call

# ETH balance
gate-dex rpc --chain ETH --method eth_getBalance \
  --params '["0xYourAddress", "latest"]'

# ERC20 balanceOf
gate-dex rpc --chain ETH --method eth_call \
  --params '[{"to":"0xContractAddr","data":"0x70a08231000...yourAddress"},"latest"]'

# Solana: get SOL balance
gate-dex rpc --chain SOL --method getBalance \
  --params '["YourSolAddress"]'

# Current gas price
gate-dex rpc --chain ETH --method eth_gasPrice

---

Common Patterns

Find token contract address by symbol:

gate-dex swap-tokens --chain arb --search USDC

Verify on-chain balance when tokens shows 0:

gate-dex rpc --chain ETH --method eth_getBalance \
  --params '["0xYourAddress", "latest"]'

Security check before swapping new token:

gate-dex token-risk --chain eth --address 0xNewToken

---

Chain Names

Case-insensitive. Common: eth, bsc, polygon, arb/arbitrum, op/optimism, avax, base, sol.

---

Troubleshooting

---

Post-Query Suggestions

After token-info / token-risk:

You can also:
- Swap this token: gate-dex swap --from-chain <id> --from - --to <address> --amount <n>
- Check your holdings: gate-dex tokens --chain <chain>
- View K-line: gate-dex kline --chain <chain> --address <address>

---

Workflow

Step 1: Classify intent

Map the user request to one of: kline, liquidity, tx-stats, token-info, token-risk, token-rank, new-tokens, swap-tokens (discovery), bridge-tokens, chain-config, or rpc.

Key data to extract:

• intent: matched command
• chain: chain name (case-insensitive; e.g. eth, bsc, arb, sol)
• address: token contract address (when applicable)

Step 2: Resolve missing parameters

• If the user gave a token symbol but no address → run gate-dex swap-tokens --chain <chain> --search <symbol> and confirm the resolved address.
• If chain is missing for a per-chain command → ask the user; do not guess.
• For rpc, ensure --params is a valid JSON array string.

Key data to extract:

• resolved_address
• resolved_chain

Step 3: Run the read-only command

Call exactly one gate-dex subcommand from the table in CLI Commands. No write or signing commands are available in this skill.

Key data to extract:

• cli_stdout: raw CLI output

Step 4: Render the report

Format the output per Report Template below; surface the Risk Disclosure when the response includes price/security/analytical content.

Judgment Logic Summary

Report Template

For data-bearing commands (token-info, token-rank, kline, tx-stats, liquidity, new-tokens, chain-config):

========== {Command Title} ==========
Chain:        {resolved_chain}
Address:      {resolved_address}
Result:
{key_value_table_or_compact_summary}
========================================
{Optional follow-up suggestions}

Risk Disclosure: For informational purposes only; not investment, financial, tax, or legal advice. Verify on-chain data independently.

For token-risk:

========== Token Risk Audit ==========
Chain:               {chain}
Address:             {address}
Honeypot:            {yes/no/unknown}
Contract ownership:  {renounced/owner_known}
Trading restrictions:{summary}
Liquidity lock:      {locked_until/unlocked/unknown}
========================================
{Warning if any flag is set; recommend confirmation before swap}

For rpc:

========== RPC Result ==========
Chain:   {chain}
Method:  {method}
Params:  {params_json}
Result:  {raw_json_response}
================================

Security Rules

1. Audit before swapping unfamiliar tokens: Run token-risk first.
2. RPC params must be valid JSON: --params must be a JSON array string.
3. Read-only: All commands here are read-only — no signing or fund movement.

---

Risk Disclosure

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. Digital asset prices, market data, and security audits may be incomplete or delayed; always verify on-chain data independently before acting.