Gate VIP & Fee Query Assistant

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.

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.

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`

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.

API Behavior Notes

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.

Workflow

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

Step 1: Identify Query Type

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)

Step 2: Query VIP Tier (if needed)

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.)

Step 3: Query Trading Fee Rates (if needed)

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

Step 4: Return Result

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)

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

Report Template

markdown

## Query Result

{vip_section}

{fee_section}

VIP Section (when VIP is queried):

markdown

### VIP Tier

| Item | Value |
|------|-------|
| VIP Level | {vip_level} |

Fee Section (when fees are queried):

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

## Query Result

### VIP Tier

| Item | Value |
|------|-------|
| VIP Level | VIP 1 |

### Trading Fee Rates

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

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

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.

gate-exchange-vipfee

NPX Install

Tags

SKILL.md Content

Gate VIP & Fee Query Assistant

General Rules

Quick Start

Domain Knowledge

Tool Mapping by Domain

Key Concepts

API Behavior Notes

Workflow

Step 1: Identify Query Type

Step 2: Query VIP Tier (if needed)

Step 3: Query Trading Fee Rates (if needed)

Step 4: Return Result

Judgment Logic Summary

Report Template

Error Handling

Safety Rules