place_order_with_trailing_stop
Execute cryptocurrency trades on Bybit with trailing stop loss protection to automatically adjust stop levels as market prices move, managing risk while capturing profit potential.
Instructions
Place order with trailing stop loss
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | Category (linear, inverse) | |
| symbol | Yes | Symbol (e.g., ETHUSDT) | |
| side | Yes | Order side (Buy, Sell) | |
| orderType | Yes | Order type (Market, Limit) | |
| qty | Yes | Order quantity | |
| price | No | Order price (for limit orders) | |
| trailingStop | Yes | Trailing stop distance | |
| activePrice | No | Price at which trailing stop activates (optional) | |
| positionIdx | No | Position index (optional, auto-detected if not provided) | |
| timeInForce | No | Time in force (GTC, IOC, FOK) | |
| orderLinkId | No | Order link ID (optional) |
Implementation Reference
- src/bybit-service.ts:186-273 (handler)The core handler function that executes the place_order_with_trailing_stop tool. It auto-detects position mode for futures, builds the order request with trailing stop parameters, and calls the Bybit API.async placeOrderWithTrailingStop( category: string, symbol: string, side: 'Buy' | 'Sell', orderType: 'Market' | 'Limit', qty: string, price?: string, trailingStop?: string, activePrice?: string, positionIdx?: string, timeInForce?: string, orderLinkId?: string ): Promise<BybitResponse<OrderResponse> | { error: string }> { // Auto-detect position mode for futures trading if positionIdx not provided if (['linear', 'inverse'].includes(category) && !positionIdx) { console.log('Auto-detecting position mode for futures trading...'); // Check current positions to determine position mode const currentPositions = await this.getPositions(category, symbol); let detectedPositionIdx = '0'; // Default to one-way mode if ('result' in currentPositions && currentPositions.result.list.length > 0) { // Check if we have separate long/short positions (hedge mode) const positions = currentPositions.result.list; const hasLongPosition = positions.some(p => p.side === 'Buy'); const hasShortPosition = positions.some(p => p.side === 'Sell'); if (hasLongPosition || hasShortPosition) { // Hedge mode detected - use appropriate position index detectedPositionIdx = side === 'Buy' ? '1' : '2'; console.log(`Hedge mode detected, using positionIdx: ${detectedPositionIdx}`); } else { console.log('One-way mode detected, using positionIdx: 0'); } } else { console.log('No existing positions, defaulting to one-way mode (positionIdx: 0)'); } positionIdx = detectedPositionIdx; } // Validate positionIdx for futures trading (after auto-detection) if (['linear', 'inverse'].includes(category)) { if (!positionIdx || !['0', '1', '2'].includes(positionIdx)) { return { error: 'Invalid positionIdx. Use 0 for one-way mode, 1 for long position, or 2 for short position in hedge mode' }; } } // Build order request with trailing stop const orderRequest: any = { category, symbol, side, orderType, qty, timeInForce: timeInForce || (orderType === 'Market' ? 'IOC' : 'GTC'), orderFilter: 'Order', isLeverage: 0 }; // Add price for limit orders if (orderType === 'Limit' && price) { orderRequest.price = price; } // Add trailing stop parameters if (trailingStop) { orderRequest.trailingStop = trailingStop; // Add active price if provided (price at which trailing stop activates) if (activePrice) { orderRequest.activePrice = activePrice; } } // Add position index for futures if (['linear', 'inverse'].includes(category)) { orderRequest.positionIdx = positionIdx; } // Add order link ID if provided if (orderLinkId) { orderRequest.orderLinkId = orderLinkId; } return this.makeBybitRequest('/v5/order/create', 'POST', orderRequest); }
- src/index.ts:638-690 (schema)The input schema defining parameters and validation for the place_order_with_trailing_stop tool in the MCP server.name: 'place_order_with_trailing_stop', description: 'Place order with trailing stop loss', inputSchema: { type: 'object', properties: { category: { type: 'string', description: 'Category (linear, inverse)', }, symbol: { type: 'string', description: 'Symbol (e.g., ETHUSDT)', }, side: { type: 'string', description: 'Order side (Buy, Sell)', }, orderType: { type: 'string', description: 'Order type (Market, Limit)', }, qty: { type: 'string', description: 'Order quantity', }, price: { type: 'string', description: 'Order price (for limit orders)', }, trailingStop: { type: 'string', description: 'Trailing stop distance', }, activePrice: { type: 'string', description: 'Price at which trailing stop activates (optional)', }, positionIdx: { type: 'string', description: 'Position index (optional, auto-detected if not provided)', }, timeInForce: { type: 'string', description: 'Time in force (GTC, IOC, FOK)', }, orderLinkId: { type: 'string', description: 'Order link ID (optional)', }, }, required: ['category', 'symbol', 'side', 'orderType', 'qty', 'trailingStop'], }, },
- src/index.ts:1046-1068 (registration)The switch case registration that handles incoming calls to place_order_with_trailing_stop by invoking the BybitService handler.case 'place_order_with_trailing_stop': { const result = await this.bybitService.placeOrderWithTrailingStop( typedArgs.category, typedArgs.symbol, typedArgs.side, typedArgs.orderType, typedArgs.qty, typedArgs.price, typedArgs.trailingStop, typedArgs.activePrice, typedArgs.positionIdx, typedArgs.timeInForce, typedArgs.orderLinkId ); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }