Gate Wallet Market Skill

Market / Token domain — K-line, transaction stats, liquidity, token details, rankings, security audit, new token discovery. 7 MCP tools, all require no authentication.

Trigger scenarios: User mentions "market", "K-line", "kline", "price", "token info", "ranking", "security", "audit", "risk", "chart", "new token", "liquidity", or when market data / security audit assistance is needed.

Step 0: MCP Server Connection Check (Mandatory)

Before executing any operation, the Gate Wallet MCP Server must be confirmed available. This step cannot be skipped.

Connectivity probe:

CallMcpTool(server="gate-dex-mcp", toolName="chain.config", arguments={chain: "eth"})

Result	Action
Success	MCP Server is available, proceed to next steps
`server not found` / `unknown server`	Cursor not configured → show config guide (see below)
`connection refused` / `timeout`	Unreachable → prompt to check URL and network

When Cursor Is Not Configured

❌ Gate Wallet MCP Server Not Configured

No MCP Server named "gate-dex-mcp" found in Cursor. Follow these steps to configure:

Option 1: Via Cursor Settings (recommended)
  1. Open Cursor → Settings → MCP
  2. Click "Add new MCP server"
  3. Fill in:
     - Name: gate-dex-mcp
     - Type: HTTP
     - URL: https://api.gatemcp.ai/mcp
  4. Save and retry

Option 2: Manually edit config file
  Edit ~/.cursor/mcp.json, add:
  {
    "mcpServers": {
      "gate-dex-mcp": {
        "url": "https://api.gatemcp.ai/mcp"
      }
    }
  }

If you don't have an MCP Server URL yet, contact your administrator.

When Remote Service Is Unreachable

⚠️  Gate Wallet MCP Server Connection Failed

MCP Server configuration found, but unable to connect to the remote service. Please check:
1. Verify the service URL is correct (is the configured URL accessible?)
2. Check network connection (VPN / firewall interference?)
3. Confirm the remote service is running

When API Key Authentication Fails

🔑 Gate Wallet MCP Server Authentication Failed

MCP Server connected but API Key validation failed. The service has AK/SK authentication enabled (x-api-key header).
Contact your administrator to obtain a valid API Key and verify the server-side configuration.

Authentication

All tools in this Skill require no authentication — they are all public market data queries with no mcp_token needed.

MCP Tool Specifications

1. `market_get_kline` — Get K-Line Data

Retrieve candlestick (K-line) data for a specified token over a given time interval.

Field	Description
Tool name	`market_get_kline`
Parameters	`{ chain: string, token_address: string, interval?: string, limit?: number }`
Returns	Array of K-line data, each containing `timestamp`, `open`, `high`, `low`, `close`, `volume`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier (e.g. `"eth"`, `"bsc"`)
`token_address`	Yes	Token contract address. Use `"native"` for native tokens
`interval`	No	K-line interval (e.g. `"1m"`, `"5m"`, `"1h"`, `"4h"`, `"1d"`). Default `"1h"`
`limit`	No	Number of records to return. Default 100

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="market_get_kline",
  arguments={
    chain: "eth",
    token_address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    interval: "1h",
    limit: 24
  }
)

Response example:

[
  {
    "timestamp": 1700000000,
    "open": "1.0001",
    "high": "1.0005",
    "low": "0.9998",
    "close": "1.0002",
    "volume": "15000000"
  }
]

Agent behavior: Present K-line trends as text tables or summaries (high/low prices, price change, volume changes, etc.).

2. `market_get_tx_stats` — Get Transaction Statistics

Retrieve on-chain transaction statistics for a specified token (buy/sell counts, volumes, etc.).

Field	Description
Tool name	`market_get_tx_stats`
Parameters	`{ chain: string, token_address: string, period?: string }`
Returns	`{ buy_count: number, sell_count: number, buy_volume: string, sell_volume: string, unique_buyers: number, unique_sellers: number }`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier
`token_address`	Yes	Token contract address
`period`	No	Statistics period (e.g. `"24h"`, `"7d"`, `"30d"`). Default `"24h"`

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="market_get_tx_stats",
  arguments={
    chain: "eth",
    token_address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    period: "24h"
  }
)

Response example:

{
  "buy_count": 12500,
  "sell_count": 11800,
  "buy_volume": "45000000",
  "sell_volume": "42000000",
  "unique_buyers": 3200,
  "unique_sellers": 2900
}

3. `market_get_pair_liquidity` — Get Trading Pair Liquidity

Retrieve liquidity pool information for a specified token's trading pairs.

Field	Description
Tool name	`market_get_pair_liquidity`
Parameters	`{ chain: string, token_address: string }`
Returns	`{ total_liquidity_usd: string, pairs: [{ dex: string, pair: string, liquidity_usd: string, volume_24h: string }] }`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier
`token_address`	Yes	Token contract address

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="market_get_pair_liquidity",
  arguments={
    chain: "eth",
    token_address: "0xdAC17F958D2ee523a2206206994597C13D831ec7"
  }
)

Response example:

{
  "total_liquidity_usd": "250000000",
  "pairs": [
    {
      "dex": "Uniswap V3",
      "pair": "USDT/ETH",
      "liquidity_usd": "120000000",
      "volume_24h": "35000000"
    },
    {
      "dex": "Uniswap V3",
      "pair": "USDT/USDC",
      "liquidity_usd": "80000000",
      "volume_24h": "22000000"
    }
  ]
}

4. `token_get_coin_info` — Get Token Details

Retrieve detailed information for a specified token (name, symbol, market cap, holders, etc.).

Field	Description
Tool name	`token_get_coin_info`
Parameters	`{ chain: string, token_address: string }`
Returns	`{ name: string, symbol: string, decimals: number, total_supply: string, market_cap: string, holders: number, price: string, price_change_24h: string, website: string, socials: object }`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier
`token_address`	Yes	Token contract address

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="token_get_coin_info",
  arguments={
    chain: "eth",
    token_address: "0xdAC17F958D2ee523a2206206994597C13D831ec7"
  }
)

Response example:

{
  "name": "Tether USD",
  "symbol": "USDT",
  "decimals": 6,
  "total_supply": "40000000000",
  "market_cap": "40000000000",
  "holders": 5200000,
  "price": "1.0001",
  "price_change_24h": "0.01",
  "website": "https://tether.to",
  "socials": { "twitter": "@Tether_to" }
}

5. `token_ranking` — Token Rankings

Retrieve on-chain token rankings (by market cap, price change, volume, etc.).

Field	Description
Tool name	`token_ranking`
Parameters	`{ chain: string, sort_by?: string, order?: string, limit?: number }`
Returns	Array of ranked tokens, each containing `rank`, `name`, `symbol`, `price`, `market_cap`, `change_24h`, `volume_24h`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier
`sort_by`	No	Sort dimension: `"market_cap"`, `"volume_24h"`, `"change_24h"`, `"holders"`. Default `"market_cap"`
`order`	No	Sort direction: `"desc"` (descending), `"asc"` (ascending). Default `"desc"`
`limit`	No	Number of records to return. Default 20

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="token_ranking",
  arguments={
    chain: "eth",
    sort_by: "volume_24h",
    order: "desc",
    limit: 10
  }
)

Response example:

[
  {
    "rank": 1,
    "name": "Tether USD",
    "symbol": "USDT",
    "price": "1.0001",
    "market_cap": "40000000000",
    "change_24h": "0.01",
    "volume_24h": "5000000000"
  }
]

6. `token_get_coins_range_by_created_at` — New Token Discovery

Retrieve newly listed tokens within a specified creation time range.

Field	Description
Tool name	`token_get_coins_range_by_created_at`
Parameters	`{ chain: string, start_time?: number, end_time?: number, limit?: number }`
Returns	Array of tokens, each containing `name`, `symbol`, `token_address`, `created_at`, `price`, `market_cap`, `holders`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier
`start_time`	No	Start timestamp (seconds). Default 24 hours ago
`end_time`	No	End timestamp (seconds). Default current time
`limit`	No	Number of records to return. Default 20

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="token_get_coins_range_by_created_at",
  arguments={
    chain: "eth",
    limit: 10
  }
)

7. `token_get_risk_info` — Token / Contract Security Audit

Retrieve security risk assessment for a token or contract, including audit status and risk tags.

Field	Description
Tool name	`token_get_risk_info`
Parameters	`{ chain: string, address: string }`
Returns	`{ risk_level: string, is_audited: boolean, risk_items: [{ type: string, description: string, severity: string }], contract_verified: boolean, owner_renounced: boolean }`

Parameters:

Parameter	Required	Description
`chain`	Yes	Chain identifier
`address`	Yes	Token contract address or any contract address

Call example:

CallMcpTool(
  server="gate-dex-mcp",
  toolName="token_get_risk_info",
  arguments={
    chain: "eth",
    address: "0xdAC17F958D2ee523a2206206994597C13D831ec7"
  }
)

Response example:

{
  "risk_level": "low",
  "is_audited": true,
  "risk_items": [],
  "contract_verified": true,
  "owner_renounced": false
}

risk_level values:

risk_level	Meaning	Agent Behavior
`low`	Low risk	Proceed normally
`medium`	Medium risk	Alert user, list risk items
`high`	High risk	Strong warning, advise against interaction. If user insists, show security warning confirmation
`unknown`	No audit data	Inform that no security info was found, advise user to investigate independently

Agent behavior: This tool is used for pre-trade contract security audits, helping users assess token risk.

Skill Routing

After viewing market data, guide subsequent actions based on user intent:

User Intent	Suggested Action
View other token market data	Continue using this Skill's `market_get_kline` and other tools
View token security info	Use `token_get_risk_info`
View more token rankings	Use `token_ranking`
View token details	Use `token_get_coin_info`

Workflows

All workflows below require passing the Step 0 MCP Server connection check first. If the check fails, abort — this will not be repeated.

Flow A: View Token Market Data (K-Line + Stats)

Step 1: Intent recognition + parameter collection
  Extract query intent from user input:
  - Token name/symbol or contract address
  - Chain (optional, can infer from context)
  - K-line interval (optional, default 1h)
  - Stats period (optional, default 24h)

  If user provides token symbol without contract address:
  - First call token_get_coin_info or infer from context
  ↓

Step 2: Fetch market data
  Parallel calls (when applicable):
  - market_get_kline({ chain, token_address, interval, limit })
  - market_get_tx_stats({ chain, token_address, period })
  - market_get_pair_liquidity({ chain, token_address })
  ↓

Step 3: Format and display

  ────────────────────────────
  📈 {token_name} ({symbol}) Market Data

  Current Price: ${price}
  24h Change: {change_24h}%
  24h High: ${high_24h}
  24h Low: ${low_24h}

  ── Transaction Stats (24h) ──
  Buys: {buy_count} txns / ${buy_volume}
  Sells: {sell_count} txns / ${sell_volume}
  Unique Buyers: {unique_buyers}
  Unique Sellers: {unique_sellers}

  ── Liquidity ──
  Total Liquidity: ${total_liquidity_usd}
  Main Pairs:
  | DEX | Pair | Liquidity | 24h Volume |
  |-----|------|-----------|------------|
  | {dex} | {pair} | ${liquidity} | ${volume} |
  ────────────────────────────

  ↓

Step 4: Suggest next actions
  - View security info → token_get_risk_info
  - View more tokens → token_ranking
  - View token details → token_get_coin_info

Flow B: View Token Details

Step 1: Execute query
  Call token_get_coin_info({ chain, token_address })
  ↓

Step 2: Format and display

  ────────────────────────────
  🪙 Token Details

  Name: {name} ({symbol})
  Contract: {token_address}
  Chain: {chain_name}
  Decimals: {decimals}
  Total Supply: {total_supply}
  Market Cap: ${market_cap}
  Holders: {holders}
  Current Price: ${price}
  24h Change: {price_change_24h}%
  Website: {website}
  ────────────────────────────

  ↓

Step 3: Suggest next actions
  - View K-line data → market_get_kline
  - View security audit → token_get_risk_info
  - View token rankings → token_ranking

Flow C: Token Rankings

Step 1: Collect parameters
  Determine ranking dimension (market cap / volume / price change), chain, count
  ↓

Step 2: Execute query
  Call token_ranking({ chain, sort_by, order, limit })
  ↓

Step 3: Format and display

  ────────────────────────────
  🏆 {chain_name} Token Rankings (by {sort_by})

  | # | Token | Price | 24h Change | Market Cap | 24h Volume |
  |---|-------|-------|------------|------------|------------|
  | 1 | {symbol} | ${price} | {change}% | ${mcap} | ${vol} |
  | 2 | ... | ... | ... | ... | ... |
  ────────────────────────────

Flow D: Security Audit

Step 1: Execute query
  Call token_get_risk_info({ chain, address })
  ↓

Step 2: Format and display

  When risk_level == "low":

  ────────────────────────────
  🛡️ Security Audit Results

  Contract: {address}
  Chain: {chain_name}
  Risk Level: Low ✅
  Contract Verified: Yes
  Audited: Yes
  Owner Renounced: {Yes/No}
  Risk Items: None
  ────────────────────────────

  When risk_level == "high":

  ────────────────────────────
  ⚠️ Security Audit Results

  Contract: {address}
  Chain: {chain_name}
  Risk Level: High ⚠️
  Contract Verified: {Yes/No}
  Audited: {Yes/No}

  Risk Items:
  - [{severity}] {description}
  - [{severity}] {description}

  Warning: Exercise caution when interacting with this contract — risk of asset loss.
  ────────────────────────────

Flow E: New Token Discovery

Step 1: Collect parameters
  Determine chain and time range
  ↓

Step 2: Execute query
  Call token_get_coins_range_by_created_at({ chain, start_time?, end_time?, limit })
  ↓

Step 3: Format and display

  ────────────────────────────
  🆕 {chain_name} Newly Listed Tokens

  | Token | Contract | Created At | Price | Market Cap | Holders |
  |-------|----------|------------|-------|------------|---------|
  | {symbol} | {addr_short} | {time} | ${price} | ${mcap} | {holders} |

  Note: New tokens carry higher risk. Check the security audit before making any trading decisions.
  ────────────────────────────

  ↓

Step 4: Suggest next actions
  - View a token's security info → token_get_risk_info
  - View a token's details → token_get_coin_info

Typical Workflow

Query → Audit Workflow

token_get_coin_info (query token info)
  → token_get_risk_info (security audit)
    → market_get_kline + market_get_tx_stats (market analysis)

Display Standards

Price Display Rules

Greater than $1: 2 decimal places (e.g. $1,920.50)
$0.01 ~ $1: 4 decimal places (e.g. $0.0521)
Less than $0.01: 6–8 significant digits (e.g. $0.00000142)
Percentages: 2 decimal places (e.g. +2.15%, -0.32%)
Large values: Thousand separators; very large values use abbreviations (e.g. $1.2B, $350M)

Address Display Rules

Show full contract address with chain info when displaying completely
Use truncated format for brief references: 0xdAC1...1ec7
Provide block explorer links for user verification

Time Display Rules

Use the user's local timezone
Format: YYYY-MM-DD HH:mm:ss
Relative time: within 24h, use "X minutes ago", "X hours ago"

Edge Cases and Error Handling

Scenario	Handling
MCP Server not configured	Abort all operations, show Cursor config guide
MCP Server unreachable	Abort all operations, show network check prompt
Invalid token contract address	Prompt address format error, ask user to confirm
Token not found on specified chain	Inform token not found, suggest verifying chain and address
`market_get_kline` returns empty data	Inform no K-line data available — may be a new or very low volume token
`token_get_risk_info` returns `unknown`	Inform no security audit info found, advise user to investigate independently
`token_ranking` returns empty list	Inform no ranking data available for this chain
Query timeout	Suggest network issue, recommend retrying later
MCP Server returns unknown error	Display the error message as-is
User provides token symbol instead of address	First attempt to resolve via `token_get_coin_info` or context
Unsupported chain identifier	Display the list of supported chains

Security Rules

Read-only operations: This Skill only involves public data queries — no on-chain writes, no authentication needed, no transaction confirmation gates.
Objective security audit display: Present token_get_risk_info results as-is without subjective commentary. Clearly flag high risk but do not make decisions for the user.
New token risk warnings: Append risk reminders when displaying new token lists — new tokens generally carry higher risk.
No operations when MCP Server is unavailable: If Step 0 check fails, abort all subsequent steps.
Transparent MCP Server errors: Display all MCP Server error messages to the user as-is — do not hide or alter them.
No investment advice: Market data is provided for reference only — the Agent must not make any recommendations or judgments on token investment value.

Gate Dex Market v1

Gate Wallet Market Skill

Step 0: MCP Server Connection Check (Mandatory)

When Cursor Is Not Configured

When Remote Service Is Unreachable

When API Key Authentication Fails

Authentication

MCP Tool Specifications

1. `market_get_kline` — Get K-Line Data

2. `market_get_tx_stats` — Get Transaction Statistics

3. `market_get_pair_liquidity` — Get Trading Pair Liquidity

4. `token_get_coin_info` — Get Token Details

5. `token_ranking` — Token Rankings

6. `token_get_coins_range_by_created_at` — New Token Discovery

7. `token_get_risk_info` — Token / Contract Security Audit

Skill Routing

Workflows

Flow A: View Token Market Data (K-Line + Stats)

Flow B: View Token Details

Flow C: Token Rankings

Flow D: Security Audit

Flow E: New Token Discovery

Typical Workflow

Query → Audit Workflow

Display Standards

Price Display Rules

Address Display Rules

Time Display Rules

Edge Cases and Error Handling

Security Rules

Download

Skill Info

Gate Dex Market v1

Gate Wallet Market Skill

Step 0: MCP Server Connection Check (Mandatory)

When Cursor Is Not Configured

When Remote Service Is Unreachable

When API Key Authentication Fails

Authentication

MCP Tool Specifications

1. market_get_kline — Get K-Line Data

2. market_get_tx_stats — Get Transaction Statistics

3. market_get_pair_liquidity — Get Trading Pair Liquidity

4. token_get_coin_info — Get Token Details

5. token_ranking — Token Rankings

6. token_get_coins_range_by_created_at — New Token Discovery

7. token_get_risk_info — Token / Contract Security Audit

Skill Routing

Workflows

Flow A: View Token Market Data (K-Line + Stats)

Flow B: View Token Details

Flow C: Token Rankings

Flow D: Security Audit

Flow E: New Token Discovery

Typical Workflow

Query → Audit Workflow

Display Standards

Price Display Rules

Address Display Rules

Time Display Rules

Edge Cases and Error Handling

Security Rules

Download

Skill Info

1. `market_get_kline` — Get K-Line Data

2. `market_get_tx_stats` — Get Transaction Statistics

3. `market_get_pair_liquidity` — Get Trading Pair Liquidity

4. `token_get_coin_info` — Get Token Details

5. `token_ranking` — Token Rankings

6. `token_get_coins_range_by_created_at` — New Token Discovery

7. `token_get_risk_info` — Token / Contract Security Audit