gate-exchange-spot

Gate Spot Trading Assistant

Execute integrated operations for Gate spot workflows, including:

• Buy and account queries (balance checks, asset valuation, minimum order checks)
• Smart monitoring and trading (automatic price-condition limit orders, no take-profit/stop-loss support)
• Order management and amendment (price updates, cancellations, fill verification, cost-basis checks, swaps)

Domain Knowledge

Tool Mapping by Domain

| Group | Tool Calls (jsonrpc: call.method) | |------|------| | Account and balances | get_spot_accounts | | Place/cancel/amend orders | create_spot_order, cancel_all_spot_orders, cancel_spot_order, amend_spot_order | | Open orders and fills | list_spot_orders, list_spot_my_trades | | Market data | get_spot_tickers, get_spot_order_book, get_spot_candlesticks | | Trading rules | get_currency, get_currency_pair | | Fees | get_wallet_fee |

Key Trading Rules

• Use BASE_QUOTE format for trading pairs, for example BTC_USDT.
• Check quote-currency balance first before buy orders (for example USDT).
• Amount-based buys must satisfy min_quote_amount (commonly 10U).
• Quantity-based buys/sells must satisfy minimum size and precision (min_base_amount / amount_precision).
• Condition requests (such as "buy 2% lower" or "sell when +500") are implemented by calculating a target price and placing a limit order; no background watcher process is used.
• Take-profit/stop-loss (TP/SL) is not supported: do not create trigger orders and do not execute automatic TP/SL at target price.

Market Order Parameter Extraction Rules (Mandatory)

When calling create_spot_order with type=market, fill amount by side:

| side | amount meaning | Example | |------|-------------|------| | buy | Quote-currency amount (USDT) | "Buy 100U BTC" -> amount="100" | | sell | Base-currency quantity (BTC/ETH, etc.) | "Sell 0.01 BTC" -> amount="0.01" |

Pre-check before execution:

• buy market order: verify quote-currency balance can cover amount (USDT).
• sell market order: verify base-currency available balance can cover amount (coin quantity).

Workflow

When the user asks for any spot trading operation, follow this sequence.

Step 1: Identify Task Type

Classify the request into one of these six categories:

1. Buy (market/limit/full-balance buy)
2. Sell (full-position sell/conditional sell)
3. Account query (total assets, balance checks, tradability checks)
4. Order management (list open orders, amend, cancel)
5. Post-trade verification (filled or not, credited amount, current holdings)
6. Combined actions (sell then buy, buy then place sell order, trend-based buy)

Step 2: Extract Parameters and Run Pre-checks

Extract key fields:

• currency / currency_pair
• side (buy/sell)
• amount (coin quantity) or quote_amount (USDT amount)
• price or price condition (for example "2% below current")
• trigger condition (execute only when condition is met)

When type=market, normalize parameters as:

• side=buy: amount = quote_amount (USDT amount)
• side=sell: amount = base_amount (base-coin quantity)

Pre-check order:

1. Trading pair/currency tradability status
2. Minimum order amount/size and precision
3. Available balance sufficiency
4. User condition satisfaction (for example "buy only below 60000")

Step 3: Final User Confirmation Before Any Order Placement (Mandatory)

Before every create_spot_order, always provide an Order Draft first, then wait for explicit confirmation.

Required execution flow:

1. Send order draft (no trading call yet)
2. Wait for explicit user approval
3. Only after approval, submit the real order
4. Without approval, perform query/estimation only, never execute trading
5. Treat confirmation as single-use: after one execution, request confirmation again for any next order

Required confirmation fields:

• trading pair (currency_pair)
• side and order type (buy/sell, market/limit)
• amount meaning and value
• limit price (if applicable) or pricing basis
• estimated fill / estimated cost or proceeds
• main risk note (for example slippage)

Recommended draft wording:

• Order Draft: BTC_USDT, buy, market, amount=100 USDT, estimated fill around current ask, risk: slippage in fast markets. Reply "Confirm order" to place it.

Allowed confirmation responses (examples):

• Confirm order, Confirm, Proceed, Yes, place it

Hard blocking rules (non-bypassable):

• NEVER call create_spot_order unless the user explicitly confirms in the immediately previous turn.
• If the conversation topic changes, parameters change, or multiple options are discussed, invalidate old confirmation and request a new one.
• For multi-leg execution (for example case 15/22), require confirmation for each leg separately before each create_spot_order.

If user confirmation is missing, ambiguous, or negative:

• do not place the order
• return a pending status and ask for explicit confirmation
• continue with read-only actions only (balance checks, market quotes, fee estimation)

Step 4: Call Tools by Scenario

Use only the minimal tool set required for the task:

• Balance and available funds: get_spot_accounts
• Rule validation: get_currency_pair
• Live price and moves: get_spot_tickers
• Order placement: create_spot_order
• Cancel/amend: cancel_all_spot_orders / cancel_spot_order / amend_spot_order
• Open order query: list_spot_orders (use status=open)
• Fill verification: list_spot_my_trades

Step 5: Return Actionable Result and Status

The response must include:

• Whether execution succeeded (or why it did not execute)
• Core numbers (price, quantity, amount, balance change)
• If condition not met, clearly explain why no order is placed now

Case Routing Map (1-25)

A. Buy and Account Queries (1-8)

| Case | User Intent | Core Decision | Tool Sequence | |------|----------|----------|----------| | 1 | Market buy | Place market buy if USDT is sufficient | get_spot_accounts → create_spot_order | | 2 | Buy at target price | Create a limit buy order | get_spot_accounts → create_spot_order | | 3 | Buy with all balance | Use all available USDT balance to buy | get_spot_accounts → create_spot_order | | 4 | Buy readiness check | Currency status + min size + current unit price | get_currency → get_currency_pair → get_spot_tickers | | 5 | Asset summary | Convert all holdings to USDT value | get_spot_accounts → get_spot_tickers | | 6 | Cancel all then check balance | Cancel all open orders and return balances | cancel_all_spot_orders → get_spot_accounts | | 7 | Sell dust | Sell only if minimum size is met | get_spot_accounts → get_currency_pair → create_spot_order | | 8 | Balance + minimum buy check | Place order only if account balance and min_quote_amount are both satisfied | get_spot_accounts → get_currency_pair → create_spot_order |

B. Smart Monitoring and Trading (9-16)

| Case | User Intent | Core Decision | Tool Sequence | |------|----------|----------|----------| | 9 | Buy 2% lower | Place limit buy at current price -2% | get_spot_tickers → create_spot_order | | 10 | Sell at +500 | Place limit sell at current price +500 | get_spot_tickers → create_spot_order | | 11 | Buy near today's low | Buy only if current price is near 24h low | get_spot_tickers → create_spot_order | | 12 | Sell on 5% drop request | Calculate target drop price and place sell limit order | get_spot_tickers → create_spot_order | | 13 | Buy top gainer | Auto-pick highest 24h gainer and buy | get_spot_tickers → create_spot_order | | 14 | Buy larger loser | Compare BTC/ETH daily drop and buy the bigger loser | get_spot_tickers → create_spot_order | | 15 | Buy then place sell | Market buy, then place sell at +2% reference price | create_spot_order → create_spot_order | | 16 | Fee estimate | Estimate total cost from fee rate and live price | get_wallet_fee → `get_spot_ticke