gate-mcp 0.1.4 → 0.2.1

package/README.md

@@ -8,7 +8,7 @@ A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com
 
 ## Features
 
-- **86 tools** covering Spot, Futures, Delivery, Margin, Wallet, Account, Options, Earn, and Flash Swap APIs
+- **148 tools** covering Spot, Futures, Delivery, Margin, Wallet, Account, Options, Earn, Flash Swap, Unified, and Sub-Account APIs
 - **Zero config for public endpoints** — market data, tickers, order books work without any credentials
 - **Authenticated endpoints** — trading, wallet, and account tools activate automatically when `GATE_API_KEY` + `GATE_API_SECRET` env vars are set
 - **Testnet support** — set `GATE_BASE_URL` to use the testnet endpoint
@@ -73,11 +73,11 @@ A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com
 
 ## Available Tools
 
-### Spot (19 tools)
-`list_currencies`, `get_currency`, `list_currency_pairs`, `get_currency_pair`, `list_tickers`, `list_order_book`, `list_trades`, `list_candlesticks`, `get_fee`*, `list_spot_accounts`*, `list_orders`*, `create_order`*, `get_order`*, `cancel_order`*, `amend_order`*, `cancel_orders`*, `list_my_trades`*, `list_all_open_orders`*, `list_spot_price_triggered_orders`*
+### Spot (28 tools)
+`list_currencies`, `get_currency`, `list_currency_pairs`, `get_currency_pair`, `list_tickers`, `list_order_book`, `list_trades`, `list_candlesticks`, `get_fee`*, `list_spot_accounts`*, `list_spot_account_book`*, `list_orders`*, `create_order`*, `get_order`*, `cancel_order`*, `amend_order`*, `cancel_orders`*, `create_batch_orders`*, `cancel_batch_orders`*, `get_batch_spot_fee`*, `list_my_trades`*, `list_all_open_orders`*, `list_spot_price_triggered_orders`*, `create_spot_price_triggered_order`*, `get_spot_price_triggered_order`*, `cancel_spot_price_triggered_order`*, `cancel_spot_price_triggered_order_list`*, `countdown_cancel_all_spot`*
 
-### Futures (16 tools)
-`list_futures_contracts`, `get_futures_contract`, `list_futures_order_book`, `list_futures_candlesticks`, `list_futures_tickers`, `list_futures_funding_rate_history`, `list_futures_accounts`*, `list_positions`*, `get_position`*, `list_futures_orders`*, `create_futures_order`*, `get_futures_order`*, `cancel_futures_order`*, `amend_futures_order`*, `get_my_futures_trades`*, `list_position_close`*, `list_price_triggered_orders`*
+### Futures (37 tools)
+`list_futures_contracts`, `get_futures_contract`, `list_futures_order_book`, `list_futures_candlesticks`, `list_futures_tickers`, `list_futures_funding_rate_history`, `list_futures_trades`, `list_contract_stats`, `list_futures_premium_index`, `list_futures_accounts`*, `list_futures_account_book`*, `get_futures_fee`*, `list_positions`*, `get_position`*, `get_leverage`*, `update_position_leverage`*, `update_position_margin`*, `update_position_risk_limit`*, `list_futures_orders`*, `create_futures_order`*, `get_futures_order`*, `cancel_futures_order`*, `cancel_futures_orders`*, `amend_futures_order`*, `create_batch_futures_orders`*, `cancel_batch_futures_orders`*, `get_futures_orders_with_time_range`*, `get_my_futures_trades`*, `get_my_futures_trades_with_time_range`*, `list_position_close`*, `list_liquidates`*, `list_price_triggered_orders`*, `create_futures_price_triggered_order`*, `get_futures_price_triggered_order`*, `cancel_futures_price_triggered_order`*, `cancel_futures_price_triggered_order_list`*, `countdown_cancel_all_futures`*
 
 ### Delivery (11 tools)
 `list_delivery_contracts`, `get_delivery_contract`, `list_delivery_order_book`, `list_delivery_candlesticks`, `list_delivery_tickers`, `list_delivery_accounts`*, `list_delivery_positions`*, `list_delivery_orders`*, `create_delivery_order`*, `cancel_delivery_order`*, `get_my_delivery_trades`*
@@ -88,11 +88,11 @@ A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com
 ### Wallet (9 tools)
 `get_total_balance`*, `list_withdrawals`*, `list_deposits`*, `get_deposit_address`*, `transfer`*, `list_sub_account_balances`*, `get_trade_fee`*, `list_currency_chains`, `list_withdraw_status`*
 
-### Account (3 tools)
-`get_account_detail`*, `get_account_rate_limit`*, `get_debit_fee`*
+### Account (10 tools)
+`get_account_detail`*, `get_account_rate_limit`*, `get_debit_fee`*, `set_debit_fee`*, `get_account_main_keys`*, `list_stp_groups`*, `create_stp_group`*, `list_stp_group_users`*, `add_stp_group_users`*, `delete_stp_group_user`*
 
 ### Options (13 tools)
-`list_options_underlyings`, `list_options_expirations`, `list_options_contracts`, `list_options_order_book`, `list_options_tickers`, `list_options_candlesticks`, `list_options_account`*, `list_options_positions`*, `list_options_orders`*, `create_options_order`*, `cancel_options_order`*, `list_my_options_trades`*
+`list_options_underlyings`, `list_options_expirations`, `list_options_contracts`, `get_options_contract`, `list_options_order_book`, `list_options_tickers`, `list_options_candlesticks`, `list_options_account`*, `list_options_positions`*, `list_options_orders`*, `create_options_order`*, `cancel_options_order`*, `list_my_options_trades`*
 
 ### Earn (5 tools)
 `list_dual_investment_plans`, `list_dual_orders`*, `list_dual_balance`*, `list_structured_products`, `list_structured_orders`*
@@ -100,6 +100,12 @@ A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com
 ### Flash Swap (5 tools)
 `list_flash_swap_currency_pairs`, `preview_flash_swap_order`*, `create_flash_swap_order`*, `list_flash_swap_orders`*, `get_flash_swap_order`*
 
+### Unified Account (16 tools)
+`list_unified_accounts`*, `list_unified_currencies`*, `get_unified_mode`*, `set_unified_mode`*, `get_unified_risk_units`*, `get_unified_borrowable`*, `get_unified_transferable`*, `get_unified_estimate_rate`*, `list_unified_loans`*, `create_unified_loan`*, `list_unified_loan_records`*, `list_unified_loan_interest_records`*, `list_currency_discount_tiers`, `get_user_leverage_currency_setting`*, `set_user_leverage_currency_setting`*, `set_unified_collateral`*
+
+### Sub-Account (9 tools)
+`list_sub_accounts`*, `create_sub_account`*, `get_sub_account`*, `lock_sub_account`*, `unlock_sub_account`*, `list_sub_account_keys`*, `get_sub_account_key`*, `create_sub_account_keys`*, `delete_sub_account_key`*
+
 *\* Requires authentication (`GATE_API_KEY` + `GATE_API_SECRET`)*
 
 ## Development

package/dist/index.js

@@ -10,6 +10,8 @@ import { registerAccountTools } from './tools/account.js';
 import { registerOptionsTools } from './tools/options.js';
 import { registerEarnTools } from './tools/earn.js';
 import { registerFlashSwapTools } from './tools/flash_swap.js';
+import { registerUnifiedTools } from './tools/unified.js';
+import { registerSubAccountTools } from './tools/sub_account.js';
 const server = new McpServer({
     name: 'gate',
     version: '0.1.0',
@@ -23,6 +25,8 @@ registerAccountTools(server);
 registerOptionsTools(server);
 registerEarnTools(server);
 registerFlashSwapTools(server);
+registerUnifiedTools(server);
+registerSubAccountTools(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAEhC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuC5D"}
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0I5D"}

package/dist/tools/account.js

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { AccountApi } from 'gate-api';
 import { createClient, requireAuth } from '../client.js';
 import { textContent, errorContent } from '../utils.js';
@@ -32,5 +33,84 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
+    server.tool('set_debit_fee', 'Enable or disable GT debit fee (requires authentication)', { enabled: z.boolean().describe('true to pay fees with GT, false to disable') }, async ({ enabled }) => {
+        try {
+            requireAuth();
+            const { body } = await new AccountApi(createClient()).setDebitFee({ enabled });
+            return textContent(body ?? { success: true });
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('get_account_main_keys', 'Get main account API key info (requires authentication)', {}, async () => {
+        try {
+            requireAuth();
+            const { body } = await new AccountApi(createClient()).getAccountMainKeys();
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('list_stp_groups', 'List Self-Trade Prevention (STP) groups (requires authentication)', { name: z.string().optional().describe('Filter by group name') }, async ({ name }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (name)
+                opts.name = name;
+            const { body } = await new AccountApi(createClient()).listSTPGroups(opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('create_stp_group', 'Create a Self-Trade Prevention (STP) group (requires authentication)', { name: z.string().describe('STP group name') }, async ({ name }) => {
+        try {
+            requireAuth();
+            const { body } = await new AccountApi(createClient()).createSTPGroup({ name });
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('list_stp_group_users', 'List users in an STP group (requires authentication)', { stp_id: z.number().int().describe('STP group ID') }, async ({ stp_id }) => {
+        try {
+            requireAuth();
+            const { body } = await new AccountApi(createClient()).listSTPGroupsUsers(stp_id);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('add_stp_group_users', 'Add users to an STP group (requires authentication)', {
+        stp_id: z.number().int().describe('STP group ID'),
+        user_ids: z.array(z.number().int()).describe('List of user IDs to add'),
+    }, async ({ stp_id, user_ids }) => {
+        try {
+            requireAuth();
+            const { body } = await new AccountApi(createClient()).addSTPGroupUsers(stp_id, user_ids);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('delete_stp_group_user', 'Remove a user from an STP group (requires authentication)', {
+        stp_id: z.number().int().describe('STP group ID'),
+        user_id: z.number().int().describe('User ID to remove'),
+    }, async ({ stp_id, user_id }) => {
+        try {
+            requireAuth();
+            const { body } = await new AccountApi(createClient()).deleteSTPGroupUsers(stp_id, user_id);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
 }
 //# sourceMappingURL=account.js.map

package/dist/tools/account.js.map

@@ -1 +1 @@
-{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,iEAAiE,EACjE,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,gBAAgB,EAAE,CAAC;YACzE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IACzC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,kEAAkE,EAClE,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,mBAAmB,EAAE,CAAC;YAC5E,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IACzC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uDAAuD,EACvD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,WAAW,EAAE,CAAC;YACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACpE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IACzC,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"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"}

package/dist/tools/futures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"futures.d.ts","sourceRoot":"","sources":["../../src/tools/futures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqU5D"}
+{"version":3,"file":"futures.d.ts","sourceRoot":"","sources":["../../src/tools/futures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2vB5D"}

package/dist/tools/futures.js

@@ -302,5 +302,427 @@ export function registerFuturesTools(server) {
             return errorContent(e);
         }
     });
+    // ── Additional public tools ────────────────────────────────────────────────
+    server.tool('list_futures_trades', 'Get recent public trades for a futures contract', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        limit: z.number().int().optional(),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        to: z.number().optional().describe('End time (Unix timestamp)'),
+    }, async ({ settle, contract, limit, from, to }) => {
+        try {
+            const opts = {};
+            if (limit !== undefined)
+                opts.limit = limit;
+            if (from !== undefined)
+                opts.from = from;
+            if (to !== undefined)
+                opts.to = to;
+            const { body } = await new FuturesApi(createClient()).listFuturesTrades(settle, contract, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('list_contract_stats', 'Get contract statistics (open interest, long/short ratio, etc.)', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        interval: z.enum(['5m', '15m', '30m', '1h', '4h', '1d']).optional(),
+        limit: z.number().int().optional(),
+    }, async ({ settle, contract, from, interval, limit }) => {
+        try {
+            const opts = {};
+            if (from !== undefined)
+                opts.from = from;
+            if (interval)
+                opts.interval = interval;
+            if (limit !== undefined)
+                opts.limit = limit;
+            const { body } = await new FuturesApi(createClient()).listContractStats(settle, contract, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('list_futures_premium_index', 'Get premium index (mark price minus index price) history for a contract', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        to: z.number().optional().describe('End time (Unix timestamp)'),
+        interval: z.enum(['1m', '5m', '15m', '30m', '1h', '4h', '8h', '1d', '7d']).optional(),
+        limit: z.number().int().optional(),
+    }, async ({ settle, contract, from, to, interval, limit }) => {
+        try {
+            const opts = {};
+            if (from !== undefined)
+                opts.from = from;
+            if (to !== undefined)
+                opts.to = to;
+            if (interval)
+                opts.interval = interval;
+            if (limit !== undefined)
+                opts.limit = limit;
+            const { body } = await new FuturesApi(createClient()).listFuturesPremiumIndex(settle, contract, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    // ── Additional private tools ───────────────────────────────────────────────
+    server.tool('list_futures_account_book', 'Get futures account transaction/ledger history (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().optional().describe('Filter by contract'),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        to: z.number().optional().describe('End time (Unix timestamp)'),
+        limit: z.number().int().optional(),
+        offset: z.number().int().optional(),
+        type: z.string().optional().describe('Entry type filter e.g. dnw, pnl, fee, refr, fund'),
+    }, async ({ settle, contract, from, to, limit, offset, type }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            if (from !== undefined)
+                opts.from = from;
+            if (to !== undefined)
+                opts.to = to;
+            if (limit !== undefined)
+                opts.limit = limit;
+            if (offset !== undefined)
+                opts.offset = offset;
+            if (type)
+                opts.type = type;
+            const { body } = await new FuturesApi(createClient()).listFuturesAccountBook(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('get_futures_fee', 'Get futures trading fee rates (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().optional().describe('Filter by contract'),
+    }, async ({ settle, contract }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            const { body } = await new FuturesApi(createClient()).getFuturesFee(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('get_leverage', 'Get current leverage for a futures position (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+    }, async ({ settle, contract }) => {
+        try {
+            requireAuth();
+            const { body } = await new FuturesApi(createClient()).getLeverage(settle, contract, {});
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('update_position_leverage', 'Update leverage for a futures position (requires authentication) — always confirm the new leverage with the user before calling this tool', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        leverage: z.string().describe('New leverage value; 0 for cross-margin mode'),
+        cross_leverage_limit: z.string().optional().describe('Cross-margin leverage limit (only when leverage=0)'),
+    }, async ({ settle, contract, leverage, cross_leverage_limit }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (cross_leverage_limit)
+                opts.crossLeverageLimit = cross_leverage_limit;
+            const { body } = await new FuturesApi(createClient()).updatePositionLeverage(settle, contract, leverage, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('update_position_margin', 'Add or reduce margin for a futures position (requires authentication) — always confirm the amount with the user before calling this tool', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        change: z.string().describe('Margin change amount; positive to add, negative to reduce'),
+    }, async ({ settle, contract, change }) => {
+        try {
+            requireAuth();
+            const { body } = await new FuturesApi(createClient()).updatePositionMargin(settle, contract, change);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('update_position_risk_limit', 'Update the risk limit for a futures position (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        risk_limit: z.string().describe('New risk limit value'),
+    }, async ({ settle, contract, risk_limit }) => {
+        try {
+            requireAuth();
+            const { body } = await new FuturesApi(createClient()).updatePositionRiskLimit(settle, contract, risk_limit);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('cancel_futures_orders', 'Cancel all open futures orders (requires authentication) — always confirm with the user before calling this tool', {
+        settle: settleSchema,
+        contract: z.string().optional().describe('Only cancel orders for this contract'),
+        side: z.enum(['ask', 'bid']).optional().describe('Only cancel ask (sell) or bid (buy) orders'),
+    }, async ({ settle, contract, side }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            if (side)
+                opts.side = side;
+            const { body } = await new FuturesApi(createClient()).cancelFuturesOrders(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('create_batch_futures_orders', 'Create multiple futures orders in a single request (requires authentication) — always confirm the details with the user before calling this tool', {
+        settle: settleSchema,
+        orders: z.array(z.object({
+            contract: z.string(),
+            size: z.string().describe('Order size in contracts (negative = short)'),
+            price: z.string().describe('Order price; "0" for market'),
+            tif: z.enum(['gtc', 'ioc', 'poc', 'fok']).optional(),
+            reduce_only: z.boolean().optional(),
+            close: z.boolean().optional(),
+            text: z.string().optional(),
+        })).describe('Array of futures orders to create'),
+    }, async ({ settle, orders }) => {
+        try {
+            requireAuth();
+            const mapped = orders.map(o => {
+                const order = { contract: o.contract, size: o.size, price: o.price };
+                if (o.tif)
+                    order.tif = o.tif;
+                if (o.reduce_only !== undefined)
+                    order.reduceOnly = o.reduce_only;
+                if (o.close !== undefined)
+                    order.close = o.close;
+                if (o.text)
+                    order.text = o.text;
+                return order;
+            });
+            const { body } = await new FuturesApi(createClient()).createBatchFuturesOrder(settle, mapped, {});
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('cancel_batch_futures_orders', 'Cancel multiple futures orders by ID in a single request (requires authentication) — always confirm with the user before calling this tool', {
+        settle: settleSchema,
+        order_ids: z.array(z.string()).describe('Array of order IDs to cancel'),
+    }, async ({ settle, order_ids }) => {
+        try {
+            requireAuth();
+            const { body } = await new FuturesApi(createClient()).cancelBatchFutureOrders(settle, order_ids, {});
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('get_futures_orders_with_time_range', 'Get futures orders filtered by time range (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().optional().describe('Filter by contract'),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        to: z.number().optional().describe('End time (Unix timestamp)'),
+        limit: z.number().int().optional(),
+        offset: z.number().int().optional(),
+    }, async ({ settle, contract, from, to, limit, offset }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            if (from !== undefined)
+                opts.from = from;
+            if (to !== undefined)
+                opts.to = to;
+            if (limit !== undefined)
+                opts.limit = limit;
+            if (offset !== undefined)
+                opts.offset = offset;
+            const { body } = await new FuturesApi(createClient()).getOrdersWithTimeRange(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('get_my_futures_trades_with_time_range', 'Get personal futures trade history filtered by time range (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().optional().describe('Filter by contract'),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        to: z.number().optional().describe('End time (Unix timestamp)'),
+        limit: z.number().int().optional(),
+        offset: z.number().int().optional(),
+        role: z.enum(['maker', 'taker']).optional(),
+    }, async ({ settle, contract, from, to, limit, offset, role }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            if (from !== undefined)
+                opts.from = from;
+            if (to !== undefined)
+                opts.to = to;
+            if (limit !== undefined)
+                opts.limit = limit;
+            if (offset !== undefined)
+                opts.offset = offset;
+            if (role)
+                opts.role = role;
+            const { body } = await new FuturesApi(createClient()).getMyTradesWithTimeRange(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('list_liquidates', 'Get personal futures liquidation history (requires authentication)', {
+        settle: settleSchema,
+        contract: z.string().optional(),
+        from: z.number().optional().describe('Start time (Unix timestamp)'),
+        to: z.number().optional().describe('End time (Unix timestamp)'),
+        limit: z.number().int().optional(),
+        offset: z.number().int().optional(),
+    }, async ({ settle, contract, from, to, limit, offset }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            if (from !== undefined)
+                opts.from = from;
+            if (to !== undefined)
+                opts.to = to;
+            if (limit !== undefined)
+                opts.limit = limit;
+            if (offset !== undefined)
+                opts.offset = offset;
+            const { body } = await new FuturesApi(createClient()).listLiquidates(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('get_futures_price_triggered_order', 'Get details of a futures price-triggered order (requires authentication)', {
+        settle: settleSchema,
+        order_id: z.string().describe('Order ID'),
+    }, async ({ settle, order_id }) => {
+        try {
+            requireAuth();
+            const { body } = await new FuturesApi(createClient()).getPriceTriggeredOrder(settle, order_id);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('create_futures_price_triggered_order', 'Create a futures price-triggered order (requires authentication) — always confirm the details with the user before calling this tool', {
+        settle: settleSchema,
+        contract: z.string().describe('Contract name e.g. BTC_USDT'),
+        trigger_price: z.string().describe('Price that activates the order'),
+        trigger_rule: z.enum(['>=', '<=']).describe('>= fires when price rises to trigger_price; <= fires when it drops'),
+        trigger_expiration: z.number().int().optional().describe('Trigger expiration in seconds'),
+        order_size: z.number().describe('Order size (negative = short)'),
+        order_price: z.string().describe('Execution price; "0" for market'),
+        order_tif: z.enum(['gtc', 'ioc']).optional(),
+        order_reduce_only: z.boolean().optional(),
+        order_close: z.boolean().optional(),
+        order_text: z.string().optional(),
+    }, async ({ settle, contract, trigger_price, trigger_rule, trigger_expiration, order_size, order_price, order_tif, order_reduce_only, order_close, order_text }) => {
+        try {
+            requireAuth();
+            const trigger = { price: trigger_price, rule: trigger_rule === '>=' ? 1 : 2 };
+            if (trigger_expiration !== undefined)
+                trigger.expiration = trigger_expiration;
+            const initial = { contract, size: order_size, price: order_price };
+            if (order_tif)
+                initial.tif = order_tif;
+            if (order_reduce_only !== undefined)
+                initial.reduceOnly = order_reduce_only;
+            if (order_close !== undefined)
+                initial.close = order_close;
+            if (order_text)
+                initial.text = order_text;
+            const { body } = await new FuturesApi(createClient()).createPriceTriggeredOrder(settle, { initial, trigger });
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('cancel_futures_price_triggered_order', 'Cancel a single futures price-triggered order (requires authentication) — always confirm with the user before calling this tool', {
+        settle: settleSchema,
+        order_id: z.string().describe('Order ID'),
+    }, async ({ settle, order_id }) => {
+        try {
+            requireAuth();
+            const { body } = await new FuturesApi(createClient()).cancelPriceTriggeredOrder(settle, order_id);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('cancel_futures_price_triggered_order_list', 'Cancel all futures price-triggered orders (requires authentication) — always confirm with the user before calling this tool', {
+        settle: settleSchema,
+        contract: z.string().optional().describe('Only cancel orders for this contract'),
+    }, async ({ settle, contract }) => {
+        try {
+            requireAuth();
+            const opts = {};
+            if (contract)
+                opts.contract = contract;
+            const { body } = await new FuturesApi(createClient()).cancelPriceTriggeredOrderList(settle, opts);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
+    server.tool('countdown_cancel_all_futures', 'Set a countdown timer to cancel all futures orders (safety kill-switch, requires authentication)', {
+        settle: settleSchema,
+        timeout: z.number().int().describe('Countdown in seconds; 0 disables the timer'),
+        contract: z.string().optional().describe('Limit cancellation to this contract'),
+    }, async ({ settle, timeout, contract }) => {
+        try {
+            requireAuth();
+            const task = { timeout };
+            if (contract)
+                task.contract = contract;
+            const { body } = await new FuturesApi(createClient()).countdownCancelAllFutures(settle, task);
+            return textContent(body);
+        }
+        catch (e) {
+            return errorContent(e);
+        }
+    });
 }
 //# sourceMappingURL=futures.js.map