place-futures-market-order
Execute a futures market order on supported cryptocurrency exchanges. Specify exchange, trading pair, side, amount, and authentication details to place buy or sell orders directly through the CCXT MCP Server.
Instructions
Place a futures market order
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount to buy/sell | |
| apiKey | Yes | API key for authentication | |
| exchange | Yes | Exchange ID (e.g., binance, bybit) | |
| marketType | No | Market type (default: future) | future |
| params | No | Additional order parameters | |
| passphrase | No | Passphrase for authentication (required for some exchanges like KuCoin) | |
| secret | Yes | API secret for authentication | |
| side | Yes | Order side: buy or sell | |
| symbol | Yes | Trading pair symbol (e.g., BTC/USDT) |
Implementation Reference
- src/tools/private.ts:190-217 (handler)The main handler function for the 'place-futures-market-order' tool. It retrieves the exchange instance with credentials, logs the action, places a market order using ex.createOrder, and returns the order details or error.
}, async ({ exchange, symbol, side, amount, params, apiKey, secret, passphrase, marketType }) => { try { return await rateLimiter.execute(exchange, async () => { // Get futures exchange const ex = getExchangeWithCredentials(exchange, apiKey, secret, marketType, passphrase); // Place futures market order log(LogLevel.INFO, `Placing futures ${side} market order for ${symbol} on ${exchange} (${marketType}), amount: ${amount}`); const order = await ex.createOrder(symbol, 'market', side, amount, undefined, params || {}); return { content: [{ type: "text", text: JSON.stringify(order, null, 2) }] }; }); } catch (error) { log(LogLevel.ERROR, `Error placing futures market order: ${error instanceof Error ? error.message : String(error)}`); return { content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } }); - src/tools/private.ts:181-189 (schema)Zod schema defining the input parameters for the tool, including exchange, symbol, side, amount, optional params and passphrase, API credentials, and marketType.
exchange: z.string().describe("Exchange ID (e.g., binance, bybit)"), symbol: z.string().describe("Trading pair symbol (e.g., BTC/USDT)"), side: z.enum(['buy', 'sell']).describe("Order side: buy or sell"), amount: z.number().positive().describe("Amount to buy/sell"), params: z.record(z.any()).optional().describe("Additional order parameters"), apiKey: z.string().describe("API key for authentication"), secret: z.string().describe("API secret for authentication"), passphrase: z.string().optional().describe("Passphrase for authentication (required for some exchanges like KuCoin)"), marketType: z.enum(["future", "swap"]).default("future").describe("Market type (default: future)") - src/tools/private.ts:180-217 (registration)The server.tool call that registers the 'place-futures-market-order' tool with its name, description, input schema, and handler function.
server.tool("place-futures-market-order", "Place a futures market order", { exchange: z.string().describe("Exchange ID (e.g., binance, bybit)"), symbol: z.string().describe("Trading pair symbol (e.g., BTC/USDT)"), side: z.enum(['buy', 'sell']).describe("Order side: buy or sell"), amount: z.number().positive().describe("Amount to buy/sell"), params: z.record(z.any()).optional().describe("Additional order parameters"), apiKey: z.string().describe("API key for authentication"), secret: z.string().describe("API secret for authentication"), passphrase: z.string().optional().describe("Passphrase for authentication (required for some exchanges like KuCoin)"), marketType: z.enum(["future", "swap"]).default("future").describe("Market type (default: future)") }, async ({ exchange, symbol, side, amount, params, apiKey, secret, passphrase, marketType }) => { try { return await rateLimiter.execute(exchange, async () => { // Get futures exchange const ex = getExchangeWithCredentials(exchange, apiKey, secret, marketType, passphrase); // Place futures market order log(LogLevel.INFO, `Placing futures ${side} market order for ${symbol} on ${exchange} (${marketType}), amount: ${amount}`); const order = await ex.createOrder(symbol, 'market', side, amount, undefined, params || {}); return { content: [{ type: "text", text: JSON.stringify(order, null, 2) }] }; }); } catch (error) { log(LogLevel.ERROR, `Error placing futures market order: ${error instanceof Error ? error.message : String(error)}`); return { content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } });