setLeverage
Adjust leverage levels for futures trading positions on Bitget to manage risk exposure and trading strategy execution.
Instructions
Set leverage for futures trading
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Trading pair symbol | |
| leverage | Yes | Leverage value (1-125) |
Implementation Reference
- src/server.ts:440-453 (handler)MCP tool handler for setLeverage: parses input using schema, calls BitgetRestClient.setLeverage, and returns success messagecase 'setLeverage': { const { symbol, leverage } = SetLeverageSchema.parse(args); const success = await this.bitgetClient.setLeverage(symbol, leverage); return { content: [ { type: 'text', text: success ? `Leverage set to ${leverage}x for ${symbol}` : `Failed to set leverage for ${symbol}`, }, ], } as CallToolResult; }
- src/types/mcp.ts:88-91 (schema)Zod input schema for setLeverage tool validationexport const SetLeverageSchema = z.object({ symbol: z.string().describe('Trading pair symbol'), leverage: z.number().min(1).max(125).describe('Leverage value (1-125)') });
- src/api/rest-client.ts:784-797 (helper)BitgetRestClient method implementing the setLeverage logic by calling Bitget's REST API endpointasync setLeverage(symbol: string, leverage: number): Promise<boolean> { // Remove _UMCBL suffix for v2 API (like in candles) const cleanSymbol = symbol.replace('_UMCBL', ''); const response = await this.request<any>('POST', '/api/v2/mix/account/set-leverage', { symbol: cleanSymbol, productType: 'USDT-FUTURES', marginCoin: 'USDT', // Required parameter! leverage: leverage.toString(), holdSide: 'long' }, true); return response.code === '00000'; }
- src/server.ts:217-227 (registration)Tool registration/definition in the ListTools response, including name, description, and input schemaname: 'setLeverage', description: 'Set leverage for futures trading', inputSchema: { type: 'object', properties: { symbol: { type: 'string', description: 'Trading pair symbol' }, leverage: { type: 'number', minimum: 1, maximum: 125, description: 'Leverage value (1-125)' } }, required: ['symbol', 'leverage'] }, },