v13

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-0815390371.2 KB

Bot Orchestration

Deploy V2 Controllers

Deploy a V2 strategy with controllers by generating the script config and creating the instance. This endpoint simplifies the deployment process for V2 controller strategies.

Args: deployment: V2ControllerDeployment configuration docker_manager: Docker service dependency

Returns: Dictionary with deployment response and generated configuration details

Raises: HTTPException: 500 if deployment fails

post/bot-orchestration/deploy-v2-controllers

Request body

instance_namestring required

Unique name for the bot instance

credentials_profilestring required

Name of the credentials profile to use

controllers_configstring[] required

List of controller configuration files to use (without .yml extension)

max_global_drawdown_quotenumber nullable

Maximum allowed global drawdown in quote usually USDT

max_controller_drawdown_quotenumber nullable

Maximum allowed per-controller drawdown in quote usually USDT

imagestring

Docker image for the Hummingbot instance

script_configstring nullable

Generated script configuration file name

headlessboolean

Run in headless mode (no UI)

Response

Successful Response

{"stackTrail":"paths:/bot-orchestration/deploy-v2-controllers:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}