DCA Bot entity
A DCA Bot entity contains the full operational configuration, order sizing rules, safety ladders, risk protection, strategy triggers, and performance statistics for a Dollar Cost Averaging bot on Quentrade.
Attributes
61Unique Quentrade ID for this DCA Bot entity.
Unique Quentrade ID for the connected exchange account entity.
User-defined custom label for the exchange account (e.g., 'My Binance Spot').
Name assigned to the DCA Bot.
Indicates whether the DCA Bot is currently enabled (true) or disabled (false).
Bot type based on pair count: Bot::SingleBot (single trading pair) or Bot::MultiBot (multiple trading pairs).
List of trading pairs configured for this bot in Quentrade format (e.g., ['BNFCR_1INCHUSDT'], ['USDT_BTC', 'USDT_ETH']).
Trading direction used by the bot: long (buy low, sell high) or short (sell high, buy back low).
Order execution type used to initiate new deals: limit or market.
Currency in which profit is accumulated: quote_currency or base_currency.
ISO 8601 timestamp representing when the DCA Bot entity was created.
ISO 8601 timestamp of the most recent bot configuration update.
Indicates whether this DCA Bot entity can be safely deleted (true) or has active dependencies (false).
Unique secret code used for sharing and copying this DCA Bot configuration.
The initial order volume executed when opening a new deal.
Unit measurement for base order size: quote_currency, base_currency, or percent (of account balance).
The starting volume for the first Safety Order in the averaging ladder.
Unit measurement for Safety Order size: quote_currency, base_currency, or percent.
Maximum total number of Safety Orders allowed per deal.
Number of active Safety Orders placed simultaneously in the exchange orderbook at any given time.
Price deviation percentage from initial entry required to trigger the first Safety Order.
Multiplier applied to increase order volume for each consecutive Safety Order (e.g., 2.0 doubles volume).
Multiplier applied to increase price step distance between each consecutive Safety Order.
Direct array of custom Safety Order steps (alternative to Martingale multipliers). Example: [deviation: -1.1, size: 10].
Target profit percentage required to close a deal in profit.
Calculation method for Take Profit: base (percentage of base order volume) or total (percentage of total accumulated deal volume).
Indicates whether Trailing Take Profit is active to follow upward price trends.
Percentage deviation allowed from peak price before trailing take profit market order triggers.
Configuration of multi-step Take Profit targets allowing partial deal closure at progressive price levels.
Minimum profit percentage threshold required to complete a deal when using specific close strategies.
Basis for minimum profit calculation (quote_currency, base_currency, or percent).
Maximum allowable loss percentage before deal is closed (0.0 means Stop Loss is disabled).
Action executed when Stop Loss triggers: stop_loss (close deal only) or stop_loss_and_disable_bot (close deal and turn off bot).
Indicates whether a countdown timer delay is enforced before executing Stop Loss to avoid false wick triggers.
Duration in seconds for the Stop Loss confirmation timeout.
Trailing Stop Loss status: automatically adjusts Stop Loss price upward as position moves in profit.
Percentage of loss reduction applied across deal averaging steps.
Maximum number of simultaneous active deals this DCA Bot can manage (default: 1).
Current number of deals actively in progress for this bot.
Number of concurrent deals allowed on the exact same pair (applicable only to Bot::MultiBot).
Target number of completed deals after which the bot automatically disables itself (is_enabled: false).
Tracks completed deals count towards disable_after_deals_count threshold.
Delay in seconds before executing the first order of a newly triggered deal.
Mandatory cooldown period in seconds between closing a deal and opening a new deal on the same pair.
Maximum lifespan of an open deal in seconds, after which it automatically closes.
Array of deal-opening signal conditions (e.g., nonstop, RSI-7, TradingView webhook, MACD).
Array of custom deal-closing signal conditions.
Array of conditions required before executing safety orders.
Absolute minimum asset price required to allow opening a new deal.
Absolute maximum asset price allowable to open a new deal.
Minimum 24h price change percentage required to open a deal (MultiBot only).
Maximum 24h price change percentage allowable to open a deal (MultiBot only).
Minimum 24h trading volume in BTC equivalent required for a trading pair to be traded.
Leverage margin model: not_specified (spot), cross (entire balance collateral), or isolated (deal-specific margin).
Custom leverage multiplier applied to futures margin positions (e.g., '10').
Percentage of realized deal profit automatically reinvested into subsequent deal base orders.
Cumulative USD volume reinvested into bot order sizing from historical profits.
Total realized cumulative net profit in USD from all completed deals.
Total number of deals successfully closed by this DCA Bot.
Current total unrealized PnL in USD across all active deals.
Full array of Deal entities currently active and managed by this DCA Bot.