PUT

/api/v1/bots/dca/

Permission: BOTS_WRITESecurity: BEARER_JWT

Updates configuration settings of an existing DCA Bot. You can modify order sizes, scaling factors, profit targets, and risk parameters while preserving historical trade data.

See DCA Bot Entity for full attribute definitions

DCA Bot Entity

Path Parameters

iduuid required

Unique UUID identifier of the DCA Bot entity to update.

Body Parameters

namestring

Updated label for the DCA Bot.

base_order_sizenumber

Updated base order size in quote currency.

safety_order_sizenumber

Updated safety order size in quote currency.

safety_order_step_scalenumber

Updated step scale multiplier.

safety_order_volume_scalenumber

Updated volume scale multiplier.

price_deviationnumber

Updated percentage price deviation between safety orders.

max_safety_ordersinteger

Updated maximum safety orders count.

take_profit_pctnumber

Updated take profit target percentage.

stop_loss_enabledboolean

Enables or disables stop loss.

stop_loss_pctnumber

Updated stop loss percentage.

dev_edit_dca_bot.additional_info.title

dev_edit_dca_bot.additional_info.leverage_title

dev_edit_dca_bot.additional_info.leverage_desc

Currency Rates & Leverage Limits

dev_edit_dca_bot.additional_info.tp_steps_title

dev_edit_dca_bot.additional_info.tp_steps_desc

take_profit_steps.json

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

dev_edit_dca_bot.additional_info.strategy_title

dev_edit_dca_bot.additional_info.strategy_desc

Available Strategy List

Example Request

edit_dca_bot_request.json

PUT /api/v1/bots/dca/{id}

{
  "name": "BTC/USDT Aggressive DCA",
  "base_order_size": 150,
  "safety_order_size": 75,
  "safety_order_step_scale": 1.4,
  "safety_order_volume_scale": 1.4,
  "price_deviation": 1.2,
  "max_safety_orders": 6,
  "take_profit_pct": 3,
  "stop_loss_enabled": true,
  "stop_loss_pct": 6
}

Example Responses

Returns the updated DCA Bot entity object.

edit_dca_bot_200.json

200 OK

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "user_id": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
  "connection_id": "b3e0c4a1-8d2a-4a5f-b567-9c123456789a",
  "name": "BTC/USDT Aggressive DCA",
  "exchange": "binance",
  "pair": "BTC/USDT",
  "market_type": "spot",
  "strategy": "Long",
  "start_order_type": "limit",
  "base_order_size": 150,
  "safety_order_size": 75,
  "safety_order_step_scale": 1.4,
  "safety_order_volume_scale": 1.4,
  "quote_currency": "USDT",
  "price_deviation": 1.2,
  "max_safety_orders": 6,
  "max_active_trades": 1,
  "cooldown_between_trades": 60,
  "take_profit_pct": 3,
  "tp_type": "percentage",
  "tp_trailing": true,
  "tp_trailing_pct": 0.2,
  "stop_loss_enabled": true,
  "stop_loss_pct": 6,
  "sl_type": "stop_loss",
  "start_condition": "asap",
  "status": "stopped",
  "active_trades": 0,
  "total_profit": 142.5,
  "total_trades": 12,
  "created_at": "2026-08-20T10:15:30.000Z",
  "updated_at": "2026-08-20T11:40:00.000Z"
}

PREVIOUS Create DCA Bot NEXTEnable DCA Bot