diff --git a/configuration/index.html b/configuration/index.html
index 9e76d268..7503b882 100644
--- a/configuration/index.html
+++ b/configuration/index.html
@@ -1030,6 +1030,8 @@ <h3 id="example-configuration-snippet">Example Configuration Snippet</h3>
         &quot;dashboard_enabled&quot;: false,
         &quot;shared_data_path&quot;: &quot;data/&quot;,
         &quot;linear_grid&quot;: {
+            &quot;grid_behavior&quot;: &quot;infinite&quot;,
+            &quot;drawdown_behavior&quot;: &quot;maxqtypercent&quot;,
             &quot;target_coins_mode&quot;: false,
             &quot;auto_graceful_stop&quot;: false,
             &quot;entry_signal_type&quot;: &quot;lorentzian&quot;,
diff --git a/search/search_index.json b/search/search_index.json
index f5aa3fa3..25daca8f 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Directional Scalper","text":"<p>Welcome to the documentation for Directional Scalper.</p>"},{"location":"#links","title":"Links","text":"<ul> <li>Website</li> <li>API (BYBIT)</li> <li>Discord</li> </ul> Directional Scalper API Scraper Dashboard Directional Scalper Multi Menu GUI <p>Quantum Void Labs is a non-profit organization dedicated to developing open-source applications. We specialize in developing algorithms that are freely available to the public under the MIT License. </p> <p>Our focus is on contributing to the global knowledge base rather than commercializing our work. </p> <p>We do not sell products or services; instead, we aim to encourage innovation and collaboration within the ecosystem through our open-source contributions.</p>"},{"location":"configuration/","title":"Configuration","text":""},{"location":"configuration/#account-section","title":"Account Section","text":"<p>Configure your account settings in the <code>account.json</code> file under the <code>account</code> section. This includes API keys, account names, and other related settings.</p>"},{"location":"configuration/#parameters","title":"Parameters:","text":"<ul> <li>name: Exchange name</li> <li>api_key: Your exchange API key.</li> <li>api_secret: Your exchange API secret.</li> <li>account_name: A name to identify your account configuration.</li> </ul>"},{"location":"configuration/#accounts","title":"Accounts","text":"<p>Configure your accounts using 'account.json' in the configs folder.</p> <pre><code>{\n    \"exchanges\": [\n        {\n            \"name\": \"bybit\",\n            \"account_name\": \"account_1\",\n            \"api_key\": \"your_api_key\",\n            \"api_secret\": \"your_api_secret\"\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"api_key\": \"your_api_key\",\n            \"api_secret\": \"your_api_secret\"\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"api_key\": \"your_api_key\",\n            \"api_secret\": \"your_api_secret\"\n        }\n    ]\n}\n</code></pre>"},{"location":"configuration/#bot-section","title":"Bot Section","text":"<p>Configure your bot settings in the <code>config.json</code> file under the <code>bot</code> section. This includes strategy parameters, risk management settings, and other related settings.</p>"},{"location":"configuration/#risk-management-parameters","title":"Risk management parameters","text":"<ul> <li>Exchange leverage is MAX CROSS on all pairs by default: Changing user_defined_leverage does not change leverage on exchange instead it changes the amount the bot is allowed to use.</li> <li>user_defined_leverage_long: This parameter defines the leverage to use for long positions. Leverage is a multiplier that increases the size of the position and the potential profit/loss. For example, a leverage of 10 means that for every $1 you have, you can place a trade worth $10. Be careful with this setting as higher leverage also increases the risk.</li> <li>user_defined_leverage_short: This parameter defines the leverage to use for short positions. Similar to <code>user_defined_leverage_long</code>, it's a multiplier that increases the size of the position and the potential profit/loss.</li> </ul>"},{"location":"configuration/#risk-management-explanation","title":"Risk Management Explanation","text":"<p>Risk Management plays a crucial role in trading strategies, as it helps protect the trader's capital and limits potential losses. In the provided code snippet, there are several parameters and calculations related to risk management. Let's dive into each of them and provide examples to clarify their usage.</p> <ul> <li>user_defined_leverage_long and user_defined_leverage_short:</li> <li>These parameters allow the user to specify the leverage for long and short positions, respectively.</li> <li>Leverage is a multiplier that increases the size of the position and the potential profit/loss.</li> <li> <p>Example:</p> <ul> <li>If <code>user_defined_leverage_long</code> is set to 5, it means that for every $1 of the trader's capital, they can open a long position worth $5.</li> <li>Similarly, if <code>user_defined_leverage_short</code> is set to 3, it means that for every $1 of the trader's capital, they can open a short position worth $3.</li> </ul> </li> <li> <p>wallet_exposure_limit_long and wallet_exposure_limit_short:</p> </li> <li>These parameters define the maximum percentage of the trader's total equity that can be allocated to long and short positions, respectively.</li> <li>They help limit the overall exposure to risk by controlling the amount of capital deployed in each position.</li> <li> <p>Example:</p> <ul> <li>If <code>wallet_exposure_limit_long</code> is set to 0.1 (10%), it means that the maximum amount allocated to long positions cannot exceed 10% of the total equity.</li> <li>Similarly, if <code>wallet_exposure_limit_short</code> is set to 0.05 (5%), it means that the maximum amount allocated to short positions cannot exceed 5% of the total equity.</li> </ul> </li> <li> <p>Effective Leverage Calculation:</p> </li> <li>The effective leverage used in trading is calculated as <code>total_equity * wallet_exposure_limit * leverage_used</code>.</li> <li>This calculation determines the maximum position value based on the trader's total equity, wallet exposure limit, and the selected leverage.</li> <li> <p>Example:</p> <ul> <li>Let's say a trader has a total equity of $10,000, <code>wallet_exposure_limit_long</code> is set to 0.1 (10%), and <code>user_defined_leverage_long</code> is set to 5.</li> <li>The maximum position value for long positions would be: $10,000 * 0.1 * 5 = $5,000.</li> <li>This means that the trader can open long positions with a total value of up to $5,000.</li> </ul> </li> <li> <p>enforce_full_grid:</p> </li> <li>This parameter determines whether the trading strategy should enforce a full grid of positions or allow partial grid usage.</li> <li>If <code>enforce_full_grid</code> is set to <code>True</code>, the code calculates the required notional amount by dividing the maximum position value by the number of levels.</li> <li>If <code>enforce_full_grid</code> is set to <code>False</code>, the code uses the maximum position value as the required notional amount.</li> <li> <p>Example:</p> <ul> <li>Let's say the maximum position value is $5,000, and the trading strategy uses 5 levels.</li> <li>If <code>enforce_full_grid</code> is <code>True</code>, the required notional amount for each level would be: $5,000 / 5 = $1,000.</li> <li>If <code>enforce_full_grid</code> is <code>False</code>, the required notional amount would be the full $5,000.</li> </ul> </li> <li> <p>Adjusting Maximum Position Value:</p> </li> <li>The code takes into account the current position value (long or short) and adjusts the maximum position value accordingly.</li> <li>It calculates the current position value by multiplying the position quantity (long or short) with the respective best ask or bid price.</li> <li>The adjusted maximum position value is then calculated by subtracting the current position value from the original maximum position value.</li> <li>Example:<ul> <li>Let's say the maximum position value is $5,000, and the trader currently holds a long position with a quantity of 2 units at a best ask price of $100.</li> <li>The current position value would be: 2 * $100 = $200.</li> <li>The adjusted maximum position value would be: $5,000 - $200 = $4,800.</li> <li>This means that the trader can open additional positions with a total value of up to $4,800.</li> </ul> </li> </ul> <p>These risk management parameters and calculations help traders control their exposure to risk, limit potential losses, and manage their positions effectively. By adjusting these parameters based on their risk tolerance and trading strategy, traders can optimize their risk management approach and protect their capital.</p>"},{"location":"configuration/#linear-grid-strategy-parameters","title":"Linear Grid Strategy Parameters","text":"<p>Here are the parameters for the <code>linear_grid</code> strategy in your <code>config.json</code> file:</p> <ul> <li>max_qty_percent_long: Defines the maximum percentage of your wallet balance that can be used for long positions.</li> <li>max_qty_percent_short: Defines the maximum percentage of your wallet balance that can be used for short positions.</li> <li>auto_reduce_cooldown_enabled: Boolean parameter that determines whether the auto-reduce cooldown feature is enabled. This feature automatically reduces the size of your positions after a certain period.</li> <li>auto_reduce_cooldown_start_pct: Defines the percentage at which the auto-reduce cooldown feature starts.</li> <li>wallet_exposure_limit_long: Defines the maximum exposure limit for long positions as a percentage of your wallet balance.</li> <li>wallet_exposure_limit_short: Defines the maximum exposure limit for short positions as a percentage of your wallet balance.</li> <li>levels: Defines the number of grid levels, representing the total number of buy and sell orders placed above and below the current price level.</li> <li>strength: Defines the strength of the grid. A higher value means the grid levels are spaced further apart.</li> <li>outer_price_distance: Defines the distance from the current price to the outermost grid levels.</li> <li>min_outer_price_distance: Defines the minimum distance from the current price to the outermost grid levels.</li> <li>max_outer_price_distance: Defines the maximum distance from the current price to the outermost grid levels.</li> <li>long_mode: Boolean parameter that determines whether the bot can open long positions.</li> <li>short_mode: Boolean parameter that determines whether the bot can open short positions.</li> <li>reissue_threshold: Defines the threshold at which the bot will reissue orders that have been partially filled.</li> <li>buffer_percentage: Defines the buffer percentage for the grid. This is the percentage of the price range kept empty between the outermost grid levels and the upper and lower price limits.</li> <li>initial_entry_buffer_pct: Defines the buffer percentage for the initial entry.</li> <li>min_buffer_percentage: Defines the minimum buffer percentage for the grid.</li> <li>max_buffer_percentage: Defines the maximum buffer percentage for the grid.</li> <li>enforce_full_grid: Boolean parameter that determines whether the bot should always maintain a full grid of orders.</li> <li>min_buffer_percentage_ar: Defines the minimum buffer percentage for auto-reduce.</li> <li>max_buffer_percentage_ar: Defines the maximum buffer percentage for auto-reduce.</li> <li>upnl_auto_reduce_threshold_long: Defines the unrealized profit and loss (UPNL) threshold for auto-reducing long positions.</li> <li>upnl_auto_reduce_threshold_short: Defines the UPNL threshold for auto-reducing short positions.</li> <li>failsafe_enabled: Boolean parameter that determines whether the failsafe feature is enabled. This feature automatically closes all positions if the UPNL reaches a certain threshold.</li> <li>failsafe_start_pct: Defines the percentage at which the failsafe feature starts.</li> <li>long_failsafe_upnl_pct: Defines the UPNL percentage for the long failsafe.</li> <li>short_failsafe_upnl_pct: Defines the UPNL percentage for the short failsafe.</li> </ul>"},{"location":"configuration/#example-configuration-snippet","title":"Example Configuration Snippet","text":"<pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0029,\n        \"max_upnl_profit_pct\": 0.0040,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 50,\n        \"min_qty_threshold\": 0,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"BTCUSDT\", \"ETHUSDT\"],\n        \"whitelist\": [],\n        \"dashboard_enabled\": false,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"target_coins_mode\": false,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 30,\n            \"max_qty_percent_short\": 30,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 0.006,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": true,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 30.0,\n            \"upnl_auto_reduce_threshold_short\": 30.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.07,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n          \"name\": \"bybit\",\n          \"account_name\": \"account_1\",\n          \"symbols_allowed\": 10\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n</code></pre>"},{"location":"control_center/","title":"Control Center","text":""},{"location":"control_center/#configuring-the-password","title":"Configuring the Password","text":"<ol> <li>Open the <code>config.toml</code> file in the <code>directionalscalper/controlcenter/</code> directory in a text editor:    <code>nano config.toml</code></li> <li>Add or update the <code>[credentials]</code> section with your desired password:    <code>[credentials]    password = \"your_password_here\"</code></li> <li>Save the file and close the editor.</li> </ol>"},{"location":"control_center/#starting-the-streamlit-dashboard","title":"Starting the Streamlit Dashboard","text":"<p>To start the Streamlit dashboard (Control Center) for Directional Scalper, follow these steps:</p> <ol> <li>Navigate to the <code>directionalscalper/controlcenter/</code> directory:    <code>cd directionalscalper/controlcenter/</code></li> <li>Ensure you have Streamlit installed. If not, you can install it using:    <code>pip install streamlit</code></li> <li>Run the dashboard using Streamlit:    <code>streamlit run dashboard.py</code></li> <li>The dashboard will prompt for a password. You need to configure this password in the <code>config.toml</code> file located in the same directory.</li> </ol>"},{"location":"control_center/#accessing-the-dashboard","title":"Accessing the Dashboard","text":"<p>Once the dashboard is running, you can access it through your web browser by navigating to the local URL provided by Streamlit (usually <code>http://localhost:8501</code>). Ensure that your firewall or network settings allow access to this port if you are accessing it remotely.</p>"},{"location":"installation/","title":"Installation","text":""},{"location":"installation/#vps-setup","title":"VPS Setup","text":"<p>To set up a VPS (Virtual Private Server) for running the bot, follow these steps:</p> <ol> <li> <p>Choose a VPS Provider: Select a VPS provider such as Hetzner, DigitalOcean, AWS, or Linode. For optimal performance, it is recommended to use a Hetzner 4 core 8GB Intel server. Create an account and set up a new VPS instance with at least 4 Cores and 8GB of RAM and a suitable operating system (e.g., Ubuntu 20.04).</p> </li> <li> <p>Connect to Your VPS: Use SSH to connect to your VPS. Replace <code>your_vps_ip</code> with the IP address of your VPS.    <code>ssh root@your_vps_ip</code></p> </li> <li> <p>Update and Upgrade Packages: Ensure your VPS is up to date.    <code>sudo apt update &amp;&amp; sudo apt upgrade -y</code></p> </li> <li> <p>Install Python 3.11: Follow the instructions in the \"Installing Python 3.11\" section below to install Python 3.11 on your VPS.</p> </li> <li> <p>Install Git: If Git is not already installed, install it using:    <code>sudo apt install git -y</code></p> </li> <li> <p>Clone the Repository: Clone the Directional Scalper repository to your VPS:    <code>git clone https://github.com/donewiththedollar/directionalscalper.git</code></p> </li> <li> <p>Install Dependencies: Install the required Python dependencies.    <code>pip3.11 install -r requirements.txt</code></p> </li> <li> <p>Configure the Bot: Rename the configuration files and add your API keys as described in the \"Quickstart\" section.</p> </li> <li> <p>Run the Bot: Start the bot using the appropriate command as described in the \"Quickstart\" section.</p> </li> </ol>"},{"location":"installation/#prerequisites","title":"Prerequisites","text":"<p>Before you begin, ensure you have the following prerequisites:</p> <ul> <li>Python 3.11+</li> <li>pip</li> <li>git</li> </ul>"},{"location":"installation/#quickstart","title":"Quickstart","text":"<ol> <li> <p>Clone the repository:    <code>git clone https://github.com/donewiththedollar/directionalscalper.git</code></p> <p>Change current working directory to the project directory: <code>cd directionalscalper</code></p> </li> <li> <p>Install the required dependencies:    <code>pip3.11 install -r requirements.txt</code></p> </li> <li> <p>Rename the <code>config_example.json</code> to <code>config.json</code> located in the <code>/configs</code> folder. Also rename <code>account_example.json</code> to <code>account.json</code> and add your API key(s) to the <code>account.json</code> file located in the <code>/configs</code> folder.</p> </li> <li> <p>Run the bot:</p> </li> <li>To display the menu and select a strategy, use the following command:      <code>python3.11 multi_bot_aio.py --config configs/config.json</code>      or the old method      <code>python3.11 multi_bot_v4.py --config config.json (outdated)</code></li> <li>Alternatively, you can run the bot with command line parameters:<ul> <li>For the multi-bot auto symbol rotator strategy:    <code>python3.11 multi_bot_v3.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></li> <li>For the old single coin strategy (outdated):    <code>python3.11 bot.py --exchange bybit --symbol DOGEUSDT --strategy qstrendob --config configs/config.json</code></li> </ul> </li> </ol>"},{"location":"installation/#installing-python-311","title":"Installing Python 3.11","text":"<p>To install Python 3.11 on your system, follow these steps:</p> <ol> <li> <p>Update the package list and install the necessary dependencies:    <code>sudo apt update    sudo apt install -y build-essential gdb lcov pkg-config \\    libbz2-dev libffi-dev libgdbm-dev libgdbm-compat-dev liblzma-dev \\    libncurses5-dev libreadline-dev libsqlite3-dev libssl-dev \\    lzma lzma-dev tk-dev uuid-dev zlib1g-dev</code></p> </li> <li> <p>Download the Python 3.11.0 source code:    <code>cd /opt    wget https://www.python.org/ftp/python/3.11.0/Python-3.11.0.tgz</code></p> </li> <li> <p>Extract the downloaded archive:    <code>sudo tar -xzf Python-3.11.0.tgz</code></p> </li> <li> <p>Change to the extracted directory:    <code>cd Python-3.11.0</code></p> </li> <li> <p>Configure the build with optimizations:    <code>sudo ./configure --enable-optimizations --prefix=/usr/local</code></p> </li> <li> <p>Compile Python:    <code>sudo make -j 8</code></p> </li> <li> <p>Install Python 3.11:    <code>sudo make altinstall</code></p> </li> <li> <p>Verify the installation:    <code>python3.11 --version</code></p> </li> </ol> <p>You should see the installed Python version displayed.</p> <p>That's it! You have now installed Python 3.11 on your system.</p>"},{"location":"risk_management/","title":"Risk Management in DirectionalScalper","text":"<p>This document explains the risk management strategies implemented in the trading bot, focusing on four key parameters from the configuration.</p>"},{"location":"risk_management/#example-key-configuration-parameters","title":"Example Key Configuration Parameters","text":"<ol> <li><code>wallet_exposure_limit_long</code>: 0.013 (1.3%)</li> <li><code>wallet_exposure_limit_short</code>: 0.004 (0.4%)</li> <li><code>max_qty_percent_long</code>: 10%</li> <li><code>max_qty_percent_short</code>: 10%</li> </ol>"},{"location":"risk_management/#understanding-the-parameters","title":"Understanding the Parameters","text":""},{"location":"risk_management/#wallet-exposure-limits","title":"Wallet Exposure Limits","text":"<p>The <code>wallet_exposure_limit_long</code> and <code>wallet_exposure_limit_short</code> parameters define the maximum percentage of the total equity that can be allocated to long and short positions, respectively.</p> <ul> <li>Long positions: Up to 1.3% of total equity</li> <li>Short positions: Up to 0.4% of total equity</li> </ul> <p>These limits help prevent overexposure to any single trading direction and maintain a balanced risk profile.</p>"},{"location":"risk_management/#maximum-quantity-percentages","title":"Maximum Quantity Percentages","text":"<p>The <code>max_qty_percent_long</code> and <code>max_qty_percent_short</code> parameters set the maximum allowed position size as a percentage of the total equity for long and short positions, respectively.</p> <ul> <li>Both long and short positions: Up to 10% of total equity</li> </ul> <p>These limits act as an additional safety measure to prevent any single position from becoming too large relative to the total equity.</p>"},{"location":"risk_management/#risk-management-implementation","title":"Risk Management Implementation","text":"<p>The bot implements risk management through the <code>check_and_manage_positions</code> function. Here's how it works:</p> <ol> <li>Calculate Maximum Allowed Positions:</li> <li>For long positions: <code>max_qty_long = (total_equity * wallet_exposure_limit_long) / current_price</code></li> <li> <p>For short positions: <code>max_qty_short = (total_equity * wallet_exposure_limit_short) / current_price</code></p> </li> <li> <p>Calculate Position Exposure Percentages:</p> </li> <li>Long exposure: <code>(long_pos_qty * current_price / total_equity) * 100</code></li> <li> <p>Short exposure: <code>(short_pos_qty * current_price / total_equity) * 100</code></p> </li> <li> <p>Check Against Maximum Quantity Percentages:</p> </li> <li>If long exposure &gt; <code>max_qty_percent_long</code>:<ul> <li>Clear long grid</li> <li>Remove symbol from active grids</li> <li>Add symbol to <code>max_qty_reached_symbol_long</code> set</li> </ul> </li> <li> <p>If short exposure &gt; <code>max_qty_percent_short</code>:</p> <ul> <li>Clear short grid</li> <li>Remove symbol from active grids</li> <li>Add symbol to <code>max_qty_reached_symbol_short</code> set</li> </ul> </li> <li> <p>Recovery Mechanism:</p> </li> <li>If a symbol's exposure falls below the maximum allowed percentage, it is removed from the respective <code>max_qty_reached_symbol</code> set, allowing trading to resume.</li> </ol>"},{"location":"risk_management/#additional-risk-management-features","title":"Additional Risk Management Features","text":""},{"location":"risk_management/#proper-dca-dollar-cost-averaging-implementation","title":"Proper DCA (Dollar Cost Averaging) Implementation","text":"<p>The bot uses two functions for implementing a proper DCA strategy:</p> <ol> <li><code>calculate_total_amount_notional_ls_properdca</code>:</li> <li>Calculates the total notional amount for a grid based on the wallet exposure limits and current position values.</li> <li> <p>Ensures that the total position value (including existing positions) doesn't exceed the maximum allowed exposure.</p> </li> <li> <p><code>calculate_order_amounts_notional_properdca</code>:</p> </li> <li>Distributes the total notional amount across multiple orders in the grid.</li> <li>Uses a strength parameter to adjust the distribution, allowing for more aggressive or conservative strategies.</li> <li>Ensures that each order meets minimum notional and quantity requirements set by the exchange.</li> </ol>"},{"location":"risk_management/#grid-management","title":"Grid Management","text":"<ul> <li>The bot clears grids when position sizes exceed the maximum allowed percentages.</li> <li>It uses sets (<code>max_qty_reached_symbol_long</code> and <code>max_qty_reached_symbol_short</code>) to track symbols that have reached their maximum allowed quantities.</li> <li>Trading is paused for symbols in these sets until their exposure falls below the maximum allowed percentage.</li> </ul>"},{"location":"risk_management/#conclusion","title":"Conclusion","text":"<p>This risk management system provides a comprehensive approach to controlling exposure and managing position sizes. By using wallet exposure limits and maximum quantity percentages, the bot maintains a balanced risk profile while allowing for effective trading across multiple symbols and strategies.</p> <p>The implementation of proper DCA and dynamic grid management further enhances the bot's ability to adapt to market conditions while adhering to predefined risk parameters.</p>"},{"location":"strategies/","title":"Strategies","text":""},{"location":"strategies/#linear-grid-strategy","title":"Linear Grid Strategy","text":""},{"location":"strategies/#overview","title":"Overview","text":"<p>The Linear Grid Strategy is a trading strategy designed to capitalize on market fluctuations by placing multiple buy and sell orders at predefined intervals (grid levels) above and below the current price level. This strategy helps in capturing profits in both upward and downward market movements.</p>"},{"location":"strategies/#configuration-parameters","title":"Configuration Parameters","text":"<p>Here are the parameters for the <code>linear_grid</code> strategy in your <code>config.json</code> file:</p> <ul> <li>max_qty_percent_long: Defines the maximum percentage of your wallet balance that can be used for long positions.</li> <li>max_qty_percent_short: Defines the maximum percentage of your wallet balance that can be used for short positions.</li> <li>auto_reduce_cooldown_enabled: Boolean parameter that determines whether the auto-reduce cooldown feature is enabled. This feature automatically reduces the size of your positions after a certain period.</li> <li>auto_reduce_cooldown_start_pct: Defines the percentage at which the auto-reduce cooldown feature starts.</li> <li>wallet_exposure_limit_long: Defines the maximum exposure limit for long positions as a percentage of your wallet balance.</li> <li>wallet_exposure_limit_short: Defines the maximum exposure limit for short positions as a percentage of your wallet balance.</li> <li>levels: Defines the number of grid levels, representing the total number of buy and sell orders placed above and below the current price level.</li> <li>strength: Defines the strength of the grid. A higher value means the grid levels are spaced further apart.</li> <li>outer_price_distance: Defines the distance from the current price to the outermost grid levels.</li> <li>min_outer_price_distance: Defines the minimum distance from the current price to the outermost grid levels.</li> <li>max_outer_price_distance: Defines the maximum distance from the current price to the outermost grid levels.</li> <li>long_mode: Boolean parameter that determines whether the bot can open long positions.</li> <li>short_mode: Boolean parameter that determines whether the bot can open short positions.</li> <li>reissue_threshold: Defines the threshold at which the bot will reissue orders that have been partially filled.</li> <li>buffer_percentage: Defines the buffer percentage for the grid. This is the percentage of the price range kept empty between the outermost grid levels and the upper and lower price limits.</li> <li>initial_entry_buffer_pct: Defines the buffer percentage for the initial entry.</li> <li>min_buffer_percentage: Defines the minimum buffer percentage for the grid.</li> <li>max_buffer_percentage: Defines the maximum buffer percentage for the grid.</li> <li>enforce_full_grid: Boolean parameter that determines whether the bot should always maintain a full grid of orders.</li> <li>min_buffer_percentage_ar: Defines the minimum buffer percentage for auto-reduce.</li> <li>max_buffer_percentage_ar: Defines the maximum buffer percentage for auto-reduce.</li> <li>upnl_auto_reduce_threshold_long: Defines the unrealized profit and loss (UPNL) threshold for auto-reducing long positions.</li> <li>upnl_auto_reduce_threshold_short: Defines the UPNL threshold for auto-reducing short positions.</li> <li>failsafe_enabled: Boolean parameter that determines whether the failsafe feature is enabled. This feature automatically closes all positions if the UPNL reaches a certain threshold.</li> <li>failsafe_start_pct: Defines the percentage at which the failsafe feature starts.</li> <li>long_failsafe_upnl_pct: Defines the UPNL percentage for the long failsafe.</li> <li>short_failsafe_upnl_pct: Defines the UPNL percentage for the short failsafe.</li> </ul>"},{"location":"strategies/#example-configurations","title":"Example Configurations","text":""},{"location":"strategies/#example-long-and-short-auto-rotating-futures-configuration","title":"Example long and short auto rotating futures configuration","text":"<p>This strategy is based on machine learning based signals and utilizes a grid with proper DCA so each grid level is \"meaningful\" to bring the position to current market price staying \"sticky\" to price action. </p> <p>Set up your config.json from the below snippet</p> <pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0029,\n        \"max_upnl_profit_pct\": 0.0040,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 50,\n        \"min_qty_threshold\": 0,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"BTCUSDT\", \"ETHUSDT\"],\n        \"whitelist\": [],\n        \"dashboard_enabled\": false,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"target_coins_mode\": false,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 30,\n            \"max_qty_percent_short\": 30,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 0.006,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": true,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 30.0,\n            \"upnl_auto_reduce_threshold_short\": 30.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.07,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n          \"name\": \"bybit\",\n          \"account_name\": \"account_1\",\n          \"symbols_allowed\": 10\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n</code></pre> <p>Now, just run the bot using this multibot version and strategy</p> <p><code>python3.11 multi_bot_aio.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p>"},{"location":"strategies/#example-long-only-solusdt-futures-configuration","title":"Example long only SOLUSDT futures configuration","text":"<p>Set up your config.json from the below snippet to whitelist SOLUSDT and set max USD value to a higher value to allow for the symbol.</p> <p><code>max_qty_percent_long</code> and <code>max_qty_pct_short</code> are set high in this configuration, you can adjust them as needed these are just defaults for testing purposes.</p> <pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0032,\n        \"max_upnl_profit_pct\": 0.0039,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 1000,\n        \"min_qty_threshold\": 0,\n        \"long_liq_pct\": 0.05,\n        \"short_liq_pct\": 0.05,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"BTCUSDT\", \"ETHUSDT\"],\n        \"whitelist\": [\"SOLUSDT\"],\n        \"dashboard_enabled\": true,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"target_coins_mode\": true,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 10000,\n            \"max_qty_percent_short\": 10000,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 1,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": false,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 10.0,\n            \"upnl_auto_reduce_threshold_short\": 10.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.05,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n            \"name\": \"bybit\",\n            \"account_name\": \"account_1\",\n            \"symbols_allowed\": 2\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n\n</code></pre> <p>Now, just run the bot using this multibot version and strategy</p> <p><code>python3.11 multi_bot_aio.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p> <p>This is just a simple example of a long only BTCUSDT strategy to show how one can utilize a single strategy for many use case scenarios on different instruments.</p>"},{"location":"strategies/#example-high-risk-small-account-longshort-btcusdt-futures-configuration","title":"Example High risk small account long&amp;short BTCUSDT futures configuration","text":"<p>Set up your config.json from the below snippet to whitelist BTCUSDT and set max USD value to a high value to allow for the symbol.</p> <p><code>max_qty_percent_long</code> and <code>max_qty_pct_short</code> are set high in this configuration, you can adjust them as needed these are just defaults for testing purposes.</p> <pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0032,\n        \"max_upnl_profit_pct\": 0.0039,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 1000,\n        \"min_qty_threshold\": 0,\n        \"long_liq_pct\": 0.05,\n        \"short_liq_pct\": 0.05,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"ETHUSDT\"],\n        \"whitelist\": [\"BTCUSDT\"],\n        \"dashboard_enabled\": true,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"target_coins_mode\": true,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 10000,\n            \"max_qty_percent_short\": 10000,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 1,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": true,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 10.0,\n            \"upnl_auto_reduce_threshold_short\": 10.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.05,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n            \"name\": \"bybit\",\n            \"account_name\": \"account_1\",\n            \"symbols_allowed\": 2\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n\n</code></pre> <p>Now, just run the bot using this multibot version and strategy</p> <p><code>python3.11 multi_bot_signalscreener_targetcoin.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p> <p>This is an aggressive approach because it utilizes a high <code>max_qty_percent_long</code> and <code>max_qty_percent_short</code> on a small wallet balance (ie $100 USD) for a symbol with a high USD value with the min notional requirement for BTCUSDT on Bybit it is inherently more risky but also more profitable.</p>"},{"location":"usage/","title":"Usage","text":"<p>This guide will help you run the Directional Scalper bot using various command-line instructions. Ensure you have properly configured your <code>config.json</code> and <code>account.json</code> files before proceeding.</p>"},{"location":"usage/#running-the-bot","title":"Running the Bot","text":""},{"location":"usage/#easy-update-configuration-file-with-latest-parameters","title":"Easy update configuration file with latest parameters","text":"<pre><code>pip3.11 install -r requirements.txt &amp;&amp; python3.11 update_config.py --config configs/config.json &amp;&amp; mv configs/config.json.new configs/config.json\n</code></pre> <pre><code>python3.11 multi_bot_v4.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json\n</code></pre>"},{"location":"usage/#displaying-the-menu-and-selecting-a-strategy","title":"Displaying the Menu and Selecting a Strategy","text":"<p>To display the menu and select a strategy, use the following command:</p> <pre><code>python3.11 multi_bot_v4.py --config configs/config.json\n</code></pre> <p>or</p> <pre><code>python3.11 multi_bot_v4.py --config configs/config.json\n</code></pre>"},{"location":"usage/#running-the-bot-with-command-line-parameters","title":"Running the Bot with Command Line Parameters","text":"<p>You can also run the bot directly with specific command-line parameters. Below are examples of different strategies you can use:</p>"},{"location":"usage/#multi-bot-auto-symbol-rotator-strategy","title":"Multi-Bot Auto Symbol Rotator Strategy","text":"<p>To run the multi-bot auto symbol rotator strategy, use the following command:</p> <pre><code>python3.11 multi_bot_v4.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json\n</code></pre>"},{"location":"usage/#old-single-coin-strategy","title":"Old Single Coin Strategy","text":"<p>To run the old single coin strategy, use the following command: (likely very outdated, but can be updated by anyone or per request)</p> <pre><code>python3.11 bot.py --exchange bybit --symbol DOGEUSDT --strategy qstrendob --config configs/config.json\n</code></pre>"},{"location":"usage/#command-line-parameters","title":"Command Line Parameters","text":""},{"location":"usage/#general-parameters","title":"General Parameters","text":"<ul> <li>--exchange: Specifies the exchange to use (e.g., bybit, binance).</li> <li>--account_name: Specifies the account name as defined in your <code>account.json</code>.</li> <li>--strategy: Specifies the trading strategy to use (e.g., qsgridob, qstrendob).</li> <li>--config: Specifies the path to your <code>config.json</code> file.</li> </ul>"},{"location":"usage/#example-commands","title":"Example Commands","text":"<ol> <li>Running the Multi-Bot Auto Symbol Rotator Strategy for Bybit:</li> </ol> <p><code>python3.11 multi_bot_v4.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p> <ol> <li>Running the Old Single Coin Strategy for DOGEUSDT on Bybit:</li> </ol> <p><code>python3.11 bot.py --exchange bybit --symbol DOGEUSDT --strategy qstrendob --config configs/config.json</code></p>"},{"location":"usage/#additional-notes","title":"Additional Notes","text":"<ul> <li>Make sure to adjust the leverage, risk management, and other parameters in your <code>config.json</code> to suit your trading preferences.</li> <li>For advanced usage and more strategies, refer to the Configuration and Strategies sections of the documentation.</li> </ul> <p>This guide provides a straightforward approach to running the Directional Scalper bot with various strategies and configurations. If you encounter any issues, refer to the relevant sections of the documentation for more details.</p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Directional Scalper","text":"<p>Welcome to the documentation for Directional Scalper.</p>"},{"location":"#links","title":"Links","text":"<ul> <li>Website</li> <li>API (BYBIT)</li> <li>Discord</li> </ul> Directional Scalper API Scraper Dashboard Directional Scalper Multi Menu GUI <p>Quantum Void Labs is a non-profit organization dedicated to developing open-source applications. We specialize in developing algorithms that are freely available to the public under the MIT License. </p> <p>Our focus is on contributing to the global knowledge base rather than commercializing our work. </p> <p>We do not sell products or services; instead, we aim to encourage innovation and collaboration within the ecosystem through our open-source contributions.</p>"},{"location":"configuration/","title":"Configuration","text":""},{"location":"configuration/#account-section","title":"Account Section","text":"<p>Configure your account settings in the <code>account.json</code> file under the <code>account</code> section. This includes API keys, account names, and other related settings.</p>"},{"location":"configuration/#parameters","title":"Parameters:","text":"<ul> <li>name: Exchange name</li> <li>api_key: Your exchange API key.</li> <li>api_secret: Your exchange API secret.</li> <li>account_name: A name to identify your account configuration.</li> </ul>"},{"location":"configuration/#accounts","title":"Accounts","text":"<p>Configure your accounts using 'account.json' in the configs folder.</p> <pre><code>{\n    \"exchanges\": [\n        {\n            \"name\": \"bybit\",\n            \"account_name\": \"account_1\",\n            \"api_key\": \"your_api_key\",\n            \"api_secret\": \"your_api_secret\"\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"api_key\": \"your_api_key\",\n            \"api_secret\": \"your_api_secret\"\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"api_key\": \"your_api_key\",\n            \"api_secret\": \"your_api_secret\"\n        }\n    ]\n}\n</code></pre>"},{"location":"configuration/#bot-section","title":"Bot Section","text":"<p>Configure your bot settings in the <code>config.json</code> file under the <code>bot</code> section. This includes strategy parameters, risk management settings, and other related settings.</p>"},{"location":"configuration/#risk-management-parameters","title":"Risk management parameters","text":"<ul> <li>Exchange leverage is MAX CROSS on all pairs by default: Changing user_defined_leverage does not change leverage on exchange instead it changes the amount the bot is allowed to use.</li> <li>user_defined_leverage_long: This parameter defines the leverage to use for long positions. Leverage is a multiplier that increases the size of the position and the potential profit/loss. For example, a leverage of 10 means that for every $1 you have, you can place a trade worth $10. Be careful with this setting as higher leverage also increases the risk.</li> <li>user_defined_leverage_short: This parameter defines the leverage to use for short positions. Similar to <code>user_defined_leverage_long</code>, it's a multiplier that increases the size of the position and the potential profit/loss.</li> </ul>"},{"location":"configuration/#risk-management-explanation","title":"Risk Management Explanation","text":"<p>Risk Management plays a crucial role in trading strategies, as it helps protect the trader's capital and limits potential losses. In the provided code snippet, there are several parameters and calculations related to risk management. Let's dive into each of them and provide examples to clarify their usage.</p> <ul> <li>user_defined_leverage_long and user_defined_leverage_short:</li> <li>These parameters allow the user to specify the leverage for long and short positions, respectively.</li> <li>Leverage is a multiplier that increases the size of the position and the potential profit/loss.</li> <li> <p>Example:</p> <ul> <li>If <code>user_defined_leverage_long</code> is set to 5, it means that for every $1 of the trader's capital, they can open a long position worth $5.</li> <li>Similarly, if <code>user_defined_leverage_short</code> is set to 3, it means that for every $1 of the trader's capital, they can open a short position worth $3.</li> </ul> </li> <li> <p>wallet_exposure_limit_long and wallet_exposure_limit_short:</p> </li> <li>These parameters define the maximum percentage of the trader's total equity that can be allocated to long and short positions, respectively.</li> <li>They help limit the overall exposure to risk by controlling the amount of capital deployed in each position.</li> <li> <p>Example:</p> <ul> <li>If <code>wallet_exposure_limit_long</code> is set to 0.1 (10%), it means that the maximum amount allocated to long positions cannot exceed 10% of the total equity.</li> <li>Similarly, if <code>wallet_exposure_limit_short</code> is set to 0.05 (5%), it means that the maximum amount allocated to short positions cannot exceed 5% of the total equity.</li> </ul> </li> <li> <p>Effective Leverage Calculation:</p> </li> <li>The effective leverage used in trading is calculated as <code>total_equity * wallet_exposure_limit * leverage_used</code>.</li> <li>This calculation determines the maximum position value based on the trader's total equity, wallet exposure limit, and the selected leverage.</li> <li> <p>Example:</p> <ul> <li>Let's say a trader has a total equity of $10,000, <code>wallet_exposure_limit_long</code> is set to 0.1 (10%), and <code>user_defined_leverage_long</code> is set to 5.</li> <li>The maximum position value for long positions would be: $10,000 * 0.1 * 5 = $5,000.</li> <li>This means that the trader can open long positions with a total value of up to $5,000.</li> </ul> </li> <li> <p>enforce_full_grid:</p> </li> <li>This parameter determines whether the trading strategy should enforce a full grid of positions or allow partial grid usage.</li> <li>If <code>enforce_full_grid</code> is set to <code>True</code>, the code calculates the required notional amount by dividing the maximum position value by the number of levels.</li> <li>If <code>enforce_full_grid</code> is set to <code>False</code>, the code uses the maximum position value as the required notional amount.</li> <li> <p>Example:</p> <ul> <li>Let's say the maximum position value is $5,000, and the trading strategy uses 5 levels.</li> <li>If <code>enforce_full_grid</code> is <code>True</code>, the required notional amount for each level would be: $5,000 / 5 = $1,000.</li> <li>If <code>enforce_full_grid</code> is <code>False</code>, the required notional amount would be the full $5,000.</li> </ul> </li> <li> <p>Adjusting Maximum Position Value:</p> </li> <li>The code takes into account the current position value (long or short) and adjusts the maximum position value accordingly.</li> <li>It calculates the current position value by multiplying the position quantity (long or short) with the respective best ask or bid price.</li> <li>The adjusted maximum position value is then calculated by subtracting the current position value from the original maximum position value.</li> <li>Example:<ul> <li>Let's say the maximum position value is $5,000, and the trader currently holds a long position with a quantity of 2 units at a best ask price of $100.</li> <li>The current position value would be: 2 * $100 = $200.</li> <li>The adjusted maximum position value would be: $5,000 - $200 = $4,800.</li> <li>This means that the trader can open additional positions with a total value of up to $4,800.</li> </ul> </li> </ul> <p>These risk management parameters and calculations help traders control their exposure to risk, limit potential losses, and manage their positions effectively. By adjusting these parameters based on their risk tolerance and trading strategy, traders can optimize their risk management approach and protect their capital.</p>"},{"location":"configuration/#linear-grid-strategy-parameters","title":"Linear Grid Strategy Parameters","text":"<p>Here are the parameters for the <code>linear_grid</code> strategy in your <code>config.json</code> file:</p> <ul> <li>max_qty_percent_long: Defines the maximum percentage of your wallet balance that can be used for long positions.</li> <li>max_qty_percent_short: Defines the maximum percentage of your wallet balance that can be used for short positions.</li> <li>auto_reduce_cooldown_enabled: Boolean parameter that determines whether the auto-reduce cooldown feature is enabled. This feature automatically reduces the size of your positions after a certain period.</li> <li>auto_reduce_cooldown_start_pct: Defines the percentage at which the auto-reduce cooldown feature starts.</li> <li>wallet_exposure_limit_long: Defines the maximum exposure limit for long positions as a percentage of your wallet balance.</li> <li>wallet_exposure_limit_short: Defines the maximum exposure limit for short positions as a percentage of your wallet balance.</li> <li>levels: Defines the number of grid levels, representing the total number of buy and sell orders placed above and below the current price level.</li> <li>strength: Defines the strength of the grid. A higher value means the grid levels are spaced further apart.</li> <li>outer_price_distance: Defines the distance from the current price to the outermost grid levels.</li> <li>min_outer_price_distance: Defines the minimum distance from the current price to the outermost grid levels.</li> <li>max_outer_price_distance: Defines the maximum distance from the current price to the outermost grid levels.</li> <li>long_mode: Boolean parameter that determines whether the bot can open long positions.</li> <li>short_mode: Boolean parameter that determines whether the bot can open short positions.</li> <li>reissue_threshold: Defines the threshold at which the bot will reissue orders that have been partially filled.</li> <li>buffer_percentage: Defines the buffer percentage for the grid. This is the percentage of the price range kept empty between the outermost grid levels and the upper and lower price limits.</li> <li>initial_entry_buffer_pct: Defines the buffer percentage for the initial entry.</li> <li>min_buffer_percentage: Defines the minimum buffer percentage for the grid.</li> <li>max_buffer_percentage: Defines the maximum buffer percentage for the grid.</li> <li>enforce_full_grid: Boolean parameter that determines whether the bot should always maintain a full grid of orders.</li> <li>min_buffer_percentage_ar: Defines the minimum buffer percentage for auto-reduce.</li> <li>max_buffer_percentage_ar: Defines the maximum buffer percentage for auto-reduce.</li> <li>upnl_auto_reduce_threshold_long: Defines the unrealized profit and loss (UPNL) threshold for auto-reducing long positions.</li> <li>upnl_auto_reduce_threshold_short: Defines the UPNL threshold for auto-reducing short positions.</li> <li>failsafe_enabled: Boolean parameter that determines whether the failsafe feature is enabled. This feature automatically closes all positions if the UPNL reaches a certain threshold.</li> <li>failsafe_start_pct: Defines the percentage at which the failsafe feature starts.</li> <li>long_failsafe_upnl_pct: Defines the UPNL percentage for the long failsafe.</li> <li>short_failsafe_upnl_pct: Defines the UPNL percentage for the short failsafe.</li> </ul>"},{"location":"configuration/#example-configuration-snippet","title":"Example Configuration Snippet","text":"<pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0029,\n        \"max_upnl_profit_pct\": 0.0040,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 50,\n        \"min_qty_threshold\": 0,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"BTCUSDT\", \"ETHUSDT\"],\n        \"whitelist\": [],\n        \"dashboard_enabled\": false,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"grid_behavior\": \"infinite\",\n            \"drawdown_behavior\": \"maxqtypercent\",\n            \"target_coins_mode\": false,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 30,\n            \"max_qty_percent_short\": 30,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 0.006,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": true,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 30.0,\n            \"upnl_auto_reduce_threshold_short\": 30.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.07,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n          \"name\": \"bybit\",\n          \"account_name\": \"account_1\",\n          \"symbols_allowed\": 10\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n</code></pre>"},{"location":"control_center/","title":"Control Center","text":""},{"location":"control_center/#configuring-the-password","title":"Configuring the Password","text":"<ol> <li>Open the <code>config.toml</code> file in the <code>directionalscalper/controlcenter/</code> directory in a text editor:    <code>nano config.toml</code></li> <li>Add or update the <code>[credentials]</code> section with your desired password:    <code>[credentials]    password = \"your_password_here\"</code></li> <li>Save the file and close the editor.</li> </ol>"},{"location":"control_center/#starting-the-streamlit-dashboard","title":"Starting the Streamlit Dashboard","text":"<p>To start the Streamlit dashboard (Control Center) for Directional Scalper, follow these steps:</p> <ol> <li>Navigate to the <code>directionalscalper/controlcenter/</code> directory:    <code>cd directionalscalper/controlcenter/</code></li> <li>Ensure you have Streamlit installed. If not, you can install it using:    <code>pip install streamlit</code></li> <li>Run the dashboard using Streamlit:    <code>streamlit run dashboard.py</code></li> <li>The dashboard will prompt for a password. You need to configure this password in the <code>config.toml</code> file located in the same directory.</li> </ol>"},{"location":"control_center/#accessing-the-dashboard","title":"Accessing the Dashboard","text":"<p>Once the dashboard is running, you can access it through your web browser by navigating to the local URL provided by Streamlit (usually <code>http://localhost:8501</code>). Ensure that your firewall or network settings allow access to this port if you are accessing it remotely.</p>"},{"location":"installation/","title":"Installation","text":""},{"location":"installation/#vps-setup","title":"VPS Setup","text":"<p>To set up a VPS (Virtual Private Server) for running the bot, follow these steps:</p> <ol> <li> <p>Choose a VPS Provider: Select a VPS provider such as Hetzner, DigitalOcean, AWS, or Linode. For optimal performance, it is recommended to use a Hetzner 4 core 8GB Intel server. Create an account and set up a new VPS instance with at least 4 Cores and 8GB of RAM and a suitable operating system (e.g., Ubuntu 20.04).</p> </li> <li> <p>Connect to Your VPS: Use SSH to connect to your VPS. Replace <code>your_vps_ip</code> with the IP address of your VPS.    <code>ssh root@your_vps_ip</code></p> </li> <li> <p>Update and Upgrade Packages: Ensure your VPS is up to date.    <code>sudo apt update &amp;&amp; sudo apt upgrade -y</code></p> </li> <li> <p>Install Python 3.11: Follow the instructions in the \"Installing Python 3.11\" section below to install Python 3.11 on your VPS.</p> </li> <li> <p>Install Git: If Git is not already installed, install it using:    <code>sudo apt install git -y</code></p> </li> <li> <p>Clone the Repository: Clone the Directional Scalper repository to your VPS:    <code>git clone https://github.com/donewiththedollar/directionalscalper.git</code></p> </li> <li> <p>Install Dependencies: Install the required Python dependencies.    <code>pip3.11 install -r requirements.txt</code></p> </li> <li> <p>Configure the Bot: Rename the configuration files and add your API keys as described in the \"Quickstart\" section.</p> </li> <li> <p>Run the Bot: Start the bot using the appropriate command as described in the \"Quickstart\" section.</p> </li> </ol>"},{"location":"installation/#prerequisites","title":"Prerequisites","text":"<p>Before you begin, ensure you have the following prerequisites:</p> <ul> <li>Python 3.11+</li> <li>pip</li> <li>git</li> </ul>"},{"location":"installation/#quickstart","title":"Quickstart","text":"<ol> <li> <p>Clone the repository:    <code>git clone https://github.com/donewiththedollar/directionalscalper.git</code></p> <p>Change current working directory to the project directory: <code>cd directionalscalper</code></p> </li> <li> <p>Install the required dependencies:    <code>pip3.11 install -r requirements.txt</code></p> </li> <li> <p>Rename the <code>config_example.json</code> to <code>config.json</code> located in the <code>/configs</code> folder. Also rename <code>account_example.json</code> to <code>account.json</code> and add your API key(s) to the <code>account.json</code> file located in the <code>/configs</code> folder.</p> </li> <li> <p>Run the bot:</p> </li> <li>To display the menu and select a strategy, use the following command:      <code>python3.11 multi_bot_aio.py --config configs/config.json</code>      or the old method      <code>python3.11 multi_bot_v4.py --config config.json (outdated)</code></li> <li>Alternatively, you can run the bot with command line parameters:<ul> <li>For the multi-bot auto symbol rotator strategy:    <code>python3.11 multi_bot_v3.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></li> <li>For the old single coin strategy (outdated):    <code>python3.11 bot.py --exchange bybit --symbol DOGEUSDT --strategy qstrendob --config configs/config.json</code></li> </ul> </li> </ol>"},{"location":"installation/#installing-python-311","title":"Installing Python 3.11","text":"<p>To install Python 3.11 on your system, follow these steps:</p> <ol> <li> <p>Update the package list and install the necessary dependencies:    <code>sudo apt update    sudo apt install -y build-essential gdb lcov pkg-config \\    libbz2-dev libffi-dev libgdbm-dev libgdbm-compat-dev liblzma-dev \\    libncurses5-dev libreadline-dev libsqlite3-dev libssl-dev \\    lzma lzma-dev tk-dev uuid-dev zlib1g-dev</code></p> </li> <li> <p>Download the Python 3.11.0 source code:    <code>cd /opt    wget https://www.python.org/ftp/python/3.11.0/Python-3.11.0.tgz</code></p> </li> <li> <p>Extract the downloaded archive:    <code>sudo tar -xzf Python-3.11.0.tgz</code></p> </li> <li> <p>Change to the extracted directory:    <code>cd Python-3.11.0</code></p> </li> <li> <p>Configure the build with optimizations:    <code>sudo ./configure --enable-optimizations --prefix=/usr/local</code></p> </li> <li> <p>Compile Python:    <code>sudo make -j 8</code></p> </li> <li> <p>Install Python 3.11:    <code>sudo make altinstall</code></p> </li> <li> <p>Verify the installation:    <code>python3.11 --version</code></p> </li> </ol> <p>You should see the installed Python version displayed.</p> <p>That's it! You have now installed Python 3.11 on your system.</p>"},{"location":"risk_management/","title":"Risk Management in DirectionalScalper","text":"<p>This document explains the risk management strategies implemented in the trading bot, focusing on four key parameters from the configuration.</p>"},{"location":"risk_management/#example-key-configuration-parameters","title":"Example Key Configuration Parameters","text":"<ol> <li><code>wallet_exposure_limit_long</code>: 0.013 (1.3%)</li> <li><code>wallet_exposure_limit_short</code>: 0.004 (0.4%)</li> <li><code>max_qty_percent_long</code>: 10%</li> <li><code>max_qty_percent_short</code>: 10%</li> </ol>"},{"location":"risk_management/#understanding-the-parameters","title":"Understanding the Parameters","text":""},{"location":"risk_management/#wallet-exposure-limits","title":"Wallet Exposure Limits","text":"<p>The <code>wallet_exposure_limit_long</code> and <code>wallet_exposure_limit_short</code> parameters define the maximum percentage of the total equity that can be allocated to long and short positions, respectively.</p> <ul> <li>Long positions: Up to 1.3% of total equity</li> <li>Short positions: Up to 0.4% of total equity</li> </ul> <p>These limits help prevent overexposure to any single trading direction and maintain a balanced risk profile.</p>"},{"location":"risk_management/#maximum-quantity-percentages","title":"Maximum Quantity Percentages","text":"<p>The <code>max_qty_percent_long</code> and <code>max_qty_percent_short</code> parameters set the maximum allowed position size as a percentage of the total equity for long and short positions, respectively.</p> <ul> <li>Both long and short positions: Up to 10% of total equity</li> </ul> <p>These limits act as an additional safety measure to prevent any single position from becoming too large relative to the total equity.</p>"},{"location":"risk_management/#risk-management-implementation","title":"Risk Management Implementation","text":"<p>The bot implements risk management through the <code>check_and_manage_positions</code> function. Here's how it works:</p> <ol> <li>Calculate Maximum Allowed Positions:</li> <li>For long positions: <code>max_qty_long = (total_equity * wallet_exposure_limit_long) / current_price</code></li> <li> <p>For short positions: <code>max_qty_short = (total_equity * wallet_exposure_limit_short) / current_price</code></p> </li> <li> <p>Calculate Position Exposure Percentages:</p> </li> <li>Long exposure: <code>(long_pos_qty * current_price / total_equity) * 100</code></li> <li> <p>Short exposure: <code>(short_pos_qty * current_price / total_equity) * 100</code></p> </li> <li> <p>Check Against Maximum Quantity Percentages:</p> </li> <li>If long exposure &gt; <code>max_qty_percent_long</code>:<ul> <li>Clear long grid</li> <li>Remove symbol from active grids</li> <li>Add symbol to <code>max_qty_reached_symbol_long</code> set</li> </ul> </li> <li> <p>If short exposure &gt; <code>max_qty_percent_short</code>:</p> <ul> <li>Clear short grid</li> <li>Remove symbol from active grids</li> <li>Add symbol to <code>max_qty_reached_symbol_short</code> set</li> </ul> </li> <li> <p>Recovery Mechanism:</p> </li> <li>If a symbol's exposure falls below the maximum allowed percentage, it is removed from the respective <code>max_qty_reached_symbol</code> set, allowing trading to resume.</li> </ol>"},{"location":"risk_management/#additional-risk-management-features","title":"Additional Risk Management Features","text":""},{"location":"risk_management/#proper-dca-dollar-cost-averaging-implementation","title":"Proper DCA (Dollar Cost Averaging) Implementation","text":"<p>The bot uses two functions for implementing a proper DCA strategy:</p> <ol> <li><code>calculate_total_amount_notional_ls_properdca</code>:</li> <li>Calculates the total notional amount for a grid based on the wallet exposure limits and current position values.</li> <li> <p>Ensures that the total position value (including existing positions) doesn't exceed the maximum allowed exposure.</p> </li> <li> <p><code>calculate_order_amounts_notional_properdca</code>:</p> </li> <li>Distributes the total notional amount across multiple orders in the grid.</li> <li>Uses a strength parameter to adjust the distribution, allowing for more aggressive or conservative strategies.</li> <li>Ensures that each order meets minimum notional and quantity requirements set by the exchange.</li> </ol>"},{"location":"risk_management/#grid-management","title":"Grid Management","text":"<ul> <li>The bot clears grids when position sizes exceed the maximum allowed percentages.</li> <li>It uses sets (<code>max_qty_reached_symbol_long</code> and <code>max_qty_reached_symbol_short</code>) to track symbols that have reached their maximum allowed quantities.</li> <li>Trading is paused for symbols in these sets until their exposure falls below the maximum allowed percentage.</li> </ul>"},{"location":"risk_management/#conclusion","title":"Conclusion","text":"<p>This risk management system provides a comprehensive approach to controlling exposure and managing position sizes. By using wallet exposure limits and maximum quantity percentages, the bot maintains a balanced risk profile while allowing for effective trading across multiple symbols and strategies.</p> <p>The implementation of proper DCA and dynamic grid management further enhances the bot's ability to adapt to market conditions while adhering to predefined risk parameters.</p>"},{"location":"strategies/","title":"Strategies","text":""},{"location":"strategies/#linear-grid-strategy","title":"Linear Grid Strategy","text":""},{"location":"strategies/#overview","title":"Overview","text":"<p>The Linear Grid Strategy is a trading strategy designed to capitalize on market fluctuations by placing multiple buy and sell orders at predefined intervals (grid levels) above and below the current price level. This strategy helps in capturing profits in both upward and downward market movements.</p>"},{"location":"strategies/#configuration-parameters","title":"Configuration Parameters","text":"<p>Here are the parameters for the <code>linear_grid</code> strategy in your <code>config.json</code> file:</p> <ul> <li>max_qty_percent_long: Defines the maximum percentage of your wallet balance that can be used for long positions.</li> <li>max_qty_percent_short: Defines the maximum percentage of your wallet balance that can be used for short positions.</li> <li>auto_reduce_cooldown_enabled: Boolean parameter that determines whether the auto-reduce cooldown feature is enabled. This feature automatically reduces the size of your positions after a certain period.</li> <li>auto_reduce_cooldown_start_pct: Defines the percentage at which the auto-reduce cooldown feature starts.</li> <li>wallet_exposure_limit_long: Defines the maximum exposure limit for long positions as a percentage of your wallet balance.</li> <li>wallet_exposure_limit_short: Defines the maximum exposure limit for short positions as a percentage of your wallet balance.</li> <li>levels: Defines the number of grid levels, representing the total number of buy and sell orders placed above and below the current price level.</li> <li>strength: Defines the strength of the grid. A higher value means the grid levels are spaced further apart.</li> <li>outer_price_distance: Defines the distance from the current price to the outermost grid levels.</li> <li>min_outer_price_distance: Defines the minimum distance from the current price to the outermost grid levels.</li> <li>max_outer_price_distance: Defines the maximum distance from the current price to the outermost grid levels.</li> <li>long_mode: Boolean parameter that determines whether the bot can open long positions.</li> <li>short_mode: Boolean parameter that determines whether the bot can open short positions.</li> <li>reissue_threshold: Defines the threshold at which the bot will reissue orders that have been partially filled.</li> <li>buffer_percentage: Defines the buffer percentage for the grid. This is the percentage of the price range kept empty between the outermost grid levels and the upper and lower price limits.</li> <li>initial_entry_buffer_pct: Defines the buffer percentage for the initial entry.</li> <li>min_buffer_percentage: Defines the minimum buffer percentage for the grid.</li> <li>max_buffer_percentage: Defines the maximum buffer percentage for the grid.</li> <li>enforce_full_grid: Boolean parameter that determines whether the bot should always maintain a full grid of orders.</li> <li>min_buffer_percentage_ar: Defines the minimum buffer percentage for auto-reduce.</li> <li>max_buffer_percentage_ar: Defines the maximum buffer percentage for auto-reduce.</li> <li>upnl_auto_reduce_threshold_long: Defines the unrealized profit and loss (UPNL) threshold for auto-reducing long positions.</li> <li>upnl_auto_reduce_threshold_short: Defines the UPNL threshold for auto-reducing short positions.</li> <li>failsafe_enabled: Boolean parameter that determines whether the failsafe feature is enabled. This feature automatically closes all positions if the UPNL reaches a certain threshold.</li> <li>failsafe_start_pct: Defines the percentage at which the failsafe feature starts.</li> <li>long_failsafe_upnl_pct: Defines the UPNL percentage for the long failsafe.</li> <li>short_failsafe_upnl_pct: Defines the UPNL percentage for the short failsafe.</li> </ul>"},{"location":"strategies/#example-configurations","title":"Example Configurations","text":""},{"location":"strategies/#example-long-and-short-auto-rotating-futures-configuration","title":"Example long and short auto rotating futures configuration","text":"<p>This strategy is based on machine learning based signals and utilizes a grid with proper DCA so each grid level is \"meaningful\" to bring the position to current market price staying \"sticky\" to price action. </p> <p>Set up your config.json from the below snippet</p> <pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0029,\n        \"max_upnl_profit_pct\": 0.0040,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 50,\n        \"min_qty_threshold\": 0,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"BTCUSDT\", \"ETHUSDT\"],\n        \"whitelist\": [],\n        \"dashboard_enabled\": false,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"grid_behavior\": \"infinite\",\n            \"drawdown_behavior\": \"maxqtypercent\",\n            \"target_coins_mode\": false,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 30,\n            \"max_qty_percent_short\": 30,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 0.006,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": true,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 30.0,\n            \"upnl_auto_reduce_threshold_short\": 30.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.07,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n          \"name\": \"bybit\",\n          \"account_name\": \"account_1\",\n          \"symbols_allowed\": 10\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n</code></pre> <p>Now, just run the bot using this multibot version and strategy</p> <p><code>python3.11 multi_bot_aio.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p>"},{"location":"strategies/#example-long-only-solusdt-futures-configuration","title":"Example long only SOLUSDT futures configuration","text":"<p>Set up your config.json from the below snippet to whitelist SOLUSDT and set max USD value to a higher value to allow for the symbol.</p> <p><code>max_qty_percent_long</code> and <code>max_qty_pct_short</code> are set high in this configuration, you can adjust them as needed these are just defaults for testing purposes.</p> <pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0032,\n        \"max_upnl_profit_pct\": 0.0039,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 1000,\n        \"min_qty_threshold\": 0,\n        \"long_liq_pct\": 0.05,\n        \"short_liq_pct\": 0.05,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"BTCUSDT\", \"ETHUSDT\"],\n        \"whitelist\": [\"SOLUSDT\"],\n        \"dashboard_enabled\": true,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"grid_behavior\": \"infinite\",\n            \"drawdown_behavior\": \"maxqtypercent\",\n            \"target_coins_mode\": true,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 10000,\n            \"max_qty_percent_short\": 10000,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 1,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": false,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 10.0,\n            \"upnl_auto_reduce_threshold_short\": 10.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.05,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n            \"name\": \"bybit\",\n            \"account_name\": \"account_1\",\n            \"symbols_allowed\": 2\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n\n</code></pre> <p>Now, just run the bot using this multibot version and strategy</p> <p><code>python3.11 multi_bot_aio.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p> <p>This is just a simple example of a long only BTCUSDT strategy to show how one can utilize a single strategy for many use case scenarios on different instruments.</p>"},{"location":"strategies/#example-high-risk-small-account-longshort-btcusdt-futures-configuration","title":"Example High risk small account long&amp;short BTCUSDT futures configuration","text":"<p>Set up your config.json from the below snippet to whitelist BTCUSDT and set max USD value to a high value to allow for the symbol.</p> <p><code>max_qty_percent_long</code> and <code>max_qty_pct_short</code> are set high in this configuration, you can adjust them as needed these are just defaults for testing purposes.</p> <pre><code>{\n    \"api\": {\n        \"filename\": \"quantdatav2_bybit.json\",\n        \"mode\": \"remote\",\n        \"url\": \"https://api.quantumvoid.org/volumedata/\",\n        \"data_source_exchange\": \"bybit\"\n    },\n    \"bot\": {\n        \"bot_name\": \"your_bot_name\",\n        \"volume_check\": false,\n        \"min_distance\": 0.15,\n        \"min_volume\": 10000,\n        \"upnl_profit_pct\": 0.0032,\n        \"max_upnl_profit_pct\": 0.0039,\n        \"auto_reduce_enabled\": false,\n        \"auto_reduce_start_pct\": 0.068,\n        \"entry_during_autoreduce\": false,\n        \"stoploss_enabled\": false,\n        \"stoploss_upnl_pct\": 0.05,\n        \"liq_stoploss_enabled\": false,\n        \"liq_price_stop_pct\": 0.50,\n        \"percentile_auto_reduce_enabled\": false,\n        \"upnl_threshold_pct\": 0.50,\n        \"max_pos_balance_pct\": 0.50,\n        \"auto_reduce_wallet_exposure_pct\": 0.20,\n        \"auto_reduce_maxloss_pct\": 0.30,\n        \"auto_reduce_marginbased_enabled\": false,\n        \"hedge_ratio\": 0.10,\n        \"hedge_price_difference_threshold\": 0.10,\n        \"test_orders_enabled\": false,\n        \"max_usd_value\": 1000,\n        \"min_qty_threshold\": 0,\n        \"long_liq_pct\": 0.05,\n        \"short_liq_pct\": 0.05,\n        \"MaxAbsFundingRate\": 0.0002,\n        \"blacklist\": [\"ETHUSDT\"],\n        \"whitelist\": [\"BTCUSDT\"],\n        \"dashboard_enabled\": true,\n        \"shared_data_path\": \"data/\",\n        \"linear_grid\": {\n            \"grid_behavior\": \"infinite\",\n            \"drawdown_behavior\": \"maxqtypercent\",\n            \"target_coins_mode\": true,\n            \"auto_graceful_stop\": false,\n            \"entry_signal_type\": \"lorentzian\",\n            \"additional_entries_from_signal\": true,\n            \"graceful_stop_long\": false,\n            \"graceful_stop_short\": false,\n            \"max_qty_percent_long\": 10000,\n            \"max_qty_percent_short\": 10000,\n            \"auto_reduce_cooldown_enabled\": false,\n            \"auto_reduce_cooldown_start_pct\": 0.051,\n            \"wallet_exposure_limit_long\": 1,\n            \"wallet_exposure_limit_short\": 0.002,\n            \"levels\": 4,\n            \"strength\": 1.4,\n            \"outer_price_distance\": 0.059,\n            \"min_outer_price_distance\": 0.019,\n            \"max_outer_price_distance\": 0.049,\n            \"long_mode\": true,\n            \"short_mode\": true,\n            \"reissue_threshold\": 0.001,\n            \"buffer_percentage\": 0.10,\n            \"initial_entry_buffer_pct\": 0.0001,\n            \"min_buffer_percentage\": 0.0035,\n            \"max_buffer_percentage\": 0.010,\n            \"enforce_full_grid\": true,\n            \"min_buffer_percentage_ar\": 0.002,\n            \"max_buffer_percentage_ar\": 0.004,\n            \"upnl_auto_reduce_threshold_long\": 10.0,\n            \"upnl_auto_reduce_threshold_short\": 10.0,\n            \"failsafe_enabled\": false,\n            \"failsafe_start_pct\": 0.05,\n            \"long_failsafe_upnl_pct\": 10.0,\n            \"short_failsafe_upnl_pct\": 10.0\n        },\n        \"hotkeys\": {\n            \"hotkeys_enabled\": false,\n            \"enter_long\": \"1\",\n            \"take_profit_long\": \"2\",\n            \"enter_short\": \"3\",\n            \"take_profit_short\": \"4\"\n        }\n    },\n    \"exchanges\": [\n        {\n            \"name\": \"bybit\",\n            \"account_name\": \"account_1\",\n            \"symbols_allowed\": 2\n        },\n        {\n            \"name\": \"bybit_spot\",\n            \"account_name\": \"account_2\",\n            \"symbols_allowed\": 5\n        },\n        {\n            \"name\": \"bybit_unified\",\n            \"account_name\": \"account_3\",\n            \"symbols_allowed\": 5\n        }\n    ],\n    \"logger\": {\n        \"level\": \"info\"\n    },\n    \"messengers\": {\n        \"discord\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"discord\",\n            \"webhook_url\": \"https://discord.com/api/webhooks/your_webhook_id/your_webhook_token\"\n        },\n        \"telegram\": {\n            \"active\": false,\n            \"embedded_messages\": true,\n            \"messenger_type\": \"telegram\",\n            \"bot_token\": \"your_bot_token\",\n            \"chat_id\": \"your_chat_id\"\n        }\n    }\n  }\n\n</code></pre> <p>Now, just run the bot using this multibot version and strategy</p> <p><code>python3.11 multi_bot_signalscreener_targetcoin.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p> <p>This is an aggressive approach because it utilizes a high <code>max_qty_percent_long</code> and <code>max_qty_percent_short</code> on a small wallet balance (ie $100 USD) for a symbol with a high USD value with the min notional requirement for BTCUSDT on Bybit it is inherently more risky but also more profitable.</p>"},{"location":"usage/","title":"Usage","text":"<p>This guide will help you run the Directional Scalper bot using various command-line instructions. Ensure you have properly configured your <code>config.json</code> and <code>account.json</code> files before proceeding.</p>"},{"location":"usage/#running-the-bot","title":"Running the Bot","text":""},{"location":"usage/#easy-update-configuration-file-with-latest-parameters","title":"Easy update configuration file with latest parameters","text":"<pre><code>pip3.11 install -r requirements.txt &amp;&amp; python3.11 update_config.py --config configs/config.json &amp;&amp; mv configs/config.json.new configs/config.json\n</code></pre> <pre><code>python3.11 multi_bot_v4.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json\n</code></pre>"},{"location":"usage/#displaying-the-menu-and-selecting-a-strategy","title":"Displaying the Menu and Selecting a Strategy","text":"<p>To display the menu and select a strategy, use the following command:</p> <pre><code>python3.11 multi_bot_v4.py --config configs/config.json\n</code></pre> <p>or</p> <pre><code>python3.11 multi_bot_v4.py --config configs/config.json\n</code></pre>"},{"location":"usage/#running-the-bot-with-command-line-parameters","title":"Running the Bot with Command Line Parameters","text":"<p>You can also run the bot directly with specific command-line parameters. Below are examples of different strategies you can use:</p>"},{"location":"usage/#multi-bot-auto-symbol-rotator-strategy","title":"Multi-Bot Auto Symbol Rotator Strategy","text":"<p>To run the multi-bot auto symbol rotator strategy, use the following command:</p> <pre><code>python3.11 multi_bot_v4.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json\n</code></pre>"},{"location":"usage/#old-single-coin-strategy","title":"Old Single Coin Strategy","text":"<p>To run the old single coin strategy, use the following command: (likely very outdated, but can be updated by anyone or per request)</p> <pre><code>python3.11 bot.py --exchange bybit --symbol DOGEUSDT --strategy qstrendob --config configs/config.json\n</code></pre>"},{"location":"usage/#command-line-parameters","title":"Command Line Parameters","text":""},{"location":"usage/#general-parameters","title":"General Parameters","text":"<ul> <li>--exchange: Specifies the exchange to use (e.g., bybit, binance).</li> <li>--account_name: Specifies the account name as defined in your <code>account.json</code>.</li> <li>--strategy: Specifies the trading strategy to use (e.g., qsgridob, qstrendob).</li> <li>--config: Specifies the path to your <code>config.json</code> file.</li> </ul>"},{"location":"usage/#example-commands","title":"Example Commands","text":"<ol> <li>Running the Multi-Bot Auto Symbol Rotator Strategy for Bybit:</li> </ol> <p><code>python3.11 multi_bot_v4.py --exchange bybit --account_name account_1 --strategy qsgridob --config configs/config.json</code></p> <ol> <li>Running the Old Single Coin Strategy for DOGEUSDT on Bybit:</li> </ol> <p><code>python3.11 bot.py --exchange bybit --symbol DOGEUSDT --strategy qstrendob --config configs/config.json</code></p>"},{"location":"usage/#additional-notes","title":"Additional Notes","text":"<ul> <li>Make sure to adjust the leverage, risk management, and other parameters in your <code>config.json</code> to suit your trading preferences.</li> <li>For advanced usage and more strategies, refer to the Configuration and Strategies sections of the documentation.</li> </ul> <p>This guide provides a straightforward approach to running the Directional Scalper bot with various strategies and configurations. If you encounter any issues, refer to the relevant sections of the documentation for more details.</p>"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 8ea9fb7c..253397b2 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/strategies/index.html b/strategies/index.html
index 407d5712..c7cc2db9 100644
--- a/strategies/index.html
+++ b/strategies/index.html
@@ -909,6 +909,8 @@ <h3 id="example-long-and-short-auto-rotating-futures-configuration">Example long
         &quot;dashboard_enabled&quot;: false,
         &quot;shared_data_path&quot;: &quot;data/&quot;,
         &quot;linear_grid&quot;: {
+            &quot;grid_behavior&quot;: &quot;infinite&quot;,
+            &quot;drawdown_behavior&quot;: &quot;maxqtypercent&quot;,
             &quot;target_coins_mode&quot;: false,
             &quot;auto_graceful_stop&quot;: false,
             &quot;entry_signal_type&quot;: &quot;lorentzian&quot;,
@@ -1033,6 +1035,8 @@ <h3 id="example-long-only-solusdt-futures-configuration">Example long only SOLUS
         &quot;dashboard_enabled&quot;: true,
         &quot;shared_data_path&quot;: &quot;data/&quot;,
         &quot;linear_grid&quot;: {
+            &quot;grid_behavior&quot;: &quot;infinite&quot;,
+            &quot;drawdown_behavior&quot;: &quot;maxqtypercent&quot;,
             &quot;target_coins_mode&quot;: true,
             &quot;auto_graceful_stop&quot;: false,
             &quot;entry_signal_type&quot;: &quot;lorentzian&quot;,
@@ -1159,6 +1163,8 @@ <h3 id="example-high-risk-small-account-longshort-btcusdt-futures-configuration"
         &quot;dashboard_enabled&quot;: true,
         &quot;shared_data_path&quot;: &quot;data/&quot;,
         &quot;linear_grid&quot;: {
+            &quot;grid_behavior&quot;: &quot;infinite&quot;,
+            &quot;drawdown_behavior&quot;: &quot;maxqtypercent&quot;,
             &quot;target_coins_mode&quot;: true,
             &quot;auto_graceful_stop&quot;: false,
             &quot;entry_signal_type&quot;: &quot;lorentzian&quot;,