manage_bots
Deploy, monitor, and control advanced multi-strategy trading bots with centralized risk management. Manage bot status, logs, start/stop controllers, and update runtime configurations in real-time.
Instructions
Manage controller-based bots: deploy, monitor, get logs, control execution, and modify runtime configs.
⚠️ NOTE: For most trading strategies (grid, DCA, position trading), use manage_executors() instead.
Only use bots when the user EXPLICITLY asks for "bot" deployment or needs advanced features like
multi-strategy bots with centralized risk management.
Actions:
- deploy: Deploy a new bot with controller configurations (requires bot_name + controllers_config)
- status: Get status of all active bots (no additional params needed)
- logs: Get detailed logs for a specific bot (requires bot_name)
- stop_bot: Stop and archive a bot forever (requires bot_name)
- stop_controllers: Stop specific controllers in a bot (requires bot_name + controller_names)
- start_controllers: Start/resume specific controllers (requires bot_name + controller_names)
- get_config: View current configs of a running bot (requires bot_name)
- update_config: Modify config of a controller INSIDE a running bot in real-time (requires bot_name + config_name + config_data)
Args:
action: Action to perform on bots.
bot_name: Name of the bot (required for deploy, logs, stop_bot, stop/start_controllers, get_config, update_config).
controllers_config: List of controller config names (required for deploy).
account_name: Account name for deployment (default: master_account).
max_global_drawdown_quote: Maximum global drawdown in quote currency (deploy only).
max_controller_drawdown_quote: Maximum per-controller drawdown in quote currency (deploy only).
image: Docker image for deployment (default: "hummingbot/hummingbot:latest").
log_type: Type of logs to retrieve for 'logs' action ('error', 'general', 'all').
limit: Maximum log entries for 'logs' action (default: 50, max: 1000).
search_term: Search term to filter logs by message content (logs only).
controller_names: List of controller names (required for stop/start_controllers).
config_name: Name of the config to update (required for update_config).
config_data: New configuration data (required for update_config). Must include 'controller_type' and 'controller_name'.
confirm_override: Required True if overwriting existing config in a running bot (update_config only).Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| bot_name | No | ||
| controllers_config | No | ||
| account_name | No | master_account | |
| max_global_drawdown_quote | No | ||
| max_controller_drawdown_quote | No | ||
| image | No | hummingbot/hummingbot:latest | |
| log_type | No | all | |
| limit | No | ||
| search_term | No | ||
| controller_names | No | ||
| config_name | No | ||
| config_data | No | ||
| confirm_override | No |