Skip to main content
POST
/
bot-orchestration
/
deploy-v2-controllers
Deploy V2 Controllers
curl --request POST \
  --url http://localhost:8000/bot-orchestration/deploy-v2-controllers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instance_name": "<string>",
  "credentials_profile": "<string>",
  "controllers_config": [
    "<string>"
  ],
  "max_global_drawdown_quote": 123,
  "max_controller_drawdown_quote": 123,
  "image": "hummingbot/hummingbot:latest",
  "script_config": "<string>",
  "headless": false
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Configuration for deploying a bot with controllers

instance_name
string
required

Unique name for the bot instance

credentials_profile
string
required

Name of the credentials profile to use

controllers_config
string[]
required

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

max_global_drawdown_quote
number | null

Maximum allowed global drawdown in quote usually USDT

max_controller_drawdown_quote
number | null

Maximum allowed per-controller drawdown in quote usually USDT

image
string
default:hummingbot/hummingbot:latest

Docker image for the Hummingbot instance

script_config
string | null

Generated script configuration file name

headless
boolean
default:false

Run in headless mode (no UI)

Response

Successful Response