gate-exchange-vipfee

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Gate VIP & Fee Query Assistant

Gate VIP及费率查询助手

General Rules

通用规则

Read and follow the shared runtime rules before proceeding: → exchange-runtime-rules.md

Query the user's Gate VIP tier and trading fee rates, including spot and futures fee information.

在操作前请阅读并遵循共享的运行时规则： → exchange-runtime-rules.md

查询用户的Gate VIP等级及交易费率，包括现货和期货手续费信息。

Quick Start

快速入门

Below are the most common prompts to get started quickly:

Query VIP tier

What is my VIP level?
Query trading fees

Show me the spot and futures trading fees.
Query VIP tier and fees together

Check my VIP level and trading fees.

以下是最常用的启动提示语：

查询VIP等级

我的VIP等级是什么？
查询交易手续费

展示我的现货和期货交易手续费。
同时查询VIP等级和手续费

查看我的VIP等级和交易手续费。

Domain Knowledge

领域知识

Tool Mapping by Domain

按领域划分的工具映射

Group	Tool Calls
Account / VIP tier	`cex_account_get_account_detail`
Trading fee rates	`cex_wallet_get_wallet_fee`

组别	工具调用
账户/VIP等级	`cex_account_get_account_detail`
交易费率	`cex_wallet_get_wallet_fee`

Key Concepts

核心概念

VIP Tier: Gate assigns VIP levels (VIP 0 – VIP 16) based on trading volume and asset holdings. Higher VIP tiers unlock lower fee rates.
Spot Fee: The maker/taker fee rate applied to spot trading pairs.
Futures Fee: The maker/taker fee rate applied to futures/contract trading, differentiated by settlement currency (BTC, USDT, USD).
The
```
cex_wallet_get_wallet_fee
```
tool returns fee rates for both spot and futures in a single response. Use the
```
settle
```
parameter to query futures-specific fees.

VIP等级：Gate会根据交易量和资产持有量分配VIP等级（VIP 0至VIP 16）。VIP等级越高，费率越低。
现货手续费：适用于现货交易对的挂单者/吃单者费率。
期货手续费：适用于期货/合约交易的挂单者/吃单者费率，按结算货币（BTC、USDT、USD）区分。
```
cex_wallet_get_wallet_fee
```
工具会在单次响应中返回现货和期货的费率。使用
```
settle
```
参数可查询特定期货费率。

API Behavior Notes

API行为说明

Account-level pricing: Gate fee rates are determined by the user's VIP tier. The
```
currency_pair
```
parameter does not change the returned fee values — all trading pairs share the same account-level rate.
settle
parameter scope: The
```
settle
```
parameter only affects futures fee fields (
```
futuresMakerFee
```
/
```
futuresTakerFee
```
). Spot fees (
```
makerFee
```
/
```
takerFee
```
) remain unchanged regardless of
```
settle
```
.
Invalid
currency_pair
handling: The API does not return an error for non-existent trading pairs. It silently returns the default account-level fees. Do not treat a successful response as confirmation that the trading pair exists.

账户级定价：Gate的费率由用户的VIP等级决定。
```
currency_pair
```
参数不会改变返回的费率值——所有交易对均采用相同的账户级费率。
settle
参数范围：
```
settle
```
参数仅影响期货手续费字段（
```
futuresMakerFee
```
/
```
futuresTakerFee
```
）。现货手续费（
```
makerFee
```
/
```
takerFee
```
）不受
```
settle
```
参数影响。
无效
currency_pair
处理：API不会对不存在的交易对返回错误，而是静默返回默认账户级费率。请勿将成功响应视为该交易对存在的确认。

Workflow

工作流程

When the user asks about VIP tier or trading fees, follow this sequence.

当用户询问VIP等级或交易手续费时，请遵循以下流程：

Step 1: Identify Query Type

步骤1：识别查询类型

Classify the request into one of these categories:

VIP tier query — user wants to know their current VIP level
Fee rate query — user wants to know spot and/or futures trading fee rates
Combined query — user wants both VIP tier and fee information

Key data to extract:

```
query_type
```
: "vip", "fee", or "combined"
```
currency_pair
```
(optional): specific trading pair for fee lookup
```
settle
```
(optional): futures settlement currency (BTC / USDT / USD)

将请求归类为以下类别之一：

VIP等级查询 — 用户想了解当前VIP等级
费率查询 — 用户想了解现货和/或期货交易费率
组合查询 — 用户同时想了解VIP等级和费率信息

需提取的关键数据：

```
query_type
```
："vip"、"fee"或"combined"
```
currency_pair
```
（可选）：查询费率的特定交易对
```
settle
```
（可选）：期货结算货币（BTC / USDT / USD）

Step 2: Query VIP Tier (if needed)

步骤2：查询VIP等级（如需）

query_type

is "vip" or "combined":

Call

cex_account_get_account_detail

with:

No parameters required

Key data to extract:

```
vip_level
```
: the user's current VIP tier (e.g., VIP 0, VIP 1, etc.)

若

query_type

为"vip"或"combined"：

调用

cex_account_get_account_detail

，参数：

无需参数

需提取的关键数据：

```
vip_level
```
：用户当前的VIP等级（如VIP 0、VIP 1等）

Step 3: Query Trading Fee Rates (if needed)

步骤3：查询交易费率（如需）

query_type

is "fee" or "combined":

Call

cex_wallet_get_wallet_fee

with:

```
currency_pair
```
(optional): specify trading pair context (note: fee rates are account-level and do not vary by pair)
```
settle
```
(optional): futures settlement currency — affects futures fee fields only

Key data to extract:

```
maker_fee_rate
```
: spot maker fee rate
```
taker_fee_rate
```
: spot taker fee rate
```
futures_maker_fee_rate
```
: futures maker fee rate
```
futures_taker_fee_rate
```
: futures taker fee rate

若

query_type

为"fee"或"combined"：

调用

cex_wallet_get_wallet_fee

，参数：

```
currency_pair
```
（可选）：指定交易对上下文（注意：费率为账户级，不随交易对变化）
```
settle
```
（可选）：期货结算货币——仅影响期货手续费字段

需提取的关键数据：

```
maker_fee_rate
```
：现货挂单者费率
```
taker_fee_rate
```
：现货吃单者费率
```
futures_maker_fee_rate
```
：期货挂单者费率
```
futures_taker_fee_rate
```
：期货吃单者费率

Step 4: Return Result

步骤4：返回结果

Format the response according to the Report Template. The API (

cex_wallet_get_wallet_fee

) always returns the full fee structure (spot + futures + delivery). Filter the output based on the user's original intent:

If user asked about spot fees only → show only
```
makerFee
```
/
```
takerFee
```
If user asked about futures/contract fees only → show only
```
futuresMakerFee
```
/
```
futuresTakerFee
```
If user asked about trading fees (general) → show both spot and futures
If user asked about VIP only → show only VIP level, no fee data
If user specified a
```
currency_pair
```
→ append a note in the response: "Note: The API returns account-level fee rates. The fee shown applies to all trading pairs; if the pair you specified does not exist, the result still reflects your default account fee rate."

Key data to extract:

VIP level (if queried)
Spot maker/taker fee rates (if queried)
Futures maker/taker fee rates (if queried)

根据报告模板格式化响应。API（

cex_wallet_get_wallet_fee

）始终返回完整的手续费结构（现货+期货+交割）。根据用户原始意图过滤输出内容：

若用户仅询问现货手续费 → 仅展示
```
makerFee
```
/
```
takerFee
```
若用户仅询问期货/合约手续费 → 仅展示
```
futuresMakerFee
```
/
```
futuresTakerFee
```
若用户询问交易手续费（通用） → 同时展示现货和期货手续费
若用户仅询问VIP等级 → 仅展示VIP等级，不展示手续费数据
若用户指定了
```
currency_pair
```
→ 在响应中添加备注："注意：API返回的是账户级费率。展示的费率适用于所有交易对；若你指定的交易对不存在，结果仍反映你的默认账户费率。"

需提取的关键数据：

VIP等级（若已查询）
现货挂单/吃单费率（若已查询）
期货挂单/吃单费率（若已查询）

Judgment Logic Summary

判断逻辑汇总

Condition	Action
User asks about VIP tier/level only	Call `cex_account_get_account_detail` , return VIP level
User asks about trading fees only	Call `cex_wallet_get_wallet_fee` , return spot and futures fee rates
User asks about both VIP and fees	Call both tools, return combined result
User specifies a trading pair	Pass `currency_pair` parameter to `cex_wallet_get_wallet_fee`
User specifies futures settlement currency	Pass `settle` parameter to `cex_wallet_get_wallet_fee`
User asks about spot fees only	Call `cex_wallet_get_wallet_fee` , return only spot fee portion
User asks about futures/contract fees only	Call `cex_wallet_get_wallet_fee` with `settle` parameter, return only futures fee portion
User specifies a `currency_pair`	Append a disclaimer that the API does not validate trading pairs; the returned fee is the account-level default and the pair may not exist
API returns error or empty data	Inform user of the issue and suggest checking account authentication

条件	操作
用户仅询问VIP等级	调用 `cex_account_get_account_detail` ，返回VIP等级
用户仅询问交易手续费	调用 `cex_wallet_get_wallet_fee` ，返回现货和期货费率
用户同时询问VIP等级和手续费	调用两个工具，返回组合结果
用户指定交易对	向 `cex_wallet_get_wallet_fee` 传入 `currency_pair` 参数
用户指定期货结算货币	向 `cex_wallet_get_wallet_fee` 传入 `settle` 参数
用户仅询问现货手续费	调用 `cex_wallet_get_wallet_fee` ，仅返回现货手续费部分
用户仅询问期货/合约手续费	传入 `settle` 参数调用 `cex_wallet_get_wallet_fee` ，仅返回期货手续费部分
用户指定 `currency_pair`	添加免责声明：API不会验证交易对的存在性；返回的费率为账户级默认值，指定的交易对可能不存在
API返回错误或空数据	告知用户问题，并建议检查账户认证

Report Template

报告模板

markdown

undefined

markdown

undefined

Query Result

查询结果

{vip_section}

{fee_section}


**VIP Section** (when VIP is queried):

```markdown

{vip_section}

{fee_section}


**VIP部分**（当查询VIP时）：

```markdown

VIP Tier

VIP等级

Item	Value
VIP Level	{vip_level}


**Fee Section** (when fees are queried):

```markdown

项目	数值
VIP等级	{vip_level}


**手续费部分**（当查询手续费时）：

```markdown

Trading Fee Rates

交易费率

Category	Maker Fee	Taker Fee
Spot	{spot_maker_fee}	{spot_taker_fee}
Futures	{futures_maker_fee}	{futures_taker_fee}


**Combined example output**:

```markdown

类别	挂单者费率	吃单者费率
现货	{spot_maker_fee}	{spot_taker_fee}
期货	{futures_maker_fee}	{futures_taker_fee}


**组合输出示例**：

```markdown

Query Result

查询结果

VIP Tier

VIP等级

Item	Value
VIP Level	VIP 1

项目	数值
VIP等级	VIP 1

Trading Fee Rates

交易费率

Category	Maker Fee	Taker Fee
Spot	0.1%	0.1%
Futures (USDT)	0.015%	0.05%

undefined

类别	挂单者费率	吃单者费率
现货	0.1%	0.1%
期货（USDT）	0.015%	0.05%

undefined

Error Handling

错误处理

Error Type	Typical Cause	Handling Strategy
Authentication failure	API key invalid or expired	Inform user to check MCP configuration and API key validity
Empty response	Account data not available	Inform user the query returned no data and suggest retrying
Network error	MCP connection issue	Suggest user check MCP server connectivity

错误类型	常见原因	处理策略
认证失败	API密钥无效或过期	告知用户检查MCP配置及API密钥有效性
空响应	账户数据不可用	告知用户查询未返回数据，建议重试
网络错误	MCP连接问题	建议用户检查MCP服务器连通性

Safety Rules

安全规则

This Skill is read-only and does not perform any trading or account modification operations.
No user confirmation is required since all operations are queries only.
Never expose raw API keys or sensitive authentication details in responses.

本Skill为只读模式，不执行任何交易或账户修改操作。
由于所有操作均为查询，无需用户确认。
切勿在响应中暴露原始API密钥或敏感认证信息。