Skip to main content
DCA Bots provide programmable, parameterized automation APIs for creating, configuring, and executing dollar-cost-averaging trading strategies across supported connectors and markets. To help you apply it in your own Bots module design, here is a clean conceptual breakdown of the structure:

​
Entity Purpose

The DCA Bot entity schema, representing a stateful configuration + runtime status object for a single DCA bot instance. This object defines:
  • Bot configuration (strategy, volumes, limits, parameters)
  • Execution state (active deals, counters, timestamps)
  • Risk profile & automation settings (martingale, stop-loss, cooldown)
  • Metadata (name, account, creation info)

​
Logical Grouping

  1. Identity & Ownership
  • id, account_id, name, url_secret, account_name, type, pairs
  1. Status & Lifecycle
  • is_enabled, deletable?, created_at, updated_at
  • active_deals_count, active_safety_orders_count -finished_deals_count, finished_deals_profit_usd
  1. Strategy Definition
  • strategy (“long” / “short”)
  • strategy_list, close_strategy_list, safety_strategy_list
  • max_active_deals, max_safety_orders
  1. Order Sizding & Scaling
  • base_order_volume, safety_order_volume
  • martingale_volume_coefficient
  • martingale_step_coefficient
  1. Price & Risk Controls
  • stop_loss_percentage, stop_loss_type
  • take_profit, take_profit_type, take_profit_steps
  • trailing_enabled, trailing_deviation
  • min_price, max_price, and percentage variants
  1. Execution parameters
  • start_order_type (market/limit)
  • deal_start_delay_seconds
  • cooldown
  • allowed_deals_on_same_pair
  1. Performance & Optimization
  • profit_currency
  • reinvesting_percentage, risk_reduction_percentage
  • finished_deals_profit_usd, reinvested_volume_usd

​
Entity Model

{
  "id": 1,
  "account_id": 1,
  "is_enabled": false,
  "max_safety_orders": 4,
  "active_safety_orders_count": 1,
  "pairs": [
    "XXX_YYY"
  ],
  "strategy_list": [
    {
        "strategy": "nonstop",
        "options": {}
    }
  ],
  "close_strategy_list": [],
  "safety_strategy_list": [],
  "max_active_deals": 1,
  "active_deals_count": 0,
  "deletable?": true,
  "created_at": "2025-10-24T19:57:43.635Z",
  "updated_at": "2025-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
}