Gate Flash Swap Query

General Rules

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

Query Gate Flash Swap related information, including supported currency pair lists, swap amount limits, order history, and single order details.

Trigger Conditions

This Skill is activated when the user's request matches any of the following:

• Mentions "flash swap" combined with queries about pairs, limits, orders, or history
• Asks which currencies support flash swap or instant exchange
• Asks about minimum/maximum swap amounts or limits
• Requests flash swap order history or specific order details
• Uses keywords: "flash swap", "instant swap", "quick exchange", "swap pairs", "swap limits"

Quick Start

Common query examples:

1. List supported pairs: "Show me all flash swap supported pairs"
2. Check swap limits: "I want to swap BTC for USDT, what is the minimum and maximum amount?"
3. View order history: "Show me my recent flash swap orders"

Domain Knowledge

Flash Swap is a quick crypto exchange service provided by Gate. Users can instantly convert one cryptocurrency to another at the real-time exchange rate without placing orders and waiting for matching.

Key concepts:

• Currency Pair: A supported exchange combination for flash swap, e.g. BTC_USDT represents the exchange between BTC and USDT
• Sell Currency: The currency the user pays
• Buy Currency: The currency the user receives
• Sell Min/Max Amount: The minimum and maximum quantity allowed for the sell currency in a single swap
• Buy Min/Max Amount: The minimum and maximum quantity allowed for the buy currency in a single swap
• Order Status: 1 = success, 2 = failed

API Response Field Name Mapping:

The API returns camelCase field names. Map them to the following when extracting data:

Data type note: order_id is returned as a string in API responses, not an integer. Always treat it as a string when extracting from results.

Workflow

Step 1: Identify User Intent

Analyze the user's request to determine which flash swap query to perform.

Intent classification:

Key data to extract:

• intent: "list_pairs" / "check_limits" / "list_orders" / "get_order"
• parameters: any filter conditions mentioned by the user (currency, status, order_id, etc.)

Step 2: Query All Flash Swap Currency Pairs (if intent = list_pairs)

Call cex_fc_list_fc_currency_pairs with:

• No parameters required

Large result set warning: This query may return 34,000+ rows. Do NOT dump the entire list to the user. Instead:

1. Summarize the total count of available pairs
2. Show the first 20 pairs as a sample table
3. Ask the user if they want to filter by a specific currency for a more targeted result

Key data to extract:

• currency_pairs: full list of supported flash swap trading pairs
• sell_currency: available sell currencies
• buy_currency: available buy currencies
• Total count of available pairs

Step 3: Validate Currency Support and Check Swap Limits (if intent = check_limits)

If the user did not specify a currency, prompt them to provide one before proceeding. Suggest popular currencies (e.g. BTC, ETH, USDT) as examples.

Call cex_fc_list_fc_currency_pairs with:

• currency (required): the currency symbol to check, e.g. "BTC", "USDT"

Key data to extract:

• currency_pairs: pairs containing the specified currency
• sell_min_amount: minimum sell quantity per swap
• sell_max_amount: maximum sell quantity per swap
• buy_min_amount: minimum buy quantity per swap
• buy_max_amount: maximum buy quantity per swap

If the returned list is empty, the specified currency does not support flash swap.

Step 4: Query Flash Swap Order History (if intent = list_orders)

Before calling the API, validate the status parameter if provided. Only 1 (success) and 2 (failed) are valid values. If the user provides any other value, inform them that status only accepts 1 or 2, and do not proceed with the API call.

Call cex_fc_list_fc_orders with:

• status (optional, integer): order status filter, 1 = success, 2 = failed. Must be validated before calling — only 1 or 2 are accepted
• sell_currency (optional, string): filter by sell currency
• buy_currency (optional, string): filter by buy currency
• limit (optional, integer): number of records per page
• page (optional, integer): page number

Key data to extract:

• orders: list of flash swap orders
• order_id (string): order identifier
• sell_currency / buy_currency: currencies involved
• sell_amount / buy_amount: amounts
• price: exchange rate
• status: order status (1=success, 2=failed)
• create_time: order creation time

Step 5: Query Single Flash Swap Order Details (if intent = get_order)

Call cex_fc_get_fc_order with:

• order_id (required, string): the order ID to query

If the API returns a 404 error, the order does not exist. Inform the user that the specified order ID was not found, and suggest verifying the order ID or querying the order list first.

Key data to extract:

• order_id (string): order identifier
• sell_currency / buy_currency: currencies involved
• sell_amount / buy_amount: amounts
• price: exchange rate
• status: order status
• create_time: order creation time

Step 6: Format and Present Results

Format the query results and present them to the user using the appropriate Report Template based on the intent.

Key data to extract:

• Formatted report based on the query type

Error Handling

Safety Rules

• This Skill only performs query operations; it does not execute any order placement or fund changes
• Must not expose user's API Key, Secret, or other sensitive information in output
• Amounts in query results should be displayed as-is without modification

Judgment Logic Summary

Report Template

Timestamp format: All {timestamp} placeholders below use ISO 8601 format: YYYY-MM-DD HH:mm:ss UTC (e.g. 2026-03-11 14:30:00 UTC). Use the current time when generating the report.

Flash Swap Currency Pairs Report

## Gate Flash Swap Supported Pairs

**Query Time**: {timestamp}
**Filter**: {currency filter or "None"}

| Pair | Sell Currency | Buy Currency |
|------|---------------|--------------|
| {pair} | {sell_currency} | {buy_currency} |

Total: {total} pairs.

Flash Swap Currency Limit Report

## Gate Flash Swap Limit Check

**Query Time**: {timestamp}
**Currency**: {currency}

| Pair | Sell Currency | Sell Min | Sell Max | Buy Currency | Buy Min | Buy Max |
|------|---------------|----------|----------|--------------|---------|---------|
| {pair} | {sell_currency} | {sell_min_amount} | {sell_max_amount} | {buy_currency} | {buy_min_amount} | {buy_max_amount} |

Total: {total} pairs available for {currency}.

Flash Swap Order List Report

## Gate Flash Swap Order List

**Query Time**: {timestamp}
**Filters**: Status={status}, Sell Currency={sell_currency}, Buy Currency={buy_currency}

| Order ID | Sell | Sell Amount | Buy | Buy Amount | Status | Created At |
|----------|------|-------------|-----|------------|--------|------------|
| {order_id} | {sell_currency} | {sell_amount} | {buy_currency} | {buy_amount} | {status_text} | {create_time} |

Total: {total} records.

Flash Swap Order Detail Report

## Gate Flash Swap Order Details

**Query Time**: {timestamp}

| Field | Value |
|-------|-------|
| Order ID | {order_id} |
| Sell Currency | {sell_currency} |
| Sell Amount | {sell_amount} |
| Buy Currency | {buy_currency} |
| Buy Amount | {buy_amount} |
| Exchange Rate | {price} |
| Order Status | {status_text} |
| Created At | {create_time} |