binance-futures-mcp 1.0.8__py3-none-any.whl → 1.0.9__py3-none-any.whl

{binance_futures_mcp-1.0.8.dist-info → binance_futures_mcp-1.0.9.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: binance-futures-mcp
-Version: 1.0.8
-Summary: A Model Context Protocol server for Binance Futures API with comprehensive trading tools
+Version: 1.0.9
+Summary: A Model Context Protocol server for Binance Futures API with comprehensive trading tools including TP/SL management
 Home-page: https://github.com/alexcandrabersiva/bin-mcp
 Author: Binance MCP Server
 License-Expression: MIT

binance_futures_mcp-1.0.9.dist-info/RECORD

@@ -0,0 +1,9 @@
+binance_futures_mcp-1.0.9.dist-info/licenses/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
+binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
+binance_mcp/__main__.py,sha256=_9DBrtv0PAvjLjCqKk_cMfGtkqSUOcmU6HeQKFjuFMQ,214
+binance_mcp/server.py,sha256=NlgfZhT3si4y0UiGxRZE92rAehcWYFGKymMGgkQMKIo,62387
+binance_futures_mcp-1.0.9.dist-info/METADATA,sha256=vdWuCJtPFPqjiEgVBBCNVl-jEWW_cwnCD38Sk2zwDlk,11872
+binance_futures_mcp-1.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+binance_futures_mcp-1.0.9.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
+binance_futures_mcp-1.0.9.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
+binance_futures_mcp-1.0.9.dist-info/RECORD,,

binance_mcp/server.py

@@ -50,7 +50,7 @@ class BinanceClient:
             timeout=timeout,
             connector=connector,
             headers={
-                'User-Agent': 'binance-mcp-server/1.0.8',
+                'User-Agent': 'binance-mcp-server/1.0.9',
                 'Content-Type': 'application/x-www-form-urlencoded'
             }
         )
@@ -253,6 +253,7 @@ class BinanceMCPServer:
                             "symbol": {"type": "string", "description": "Trading pair symbol"},
                             "side": {"type": "string", "description": "Order side ('BUY' or 'SELL')"},
                             "type": {"type": "string", "description": "Order type ('MARKET', 'LIMIT', 'STOP', 'STOP_MARKET', 'TRAILING_STOP_MARKET', etc)"},
+                            "order_type": {"type": "string", "description": "Alternative parameter name for 'type' (for backward compatibility)"},
                             "quantity": {"type": "number", "description": "Order quantity"},
                             "price": {"type": "number", "description": "Order price (for LIMIT orders)"},
                             "stopPrice": {"type": "number", "description": "Stop price (for STOP orders)"},
@@ -271,7 +272,11 @@ class BinanceMCPServer:
                             "quantity_precision": {"type": "integer", "description": "Quantity precision for validation"},
                             "price_precision": {"type": "integer", "description": "Price precision for validation"}
                         },
-                        "required": ["symbol", "side", "type"]
+                        "required": ["symbol", "side"],
+                        "anyOf": [
+                            {"required": ["type"]},
+                            {"required": ["order_type"]}
+                        ]
                     }
                 ),
                 Tool(
@@ -408,6 +413,59 @@ class BinanceMCPServer:
                         "required": ["symbol"]
                     }
                 ),
+                Tool(
+                    name="modify_order",
+                    description="Modify an existing order (price, quantity, etc.)",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {
+                            "symbol": {"type": "string", "description": "Trading pair symbol"},
+                            "order_id": {"type": "integer", "description": "Order ID to modify"},
+                            "side": {"type": "string", "description": "Order side ('BUY' or 'SELL')"},
+                            "quantity": {"type": "number", "description": "New order quantity"},
+                            "price": {"type": "number", "description": "New order price"},
+                            "priceMatch": {"type": "string", "description": "Price match mode (OPPONENT, OPPONENT_5, OPPONENT_10, OPPONENT_20, QUEUE, QUEUE_5, QUEUE_10, QUEUE_20)"}
+                        },
+                        "required": ["symbol", "order_id", "side", "quantity", "price"]
+                    }
+                ),
+                Tool(
+                    name="add_tp_sl_to_position",
+                    description="Add Take Profit and/or Stop Loss orders to existing position",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {
+                            "symbol": {"type": "string", "description": "Trading pair symbol"},
+                            "position_side": {"type": "string", "description": "Position side ('BOTH', 'LONG', 'SHORT'). Default 'BOTH' for One-way mode"},
+                            "take_profit_price": {"type": "number", "description": "Take profit price (optional)"},
+                            "stop_loss_price": {"type": "number", "description": "Stop loss price (optional)"},
+                            "quantity": {"type": "number", "description": "Quantity for TP/SL orders (optional, defaults to position size)"},
+                            "tp_order_type": {"type": "string", "description": "Take profit order type ('LIMIT', 'TAKE_PROFIT_MARKET'). Default 'TAKE_PROFIT_MARKET'"},
+                            "sl_order_type": {"type": "string", "description": "Stop loss order type ('STOP_MARKET', 'STOP'). Default 'STOP_MARKET'"},
+                            "time_in_force": {"type": "string", "description": "Time in force for LIMIT TP orders (GTC, IOC, FOK). Default 'GTC'"}
+                        },
+                        "required": ["symbol"]
+                    }
+                ),
+                Tool(
+                    name="place_bracket_order",
+                    description="Place a position with automatic Take Profit and Stop Loss orders",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {
+                            "symbol": {"type": "string", "description": "Trading pair symbol"},
+                            "side": {"type": "string", "description": "Order side ('BUY' or 'SELL')"},
+                            "quantity": {"type": "number", "description": "Order quantity"},
+                            "entry_price": {"type": "number", "description": "Entry price (for LIMIT entry order, optional for MARKET)"},
+                            "take_profit_price": {"type": "number", "description": "Take profit price"},
+                            "stop_loss_price": {"type": "number", "description": "Stop loss price"},
+                            "entry_order_type": {"type": "string", "description": "Entry order type ('MARKET', 'LIMIT'). Default 'MARKET'"},
+                            "positionSide": {"type": "string", "description": "Position side ('BOTH', 'LONG', 'SHORT')"},
+                            "timeInForce": {"type": "string", "description": "Time in force for LIMIT orders (GTC, IOC, FOK). Default 'GTC'"}
+                        },
+                        "required": ["symbol", "side", "quantity", "take_profit_price", "stop_loss_price"]
+                    }
+                ),
 
                 # Trading Configuration Tools
                 Tool(
@@ -681,6 +739,14 @@ class BinanceMCPServer:
                         # Filter out precision parameters and pass through all other parameters directly
                         params = {k: v for k, v in arguments.items() if v is not None and k not in ["quantity_precision", "price_precision"]}
                         
+                        # Handle backward compatibility for order_type parameter
+                        if "order_type" in params:
+                            params["type"] = params.pop("order_type")
+                        
+                        # Check if type parameter is present
+                        if "type" not in params:
+                            raise ValueError("Missing required parameter 'type'. Please specify the order type (e.g., 'MARKET', 'LIMIT', 'STOP', etc.)")
+                        
                         # Validate mandatory parameters based on order type
                         order_type = params.get("type")
                         if order_type == "LIMIT":
@@ -797,6 +863,173 @@ class BinanceMCPServer:
                                 order_params["positionSide"] = current_position_side
                         
                         result = await client._make_request("POST", "/fapi/v1/order", order_params, "TRADE")
+                    elif name == "modify_order":
+                        # Modify existing order
+                        params = {
+                            "symbol": arguments["symbol"],
+                            "orderId": arguments["order_id"],
+                            "side": arguments["side"],
+                            "quantity": arguments["quantity"],
+                            "price": arguments["price"]
+                        }
+                        if "priceMatch" in arguments:
+                            params["priceMatch"] = arguments["priceMatch"]
+                        result = await client._make_request("PUT", "/fapi/v1/order", params, "TRADE")
+                    elif name == "add_tp_sl_to_position":
+                        # Add TP/SL to existing position
+                        symbol = arguments["symbol"]
+                        position_side = arguments.get("position_side", "BOTH")
+                        take_profit_price = arguments.get("take_profit_price")
+                        stop_loss_price = arguments.get("stop_loss_price")
+                        quantity = arguments.get("quantity")
+                        tp_order_type = arguments.get("tp_order_type", "TAKE_PROFIT_MARKET")
+                        sl_order_type = arguments.get("sl_order_type", "STOP_MARKET")
+                        time_in_force = arguments.get("time_in_force", "GTC")
+                        
+                        if not take_profit_price and not stop_loss_price:
+                            raise ValueError("At least one of take_profit_price or stop_loss_price must be provided")
+                        
+                        # Get current position to determine side and quantity
+                        position_params = {"symbol": symbol}
+                        positions = await client._make_request("GET", "/fapi/v2/positionRisk", position_params, "USER_DATA")
+                        
+                        position_to_hedge = None
+                        for pos in positions:
+                            if pos["symbol"] == symbol and float(pos["positionAmt"]) != 0:
+                                if position_side == "BOTH" or pos["positionSide"] == position_side:
+                                    position_to_hedge = pos
+                                    break
+                        
+                        if not position_to_hedge:
+                            raise ValueError(f"No open position found for {symbol} with position side {position_side}")
+                        
+                        position_amt = float(position_to_hedge["positionAmt"])
+                        current_position_side = position_to_hedge["positionSide"]
+                        
+                        # Determine order side (opposite of position)
+                        if position_amt > 0:  # Long position
+                            tp_sl_side = "SELL"
+                        else:  # Short position  
+                            tp_sl_side = "BUY"
+                            position_amt = abs(position_amt)
+                        
+                        order_quantity = quantity if quantity else position_amt
+                        results = []
+                        
+                        # Place Take Profit order
+                        if take_profit_price:
+                            tp_params = {
+                                "symbol": symbol,
+                                "side": tp_sl_side,
+                                "type": tp_order_type,
+                                "quantity": order_quantity,
+                                "reduceOnly": "true"
+                            }
+                            
+                            if current_position_side != "BOTH":
+                                tp_params["positionSide"] = current_position_side
+                            
+                            if tp_order_type == "TAKE_PROFIT_MARKET":
+                                tp_params["stopPrice"] = take_profit_price
+                            else:  # LIMIT
+                                tp_params["price"] = take_profit_price
+                                tp_params["timeInForce"] = time_in_force
+                            
+                            tp_result = await client._make_request("POST", "/fapi/v1/order", tp_params, "TRADE")
+                            results.append({"type": "take_profit", "result": tp_result})
+                        
+                        # Place Stop Loss order
+                        if stop_loss_price:
+                            sl_params = {
+                                "symbol": symbol,
+                                "side": tp_sl_side,
+                                "type": sl_order_type,
+                                "quantity": order_quantity,
+                                "reduceOnly": "true"
+                            }
+                            
+                            if current_position_side != "BOTH":
+                                sl_params["positionSide"] = current_position_side
+                            
+                            if sl_order_type == "STOP_MARKET":
+                                sl_params["stopPrice"] = stop_loss_price
+                            else:  # STOP
+                                sl_params["price"] = stop_loss_price
+                                sl_params["stopPrice"] = stop_loss_price
+                                sl_params["timeInForce"] = time_in_force
+                            
+                            sl_result = await client._make_request("POST", "/fapi/v1/order", sl_params, "TRADE")
+                            results.append({"type": "stop_loss", "result": sl_result})
+                        
+                        result = results
+                    elif name == "place_bracket_order":
+                        # Place entry order with TP/SL
+                        symbol = arguments["symbol"]
+                        side = arguments["side"]
+                        quantity = arguments["quantity"]
+                        entry_price = arguments.get("entry_price")
+                        take_profit_price = arguments["take_profit_price"]
+                        stop_loss_price = arguments["stop_loss_price"]
+                        entry_order_type = arguments.get("entry_order_type", "MARKET")
+                        position_side = arguments.get("positionSide", "BOTH")
+                        time_in_force = arguments.get("timeInForce", "GTC")
+                        
+                        results = []
+                        
+                        # Place entry order
+                        entry_params = {
+                            "symbol": symbol,
+                            "side": side,
+                            "type": entry_order_type,
+                            "quantity": quantity
+                        }
+                        
+                        if position_side != "BOTH":
+                            entry_params["positionSide"] = position_side
+                        
+                        if entry_order_type == "LIMIT":
+                            if not entry_price:
+                                raise ValueError("entry_price is required for LIMIT orders")
+                            entry_params["price"] = entry_price
+                            entry_params["timeInForce"] = time_in_force
+                        
+                        entry_result = await client._make_request("POST", "/fapi/v1/order", entry_params, "TRADE")
+                        results.append({"type": "entry", "result": entry_result})
+                        
+                        # Determine TP/SL side (opposite of entry)
+                        tp_sl_side = "SELL" if side == "BUY" else "BUY"
+                        
+                        # Place Take Profit order
+                        tp_params = {
+                            "symbol": symbol,
+                            "side": tp_sl_side,
+                            "type": "TAKE_PROFIT_MARKET",
+                            "quantity": quantity,
+                            "stopPrice": take_profit_price,
+                            "reduceOnly": "true"
+                        }
+                        if position_side != "BOTH":
+                            tp_params["positionSide"] = position_side
+                        
+                        tp_result = await client._make_request("POST", "/fapi/v1/order", tp_params, "TRADE")
+                        results.append({"type": "take_profit", "result": tp_result})
+                        
+                        # Place Stop Loss order
+                        sl_params = {
+                            "symbol": symbol,
+                            "side": tp_sl_side,
+                            "type": "STOP_MARKET",
+                            "quantity": quantity,
+                            "stopPrice": stop_loss_price,
+                            "reduceOnly": "true"
+                        }
+                        if position_side != "BOTH":
+                            sl_params["positionSide"] = position_side
+                        
+                        sl_result = await client._make_request("POST", "/fapi/v1/order", sl_params, "TRADE")
+                        results.append({"type": "stop_loss", "result": sl_result})
+                        
+                        result = results
                     
                     # Trading Configuration Tools
                     elif name == "change_leverage":
@@ -916,7 +1149,7 @@ async def main():
             write_stream, 
             InitializationOptions(
                 server_name="binance-futures-mcp-server",
-                server_version="1.0.8",
+                server_version="1.0.9",
                 capabilities={
                     "tools": {}
                 }

binance_futures_mcp-1.0.8.dist-info/RECORD

@@ -1,9 +0,0 @@
-binance_futures_mcp-1.0.8.dist-info/licenses/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
-binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
-binance_mcp/__main__.py,sha256=_9DBrtv0PAvjLjCqKk_cMfGtkqSUOcmU6HeQKFjuFMQ,214
-binance_mcp/server.py,sha256=RNLNWe_lF24HKti32MBPFo3rsACBWZ6yF02C3owtDB4,48057
-binance_futures_mcp-1.0.8.dist-info/METADATA,sha256=32MQTpog3BDvt0acBdZpD6dJyURTEGG54nYqVHa9qNA,11845
-binance_futures_mcp-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-binance_futures_mcp-1.0.8.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
-binance_futures_mcp-1.0.8.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
-binance_futures_mcp-1.0.8.dist-info/RECORD,,