Create DCA Bot

POST

/ver1/bots/create_bot

Permission: BOTS_WRITE

Security: SIGNED

Creates a new DCA Bot

---

Body Parameters

namestringrequired

User-defined name of the DCA Bot. If not specified, the system will generate a default name automatically.

Characters: [1 ... 200]

account_idintegerrequired

ID of the exchange account entity where you want to creat DCA Bot.

pairsstringrequired

Trading pair(s) in 3Commas format. If a single pair is passed, a SingleBot is created. If two or more pairs are passed, a MultiBot is created.

Use endpoint All market pairs to get value for parameter.

More attributes

max_active_dealsinteger

strategystring

profit_currencystring

base_order_volume_typenumberrequired

base_order_volumenumberrequired

start_order_typestring

strategy_listarray[json]required

leverage_typestring

leverage_custom_valuenumber

trailing_enabledboolean

trailing_deviationnumber

take_profit_typestringrequired

take_profitnumberrequired

take_profit_stepsarray[object]

close_strategy_listarray[json]

min_profit_typestring

min_profit_percentagenumber

reinvesting_percentagestring

stop_loss_percentagenumber

stop_loss_typestring

tsl_enabledboolean

sl_to_breakeven_enabledboolean

sl_to_breakeven_datajson

stop_loss_timeout_enabledboolean

stop_loss_timeout_in_secondsinteger

risk_reduction_percentagestringrequired

safety_order_step_percentagenumberrequired

safety_order_volume_typestring

safety_order_volumenumberrequired

safety_strategy_listarray[json]

max_safety_ordersintegerrequired

active_safety_orders_countintegerrequired

martingale_volume_coefficientnumberrequired

martingale_step_coefficientnumberrequired

min_volume_btc_24hnumber

min_pricenumber

max_pricenumber

deal_start_delay_secondsinteger

cooldownnumber

disable_after_deals_countinteger

allowed_deals_on_same_pairinteger

min_price_percentagenumber

max_price_percentagenumber

close_deals_timeoutinteger

Additional Information

leverage_custom_value

Use endpoints Currency rates and limits with leverage data to check available value for this parameter.

---

take_profit_steps

When using multiple steps for Take Profit, each step should be represented as an object with the following properties:

• amount_percentage
• profit_percentage

Keep in mind, you can create a maximum of 4 targets, allocating 100% of your position volume is allocated across them

---

{
  "take_profit_steps": [
    {
      "amount_percentage": 50,
      "profit_percentage": 10
    },
    {
      "amount_percentage": 50,
      "profit_percentage": 20
    }
  ] 
}

---

strategy list, close_strategy_list, safety_strategy_list

The data strategies are used to populate the strategy_list and close_strategy_list parameters. You can retrieve the full list of strategies available for this DCA Bot through the Available strategy list for bot endpoint.

Below are several examples demonstrating how to fill these parameters with strategy data:

Manual signals

[
  {
    "strategy": "manual"
  }
]

or

[]

Non-stop

[
  {
    "strategy": "nonstop"
  },
  {
    "options": {}
  }
]

It's using only for 1 pair bot.

TradingView

[
  {
    "options": {
      "time": "5m",
      "type": "buy_or_strong_buy"
    },
    "strategy": "trading_view"
  }
]

RSI

[
  {
    "options": {
      "time": "5m",
      "points": 30,
      "trigger_condition": "less",
      "time_period": 7
    },
    "strategy": "rsi"
  }
] 

Example Request

POST

/ver1/bots/create_bot

{
  "account_id": 32833909,
  "name": "name DCA Bot",
  "pairs": "BNFCR_1INCHUSDT",
  "strategy_list": [
    {
      "options": {},
      "strategy": "nonstop"
    }
  ],
  "base_order_volume": "100.0",
  "max_safety_orders": 4,
  "take_profit": null,
  "take_profit_steps": [
    {
      "amount_percentage": 50,
      "profit_percentage": 10
    },
    {
      "amount_percentage": 50,
      "profit_percentage": 20
    }
  ],
  "close_deals_timeout": "60",
  "active_safety_orders_count": 1,
  "safety_order_volume": "30.0",
  "safety_order_step_percentage": "1.0",
  "take_profit_type": "total",
  "min_profit_type": null,
  "martingale_volume_coefficient": "2",
  "martingale_step_coefficient": "4.0"
}

Response Parameter

If successful, the response includes a update copy of DCA Bot entity.

Example Responses

201 Created

{
  "id": 15564828,
  "account_id": 32833909,
  "is_enabled": false,
  "max_safety_orders": 4,
  "active_safety_orders_count": 1,
  "pairs": [
    "BNFCR_1INCHUSDT"
  ],
  "strategy_list": [
    {
      "strategy": "nonstop",
      "options": {}
    }
  ],
  "close_strategy_list": [],
  "safety_strategy_list": [],
  "max_active_deals": 1,
  "active_deals_count": 0,
  "deletable?": true,
  "created_at": "2024-10-24T19:57:43.635Z",
  "updated_at": "2024-10-24T19:57:43.635Z",
  "trailing_enabled": null,
  "tsl_enabled": false,
  "deal_start_delay_seconds": null,
  "stop_loss_timeout_enabled": false,
  "stop_loss_timeout_in_seconds": 0,
  "disable_after_deals_count": null,
  "deals_counter": null,
  "allowed_deals_on_same_pair": null,
  "easy_form_supported": false,
  "close_deals_timeout": null,
  "url_secret": "...",
  "take_profit_steps": [],
  "name": "test 24 oct",
  "take_profit": "2.0",
  "min_profit_percentage": null,
  "base_order_volume": "15.0",
  "safety_order_volume": "30.0",
  "safety_order_step_percentage": "1.0",
  "take_profit_type": "total",
  "min_profit_type": null,
  "type": "Bot::SingleBot",
  "martingale_volume_coefficient": "2.0",
  "martingale_step_coefficient": "4.0",
  "stop_loss_percentage": "0.0",
  "cooldown": "0",
  "btc_price_limit": "0.0",
  "strategy": "long",
  "min_volume_btc_24h": "0.0",
  "profit_currency": "quote_currency",
  "min_price": null,
  "max_price": null,
  "stop_loss_type": "stop_loss",
  "safety_order_volume_type": "quote_currency",
  "base_order_volume_type": "quote_currency",
  "account_name": "My Binance",
  "trailing_deviation": "0.2",
  "finished_deals_profit_usd": "0.0",
  "finished_deals_count": "0",
  "leverage_type": "not_specified",
  "leverage_custom_value": null,
  "start_order_type": "limit",
  "active_deals_usd_profit": "0.0",
  "reinvesting_percentage": null,
  "risk_reduction_percentage": null,
  "reinvested_volume_usd": null,
  "min_price_percentage": null,
  "max_price_percentage": null
}

400 Bad Request

{
  "error": "record_invalid",
  "error_description": "Invalid parameters",
  "error_attributes": {
    "name": [
      "is missing"
    ]
  }
}

404 Not Found

{
  "error": "not_found",
  "error_description": "Not Found"
}