liquidate_live_algorithm
Close all open positions in a running live trading algorithm to exit the market and secure current holdings.
Instructions
Liquidate all positions in a live algorithm.
Args: project_id: ID of the project with the live algorithm to liquidate
Returns: Dictionary containing liquidation result
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- Core handler function for the 'liquidate_live_algorithm' tool, decorated with @mcp.tool(). It authenticates, prepares a POST request to QuantConnect's 'live/update/liquidate' endpoint with the project_id, and returns success/error responses based on the API result.
@mcp.tool() async def liquidate_live_algorithm(project_id: int) -> Dict[str, Any]: """ Liquidate all positions in a live algorithm. Args: project_id: ID of the project with the live algorithm to liquidate Returns: Dictionary containing liquidation result """ auth = get_auth_instance() if auth is None: return { "status": "error", "error": "QuantConnect authentication not configured. Use configure_auth() first.", } try: # Prepare request data request_data = {"projectId": project_id} # Make API request response = await auth.make_authenticated_request( endpoint="live/update/liquidate", method="POST", json=request_data ) # Parse response if response.status_code == 200: data = response.json() if data.get("success", False): return { "status": "success", "project_id": project_id, "message": f"Successfully liquidated live algorithm for project {project_id}", } else: # API returned success=false errors = data.get("errors", ["Unknown error"]) return { "status": "error", "error": "Live algorithm liquidation failed", "details": errors, "project_id": project_id, } elif response.status_code == 401: return { "status": "error", "error": "Authentication failed. Check your credentials and ensure they haven't expired.", } else: return { "status": "error", "error": f"API request failed with status {response.status_code}", "response_text": ( response.text[:500] if hasattr(response, "text") else "No response text" ), } except Exception as e: return { "status": "error", "error": f"Failed to liquidate live algorithm: {str(e)}", "project_id": project_id, } - quantconnect_mcp/main.py:51-51 (registration)Invocation of register_live_tools(mcp) in the main entry point, which defines and registers the liquidate_live_algorithm tool (along with other live tools) using FastMCP decorators.
register_live_tools(mcp)