Sign In · Sign Up Free

🇬🇧 English 🇫🇷 Français 🇩🇪 Deutsch 🇪🇸 Español 🇮🇹 Italiana 🇧🇷 Português 🇯🇵 日本語 🇨🇳 中文 🇰🇷 한국인 🇸🇦 عربي 🇷🇺 Русский

Docs

CtrlK

Home Pricing Knowledgebase Docs Blog

Documentation for

General Bot & Trading Configuration

Getting Started & Core Setup What is application.yaml in MagicTradeBot? Which settings must be configured before running MagicTradeBot for the first time? Can MagicTradeBot run with default application.yaml settings? What is the recommended setup for demo mode vs live trading? How do I verify that my application configuration is loaded correctly?

Exchange Configuration Which exchanges are officially supported by MagicTradeBot? What happens if I configure an unsupported exchange? How do I change the exchange used by MagicTradeBot? What is the difference between One-Way Mode and Hedge Mode? Why does Bybit only support One-Way Mode in MagicTradeBot? What risks occur if my exchange position mode is misconfigured?

API Keys & Security Best Practices Where should I store exchange API keys for maximum security? Should I whitelist my server IP for exchange API keys? What API permissions are required for MagicTradeBot to work? Why should withdrawal permissions never be enabled for bot API keys? Can MagicTradeBot work without storing API keys in application.yaml? How do environment variables override API keys in the config file?

Demo Mode & Testing What is Demo Mode in MagicTradeBot? Does Demo Mode place real trades on the exchange? Can I test DCA, signals, and risk management in Demo Mode? When should I disable Demo Mode and switch to live trading?

Debugging & Logging What does Debug Mode do in MagicTradeBot? When should Debug Mode be enabled? Does Debug Mode affect trading performance or speed? Is Debug Mode safe to use in production environments?

Licensing & Activation Where do I enter my MagicTradeBot license key? What happens if my license key is missing or invalid? Can I run MagicTradeBot without a license key? How do I upgrade or extend my MagicTradeBot license?

Deployment & Production Best Practices How should I configure MagicTradeBot when running in Docker or cloud servers?

Trading Configuration What is TradingMode and how does it affect bot behavior? What is the purpose of the Profile setting? How do BaseCurrency and SyncSymbolsOnStartup work? How is InitialTradeAmount used? How does dynamic trade sizing work? What are MinBalance and MaxBalance? How do MarginMode and Leverage affect futures trading? What do SetLeverageStartup and SetMaxLeverage do? How do MaxOpenTrades and cooldowns help risk management?

Intelligent Decision-Making Engine

Core Concepts What is the Intelligent Decision-Making Engine in MagicTradeBot? How does the decision engine manage trades after entry? What problems does the Intelligent Decision Engine solve? Is the Decision-Making Engine required for auto trading? Can the engine be disabled without affecting trade entries?

Templates & Market Adaptation What are decision templates in MagicTradeBot? How does MagicTradeBot automatically select a decision template? What factors determine market direction (Bullish, Bearish, Neutral)? Can multiple templates be active at the same time? What happens if no template matches current market conditions?

Time-Based Trade Management What is Minimum Hold Time and why is it important? How does Maximum Hold Time work for long and short trades? Can trades be closed automatically after a fixed time? How does DCA affect maximum trade duration?

Take Profit Logic (Including Partial TP) What are Take Profit rules in the decision engine? What is partial take profit and how does it work? Can MagicTradeBot scale out of positions gradually? How are multiple take profit rules prioritized? What is the difference between market and limit TP orders? What is the difference between Fixed TP and Smart TP? How do I enable Smart TP rules? What do TrailingGapPer and MinProfitLock do? How does UseDynamicGap automatically adjust trailing profit? Can I configure multiple Smart TP rules per trade? How does Partial Take Profit interact with Smart TP?

Stop-Loss & Threshold Rules What are threshold rules in the Intelligent Decision Engine? How do time-based stop-loss rules work? What is dynamic stop-loss and when should it be used? Can stop-loss behavior change over time within the same trade? What happens if both stop-loss and take-profit conditions are met?

Candle-Based Exit Rules What are candle-based exit rules in MagicTradeBot? How do opposite candle exits work? Can candle exits trigger partial position closures? Should candle exit rules be used in trending markets?

Direction-Aware Trade Handling Can MagicTradeBot apply different rules to long and short trades? Why are longs and shorts managed differently during pumps or crashes? How does the engine behave during extreme volatility?

Emergency & Global Safety Controls What is Emergency Close in the decision engine? When should Emergency Close be enabled? What is the global maximum loss protection feature? How does MaxLossBeforeForceClose protect the account? Can global safety rules override template-level rules? How do MaxProfitReached and MaxLossReached work?

Advanced Behavior & Optimization How does the engine behave during high signal density periods? Can the decision engine reduce overtrading automatically? Is the decision engine suitable for scalping strategies? How does the engine adapt to calm vs volatile markets? What are best practices for tuning decision templates safely?

Testing, Debugging & Best Practices Should decision templates be tested in demo mode first? What are common mistakes when configuring decision templates? Can decision templates be reused across different strategies? How do I debug unexpected trade exits caused by the decision engine?

Global Intelligent Safety Layer What is MinProfitToEnableTP and when should it be used? Does global safety apply across all strategies and symbols?

Dollar Cost Averaging

DCA Fundamentals What is DCA (Dollar Cost Averaging) in crypto trading? How does DCA work in MagicTradeBot? What problem does DCA solve in volatile markets? Is DCA a risk management strategy by itself? When should DCA be avoided?

Enabling & Using DCA How do I enable or disable DCA in MagicTradeBot? Can DCA be used with auto trading and signals? Does DCA work with manual trading in MagicTradeBot? Does DCA apply to both long and short positions?

Order Scaling & Exposure What does max_orders mean in DCA settings? How many DCA orders should I use for live trading? What happens when the maximum number of DCA orders is reached? What is size_multiplier and how does it affect risk? Is size_multiplier the same as martingale? What are safe size_multiplier values for beginners?

Price Deviation & Entry Logic What does price_deviation_percent control in DCA? How is the next DCA entry price calculated? Should price deviation be tighter or wider in volatile markets? Why is DCA spacing important for margin safety? How does explosive_threshold_pct determine when DCA is held? What is smoothed kline movement in Volatility Gate? How are candles analyzed in the volatility calculation? What does neutral_threshold_pct mean? What is reversal_threshold_pct and how does it detect trend exhaustion? What is required_neutral_streak and why is it important? What happens during the observation phase? How often does the Volatility Gate check market conditions? What triggers the release of a held DCA order? What happens if the market remains volatile for a long time?

Risk & Safety Considerations Why does DCA increase exposure instead of reducing risk? What are the biggest risks of aggressive DCA configurations? How does leverage affect DCA safety? Can DCA cause liquidation if misconfigured? How much account balance is required to use DCA safely? How does Volatility Gate prevent catching falling knives? How does Volatility Gate protect against pump chasing? What is max_observation_minutes and why is it necessary? Can Volatility Gate reduce drawdown? What happens if volatility never cools down? How conservative should explosive_threshold_pct be set? Can aggressive settings increase risk? Does Volatility Gate eliminate DCA risk completely? Is Volatility Gate suitable for highly volatile altcoins?

DCA + Other MagicTradeBot Features How does DCA work with Smart Stop-Loss in MagicTradeBot? Can DCA be combined with risk-based position sizing? Does DCA change take-profit behavior? Can Market Watch or signals trigger DCA trades? What is the Volatility Gate in DCA? How does Smart DCA Observation improve traditional DCA? What happens when price hits the DCA deviation but volatility is high? Does Volatility Gate delay DCA orders? Can Volatility Gate be disabled? Can Volatility Gate work alongside Trailing strategies?

Testing & Best Practices Should I test DCA strategies in demo mode first? What are recommended DCA settings for beginners? How can I tell if my DCA configuration is too aggressive? What are common DCA mistakes to avoid? What are recommended Volatility Gate settings for BTC? What are recommended settings for high-volatility altcoins? How should explosive_threshold_pct be tuned? How long should max_observation_minutes be set? How to optimize required_neutral_streak? When should Volatility Gate be disabled? Is Volatility Gate suitable for scalping strategies?

Advanced DCA Position Size Calculation What is automatic DCA position size calculation in MagicTradeBot? Why is position size calculation important when using DCA strategies? How does this feature differ from fixed initial trade amounts? Does this setting reduce risk when using multiple DCA orders? Is this feature suitable for both beginners and advanced traders? What does auto_calculate_initial_amount do? When should I enable automatic initial amount calculation? What happens if auto_calculate_initial_amount is set to false? What is the purpose of the balance setting in DCA calculations? What does total_percent_investment_per_trade control? How is total DCA exposure calculated using this percentage? Is this feature suitable for professional and institutional setups? Does this percentage include the initial entry and all DCA orders? s this safer than increasing size_multiplier manually? How does this setting work with leverage and futures trading? Can this be combined with Money Management sequences? Whould I use fixed balance mode during backtesting? What happens if multiple symbols trigger DCA at the same time? Can this prevent liquidation caused by excessive DCA scaling? What logs should I check if DCA orders are not placed? How do I safely adjust this setting without restarting the bot? How does delayed DCA execution affect average entry price? Does Volatility Gate improve DCA capital efficiency? How does Smart Observation impact exposure scaling? Can Volatility Gate reduce unnecessary position expansion? How does the observation model impact liquidation risk? Does holding DCA orders affect leverage calculations? How should position sizing be adjusted when using Volatility Gate?

Smart DCA Observation (Volatility Gate) What is the DCA observation lifecycle? When does a held DCA transition to execution? What happens if neutral streak resets? What logs are generated during observation? How to tune thresholds for trending markets? How to tune thresholds for ranging markets? How to combine Volatility Gate with Smart SL and Smart TP? How Smart DCA Observation Prevents Catching Falling Knives Volatility Gate Explained: Institutional-Grade DCA Protection How to Tune Volatility Gate for Maximum Safety What problem does Volatility Gate solve? How is this different from fixed-interval DCA?

Grid DCA (Micro Scaling Engine)

Grid DCA Fundamentals What is Grid DCA? How is Grid DCA different from normal DCA? Why use micro-scaling instead of larger DCA steps? When should Grid DCA be used? When should Grid DCA be avoided? How does Grid DCA affect capital deployment?

How Grid DCA Works With Existing DCA What is the execution order: Parent → Grid → Final? Can Grid DCA run without traditional DCA? Does volatility gate affect Grid DCA? What happens if final DCA triggers while grid is active? Does Grid DCA stop after final DCA? Can Grid DCA trigger multiple times rapidly?

Grid DCA + Take Profit (TP) Mechanics How does Grid DCA affect average entry price? Does Grid DCA reduce required recovery percentage? Can Grid DCA cause earlier TP triggers? How does TP behave after multiple grid entries? Should TP % be adjusted when using Grid DCA? Does Grid DCA increase fee impact?

Multi-Layer DCA Architecture (Advanced) What is multi-layer DCA? How should I allocate capital between Parent, Grid, and Final? Why is final DCA usually larger? Why does final DCA require volatility cooldown? What happens if final DCA never triggers? How does multi-layer DCA reduce probability of max loss?

Exposure & Risk Modeling With Grid Does Grid DCA increase risk? How does deviation_percent affect drawdown? How does interval_minutes protect from rapid overexposure? How should grid settings change in leveraged trades?

Grid DCA Configuration Guide What is max_orders in Grid DCA? What is order_percent? What is deviation_percent? What is interval_minutes? What are conservative Grid DCA settings? What are aggressive Grid DCA settings? How to tune Grid DCA for explosive coins?

Multi-Layer Extreme Volatility Monitor & Auto-Trading Can I restrict which symbols are auto-traded? What is the Extreme Volatility Monitor in MagicTradeBot? When should I enable the Extreme Volatility Monitor? What does the Enabled flag control? Which symbols are analyzed for volatility? Why should I limit the number of monitored symbols? What is AverageMovementPercent? What is a good value for AverageMovementPercent? What is AverageMovementEmergencyClose? What does EmergencyCloseMinHoldTime do? What is the trade lock (LockPercent) feature? What happens when trade lock is triggered? What does Candles control in volatility analysis? What is Auto-Trade in the volatility module? What does AutoTrade.Enabled control? What is the Threshold in Auto-Trade? What is the difference between Reverse and Momentum trade direction? What does InitialAmount define? What is MaximumHoldTime? Why use a maximum hold time for volatility trades? How does stop-loss work for volatility auto-trades? Can DCA be used with volatility auto-trading? Is this module safe for leveraged trading? What does Auto Trade Take-Profit do in Market Watch? Does Take-Profit work with DCA-enabled auto trades?

Kline / Market Data / Refresh Rates What does max_kline_length control? What is the Market Data (Kline) Engine in MagicTradeBot? Why is market data configuration critical? What does refresh_interval control? What is the recommended refresh_interval for scalping? What is the recommended refresh_interval for swing or long-term trading? How does safeBuffer work? What does chunk_size mean? How does kline_refresh_rate differ from refresh_interval? What is summary_interval used for? What does signal_refresh_interval control? What is decision_making_interval? What is strategy timeframe mapping? Why use multiple timeframes per strategy? Are timeframe formats exchange-specific? What does maxRequestsPerSecond control? Why is safeBuffer important? What happens if API rate limits are exceeded? Can market data settings affect signal accuracy? Should these settings be tested before live trading?

Trade Execution Options What does the Type option control in Trade Trigger Options? When should I use a Market Order versus a Limit Order? What is AskPriceBufferPer and why is it important? How does AskPriceBufferPer affect slippage? What does TimeInForce control for limit orders? How should I set TimeInForce for different strategies? What happens if a limit order is not filled within TimeInForce? Can AskPriceBufferPer and TimeInForce be used together effectively? Is it safe to use Market Orders during high-volatility events?

Physical Stop-Loss / Take-Profit Settings What are Physical Stop-Loss and Take-Profit settings? How does StopLossPercent work? How does TakeProfitPercent work? Can Physical SL/TP be combined with Smart SL/TP or trailing strategies? Does Physical SL/TP affect DCA positions?

Funding Farming Mode Can Funding Farming still be liquidated? What is Funding Farming in MagicTradeBot? How does Funding Farming generate profit? Is Funding Farming directional trading? What trading modes are required for Funding Farming? How do I enable Funding Farming mode? Which exchanges are NOT supported? How does MagicTradeBot choose symbols for Funding Farming? What does max_open_trades control? What is the purpose of funding_rate_threshold? Why are Spot and Futures order sizes different? What is liquidation protection in Funding Farming? Why is Funding Farming considered capital-intensive? What does open_trade_before control? What does close_trade_after control? Is Funding Farming suitable for all market conditions? Which symbols are best for Funding Farming?

Hyperliquid Whale Tracker What is the Hyperliquid Whale Tracker? How do I activate whale tracking in MagicTradeBot? How do I choose which whale wallets to track? What does place_order do? How does broadcast_signals work? What is max_orders_per_whale and why is it important? What are the recommended best practices for whale tracking? Does following whales guarantee profits? Can I use whale tracking with other trading modes?

Manual Trade Entry Are manual trades executed instantly? What is Manual Trade Entry in MagicTradeBot? Why use manual trades instead of placing orders directly on the exchange? Where are manual trades configured? Can manual trades bypass trading signals? What happens if a manual trade’s conditions are never met? What does setting Price: 0 mean? What is ExecuteThresholdPerfect? Is ExecuteThresholdPerfect directional? What is the purpose of the Amount field? Can I mix fixed-size and bot-calculated trades? What does the Direction field control? What is the Timestamp field used for? Can I use manual trades for dip-buy strategies? Are manual trades compatible with DCA? What happens after a manual trade is executed? Can I add multiple manual trades at once? Are manual trades affected by excluded symbols? Is Manual Trade Entry suitable for beginners?

Money Management Strategy Settings What is the Money Management Strategy in MagicTradeBot? When should I use Money Management? What does the Sequence represent? What happens if the sequence is empty ([])? What are common sequence types? Is Martingale dangerous? What does Mode control? What does SkipSymbol do? What is MoveBackSteps? Can Money Management be combined with DCA? What is a safe starter configuration?

Broadcast & Notification Channels What happens if an order fails? What are Broadcast & Notification Channels in MagicTradeBot? Why should I enable notifications? Can I enable multiple notification platforms at the same time? What happens if a platform is set to null? Which notification channel is best for beginners? Are there alerts for account balance thresholds? What kind of messages are broadcasted? How do I create a Telegram bot? Can I send notifications to Telegram groups or channels? What is Discord Webhook used for? Will notifications slow down the bot? Can notifications expose my API keys or balances? How fast are broadcast messages delivered during high symbol activity? Should I enable notifications in demo mode? What types of messages does MagicTradeBot broadcast? Why are broadcast messages important for high-symbol count strategies? What messages are sent when a signal is triggered? What messages are sent during market crashes or pumps? Which broadcast channel is best for critical alerts during high-volume trading?

Symbol Exclusion List What is the Symbol Exclusion List in MagicTradeBot? Why would I want to exclude certain symbols? Does excluding a symbol stop all trading activity for it? Can I use the exclusion list to block stablecoin pairs? When do exclusion list changes take effect? What is the correct format for excluded symbols? Can I exclude symbols for risk management reasons?

MagicTradeBot v5.2+ — Latest stable

Home / Docs / Kline / Market Data / Refresh Rates

Kline / Market Data / Refresh Rates

Ready to trade? Download MagicTradeBot free and test in paper mode before going live.

On this page

Report an issue

Professional crypto trading automation platform built for risk-first execution, intelligent DCA, TradingView signal integration, and whale tracking.

Learn

Documentation
Knowledgebase
Blog
FAQ

Platform

Pricing
Download
Affiliate Program
Bot Configurator

Products

MagicTradeBot
ArbEdgeBot
RedisMarketBridge

Company

Contact Us
Privacy Policy
Terms & Conditions
Legal & Compliance
Custom Dev

© 2026 MagicTradeBot™. All Rights Reserved. Enterprise-grade crypto automation · Built with risk-first design.

Risk Disclaimer: MagicTradeBot is a trading execution and risk-management platform — not a signal provider, market predictor, or investment advisor. It does not forecast price movements or guarantee profits. All strategies, parameters, and risk settings are fully defined and managed by the user.