From 70e9fa6136a0d7705dfe6a72e0315467d6c0a838 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Tue, 27 Dec 2022 20:14:39 +0100
Subject: [PATCH 001/147] implementing the strategy_updater in a first version

---
 freqtrade/commands/__init__.py                |   1 +
 freqtrade/commands/arguments.py               |  14 +-
 freqtrade/commands/strategy_utils_commands.py |  37 +++
 freqtrade/strategy/strategy_updater.py        | 213 ++++++++++++++++++
 4 files changed, 263 insertions(+), 2 deletions(-)
 create mode 100644 freqtrade/commands/strategy_utils_commands.py
 create mode 100644 freqtrade/strategy/strategy_updater.py

diff --git a/freqtrade/commands/__init__.py b/freqtrade/commands/__init__.py
index 788657cc8..66a9c995b 100644
--- a/freqtrade/commands/__init__.py
+++ b/freqtrade/commands/__init__.py
@@ -22,5 +22,6 @@ from freqtrade.commands.optimize_commands import (start_backtesting, start_backt
                                                   start_edge, start_hyperopt)
 from freqtrade.commands.pairlist_commands import start_test_pairlist
 from freqtrade.commands.plot_commands import start_plot_dataframe, start_plot_profit
+from freqtrade.commands.strategy_utils_commands import start_strategy_update
 from freqtrade.commands.trade_commands import start_trading
 from freqtrade.commands.webserver_commands import start_webserver
diff --git a/freqtrade/commands/arguments.py b/freqtrade/commands/arguments.py
index b53a1022d..9990ad230 100644
--- a/freqtrade/commands/arguments.py
+++ b/freqtrade/commands/arguments.py
@@ -115,6 +115,8 @@ NO_CONF_REQURIED = ["convert-data", "convert-trade-data", "download-data", "list
 
 NO_CONF_ALLOWED = ["create-userdir", "list-exchanges", "new-strategy"]
 
+ARGS_STRATEGY_UTILS = ARGS_COMMON_OPTIMIZE + ["strategy_list"]
+
 
 class Arguments:
     """
@@ -198,8 +200,8 @@ class Arguments:
                                         start_list_freqAI_models, start_list_markets,
                                         start_list_strategies, start_list_timeframes,
                                         start_new_config, start_new_strategy, start_plot_dataframe,
-                                        start_plot_profit, start_show_trades, start_test_pairlist,
-                                        start_trading, start_webserver)
+                                        start_plot_profit, start_show_trades, start_strategy_update,
+                                        start_test_pairlist, start_trading, start_webserver)
 
         subparsers = self.parser.add_subparsers(dest='command',
                                                 # Use custom message when no subhandler is added
@@ -440,3 +442,11 @@ class Arguments:
                                               parents=[_common_parser])
         webserver_cmd.set_defaults(func=start_webserver)
         self._build_args(optionlist=ARGS_WEBSERVER, parser=webserver_cmd)
+
+        # Add strategy_updater subcommand
+        strategy_updater_cmd = subparsers.add_parser('strategy-updater',
+                                                     help='updates outdated strategy'
+                                                          'files to the current version',
+                                                     parents=[_common_parser])
+        strategy_updater_cmd.set_defaults(func=start_strategy_update)
+        self._build_args(optionlist=ARGS_STRATEGY_UTILS, parser=strategy_updater_cmd)
diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
new file mode 100644
index 000000000..b9431fecf
--- /dev/null
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -0,0 +1,37 @@
+import logging
+from typing import Any, Dict
+
+from freqtrade.configuration import setup_utils_configuration
+from freqtrade.enums import RunMode
+from freqtrade.resolvers import StrategyResolver
+
+
+logger = logging.getLogger(__name__)
+
+
+def start_strategy_update(args: Dict[str, Any]) -> None:
+    """
+    Start the strategy updating script
+    :param args: Cli args from Arguments()
+    :return: None
+    """
+
+    # Import here to avoid loading backtesting module when it's not used
+    from freqtrade.strategy.strategy_updater import strategy_updater
+
+    config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
+
+    strategy_objs = StrategyResolver.search_all_objects(
+        config, enum_failed=True, recursive=config.get('recursive_strategy_search', False))
+
+    filtered_strategy_objs = []
+    for args_strategy in args['strategy_list']:
+        for strategy_obj in strategy_objs:
+            if strategy_obj['name'] == args_strategy and strategy_obj not in filtered_strategy_objs:
+                filtered_strategy_objs.append(strategy_obj)
+                break
+
+    for filtered_strategy_obj in filtered_strategy_objs:
+        # Initialize backtesting object
+        instance_strategy_updater = strategy_updater()
+        strategy_updater.start(instance_strategy_updater, filtered_strategy_obj)
diff --git a/freqtrade/strategy/strategy_updater.py b/freqtrade/strategy/strategy_updater.py
new file mode 100644
index 000000000..fea8edf31
--- /dev/null
+++ b/freqtrade/strategy/strategy_updater.py
@@ -0,0 +1,213 @@
+import ast
+import os
+import shutil
+
+
+class strategy_updater:
+    name_mapping = {
+        'ticker_interval': 'timeframe',
+        'buy': 'enter_long',
+        'sell': 'exit_long',
+        'buy_tag': 'enter_tag',
+        'sell_reason': 'exit_reason',
+
+        'sell_signal': 'exit_signal',
+        'custom_sell': 'custom_exit',
+        'force_sell': 'force_exit',
+        'emergency_sell': 'emergency_exit',
+
+        # Strategy/config settings:
+        'use_sell_signal': 'use_exit_signal',
+        'sell_profit_only': 'exit_profit_only',
+        'sell_profit_offset': 'exit_profit_offset',
+        'ignore_roi_if_buy_signal': 'ignore_roi_if_entry_signal',
+        'forcebuy_enable': 'force_entry_enable',
+    }
+
+    function_mapping = {
+        'populate_buy_trend': 'populate_entry_trend',
+        'populate_sell_trend': 'populate_exit_trend',
+        'custom_sell': 'custom_exit',
+        'check_buy_timeout': 'check_entry_timeout',
+        'check_sell_timeout': 'check_exit_timeout',
+        # '': '',
+    }
+    # order_time_in_force, order_types, unfilledtimeout
+    otif_ot_unfilledtimeout = {
+        'buy': 'entry',
+        'sell': 'exit',
+    }
+
+    # create a dictionary that maps the old column names to the new ones
+    rename_dict = {'buy': 'enter_long', 'sell': 'exit_long', 'buy_tag': 'enter_tag'}
+
+    def start(self, strategy_obj: dict) -> None:
+        """
+        Run strategy updater
+        It updates a strategy to v3 with the help of the ast-module
+        :return: None
+        """
+
+        self.cwd = os.getcwd()
+        self.strategies_backup_folder = f'{os.getcwd()}user_data/strategies_orig_updater'
+        source_file = strategy_obj['location']
+
+        # read the file
+        with open(source_file, 'r') as f:
+            old_code = f.read()
+        if not os.path.exists(self.strategies_backup_folder):
+            os.makedirs(self.strategies_backup_folder)
+
+        # backup original
+        # => currently no date after the filename,
+        # could get overridden pretty fast if this is fired twice!
+        shutil.copy(source_file, f"{self.strategies_backup_folder}/{strategy_obj['location_rel']}")
+
+        # update the code
+        new_code = strategy_updater.update_code(self, old_code,
+                                                strategy_updater.name_mapping,
+                                                strategy_updater.function_mapping,
+                                                strategy_updater.rename_dict)
+
+        # write the modified code to the destination folder
+        with open(source_file, 'w') as f:
+            f.write(new_code)
+        print(f"conversion of file {source_file} successful.")
+
+    # define the function to update the code
+    def update_code(self, code, _name_mapping, _function_mapping, _rename_dict):
+        # parse the code into an AST
+        tree = ast.parse(code)
+
+        # use the AST to update the code
+        updated_code = strategy_updater.modify_ast(
+            tree,
+            _name_mapping,
+            _function_mapping,
+            _rename_dict)
+
+        # return the modified code without executing it
+        return updated_code
+
+    # function that uses the ast module to update the code
+    def modify_ast(node, _name_mapping, _function_mapping, _rename_dict): # noqa
+        # create a visitor that will update the names and functions
+        class NameUpdater(ast.NodeTransformer):
+            def generic_visit(self, node):
+                # traverse the AST recursively by calling the visitor method for each child node
+                if hasattr(node, "_fields"):
+                    for field_name, field_value in ast.iter_fields(node):
+                        self.check_fields(field_value)
+                        self.check_strategy_and_config_settings(field_value)
+                        # add this check to handle the case where field_value is a slice
+                        if isinstance(field_value, ast.Slice):
+                            self.visit(field_value)
+                        # add this check to handle the case where field_value is a target
+                        if isinstance(field_value, ast.expr_context):
+                            self.visit(field_value)
+
+            def check_fields(self, field_value):
+                if isinstance(field_value, list):
+                    for item in field_value:
+                        if isinstance(item, ast.AST):
+                            self.visit(item)
+
+            def check_strategy_and_config_settings(self, field_value):
+                if (isinstance(field_value, ast.AST) and
+                        hasattr(node, "targets") and
+                        isinstance(node.targets, list)):
+                    for target in node.targets:
+                        if (hasattr(target, "id") and
+                                (target.id == "order_time_in_force" or
+                                 target.id == "order_types" or
+                                 target.id == "unfilledtimeout") and
+                                hasattr(field_value, "keys") and
+                                isinstance(field_value.keys, list)):
+                            for key in field_value.keys:
+                                self.visit(key)
+
+            def visit_Name(self, node):
+                # if the name is in the mapping, update it
+                if node.id in _name_mapping:
+                    node.id = _name_mapping[node.id]
+                return node
+
+            def visit_Import(self, node):
+                # do not update the names in import statements
+                return node
+
+            def visit_ImportFrom(self, node):
+                # do not update the names in import statements
+                if hasattr(node, "module"):
+                    if node.module == "freqtrade.strategy.hyper":
+                        node.module = "freqtrade.strategy"
+                return node
+
+            def visit_FunctionDef(self, node):
+                # if the function name is in the mapping, update it
+                if node.name in _function_mapping:
+                    node.name = _function_mapping[node.name]
+                return self.generic_visit(node)
+
+            def visit_Attribute(self, node):
+                # if the attribute name is 'nr_of_successful_buys',
+                # update it to 'nr_of_successful_entries'
+                if isinstance(node.value, ast.Name) and \
+                        node.value.id == 'trades' and \
+                        node.attr == 'nr_of_successful_buys':
+                    node.attr = 'nr_of_successful_entries'
+                return self.generic_visit(node)
+
+            def visit_ClassDef(self, node):
+                # check if the class is derived from IStrategy
+                if any(isinstance(base, ast.Name) and
+                       base.id == 'IStrategy' for base in node.bases):
+                    # check if the INTERFACE_VERSION variable exists
+                    has_interface_version = any(
+                        isinstance(child, ast.Assign) and
+                        isinstance(child.targets[0], ast.Name) and
+                        child.targets[0].id == 'INTERFACE_VERSION'
+                        for child in node.body
+                    )
+
+                    # if the INTERFACE_VERSION variable does not exist, add it as the first child
+                    if not has_interface_version:
+                        node.body.insert(0, ast.parse('INTERFACE_VERSION = 3').body[0])
+                    # otherwise, update its value to 3
+                    else:
+                        for child in node.body:
+                            if isinstance(child, ast.Assign) and \
+                                    isinstance(child.targets[0], ast.Name) and \
+                                    child.targets[0].id == 'INTERFACE_VERSION':
+                                child.value = ast.parse('3').body[0].value
+                return self.generic_visit(node)
+
+            def visit_Subscript(self, node):
+                if isinstance(node.slice, ast.Constant):
+                    if node.slice.value in strategy_updater.rename_dict:
+                        # Replace the slice attributes with the values from rename_dict
+                        node.slice.value = strategy_updater.rename_dict[node.slice.value]
+                if hasattr(node.slice, "elts"):
+                    for elt in node.slice.elts:
+                        if isinstance(elt, ast.Constant) and \
+                                elt.value in strategy_updater.rename_dict:
+                            elt.value = strategy_updater.rename_dict[elt.value]
+                return node
+
+            def visit_Constant(self, node):
+                # do not update the names in import statements
+                if node.value in \
+                        strategy_updater.otif_ot_unfilledtimeout:
+                    node.value = \
+                        strategy_updater.otif_ot_unfilledtimeout[node.value]
+                return node
+
+        # use the visitor to update the names and functions in the AST
+        NameUpdater().visit(node)
+
+        # first fix the comments so it understands "\n" properly inside multi line comments.
+        ast.fix_missing_locations(node)
+        ast.increment_lineno(node, n=1)
+
+        # generate the new code from the updated AST
+        return ast.unparse(node)

From c6f045afa96c30bbd612af4b5877aeb41834d8fe Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Thu, 29 Dec 2022 22:17:52 +0100
Subject: [PATCH 002/147] fixing issues of the maintainer found a bug meaning
 elts could contain lists of elts (now recurively gone through)

Next in line: writing tests based on StrategyUpdater.update_code
---
 freqtrade/commands/strategy_utils_commands.py |   6 +-
 freqtrade/strategy/strategy_updater.py        | 213 -----------------
 freqtrade/strategy/strategyupdater.py         | 225 ++++++++++++++++++
 3 files changed, 228 insertions(+), 216 deletions(-)
 delete mode 100644 freqtrade/strategy/strategy_updater.py
 create mode 100644 freqtrade/strategy/strategyupdater.py

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index b9431fecf..13405089f 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -17,7 +17,7 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     """
 
     # Import here to avoid loading backtesting module when it's not used
-    from freqtrade.strategy.strategy_updater import strategy_updater
+    from freqtrade.strategy.strategyupdater import StrategyUpdater
 
     config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
 
@@ -33,5 +33,5 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
 
     for filtered_strategy_obj in filtered_strategy_objs:
         # Initialize backtesting object
-        instance_strategy_updater = strategy_updater()
-        strategy_updater.start(instance_strategy_updater, filtered_strategy_obj)
+        instance_strategy_updater = StrategyUpdater()
+        StrategyUpdater.start(instance_strategy_updater, config, filtered_strategy_obj)
diff --git a/freqtrade/strategy/strategy_updater.py b/freqtrade/strategy/strategy_updater.py
deleted file mode 100644
index fea8edf31..000000000
--- a/freqtrade/strategy/strategy_updater.py
+++ /dev/null
@@ -1,213 +0,0 @@
-import ast
-import os
-import shutil
-
-
-class strategy_updater:
-    name_mapping = {
-        'ticker_interval': 'timeframe',
-        'buy': 'enter_long',
-        'sell': 'exit_long',
-        'buy_tag': 'enter_tag',
-        'sell_reason': 'exit_reason',
-
-        'sell_signal': 'exit_signal',
-        'custom_sell': 'custom_exit',
-        'force_sell': 'force_exit',
-        'emergency_sell': 'emergency_exit',
-
-        # Strategy/config settings:
-        'use_sell_signal': 'use_exit_signal',
-        'sell_profit_only': 'exit_profit_only',
-        'sell_profit_offset': 'exit_profit_offset',
-        'ignore_roi_if_buy_signal': 'ignore_roi_if_entry_signal',
-        'forcebuy_enable': 'force_entry_enable',
-    }
-
-    function_mapping = {
-        'populate_buy_trend': 'populate_entry_trend',
-        'populate_sell_trend': 'populate_exit_trend',
-        'custom_sell': 'custom_exit',
-        'check_buy_timeout': 'check_entry_timeout',
-        'check_sell_timeout': 'check_exit_timeout',
-        # '': '',
-    }
-    # order_time_in_force, order_types, unfilledtimeout
-    otif_ot_unfilledtimeout = {
-        'buy': 'entry',
-        'sell': 'exit',
-    }
-
-    # create a dictionary that maps the old column names to the new ones
-    rename_dict = {'buy': 'enter_long', 'sell': 'exit_long', 'buy_tag': 'enter_tag'}
-
-    def start(self, strategy_obj: dict) -> None:
-        """
-        Run strategy updater
-        It updates a strategy to v3 with the help of the ast-module
-        :return: None
-        """
-
-        self.cwd = os.getcwd()
-        self.strategies_backup_folder = f'{os.getcwd()}user_data/strategies_orig_updater'
-        source_file = strategy_obj['location']
-
-        # read the file
-        with open(source_file, 'r') as f:
-            old_code = f.read()
-        if not os.path.exists(self.strategies_backup_folder):
-            os.makedirs(self.strategies_backup_folder)
-
-        # backup original
-        # => currently no date after the filename,
-        # could get overridden pretty fast if this is fired twice!
-        shutil.copy(source_file, f"{self.strategies_backup_folder}/{strategy_obj['location_rel']}")
-
-        # update the code
-        new_code = strategy_updater.update_code(self, old_code,
-                                                strategy_updater.name_mapping,
-                                                strategy_updater.function_mapping,
-                                                strategy_updater.rename_dict)
-
-        # write the modified code to the destination folder
-        with open(source_file, 'w') as f:
-            f.write(new_code)
-        print(f"conversion of file {source_file} successful.")
-
-    # define the function to update the code
-    def update_code(self, code, _name_mapping, _function_mapping, _rename_dict):
-        # parse the code into an AST
-        tree = ast.parse(code)
-
-        # use the AST to update the code
-        updated_code = strategy_updater.modify_ast(
-            tree,
-            _name_mapping,
-            _function_mapping,
-            _rename_dict)
-
-        # return the modified code without executing it
-        return updated_code
-
-    # function that uses the ast module to update the code
-    def modify_ast(node, _name_mapping, _function_mapping, _rename_dict): # noqa
-        # create a visitor that will update the names and functions
-        class NameUpdater(ast.NodeTransformer):
-            def generic_visit(self, node):
-                # traverse the AST recursively by calling the visitor method for each child node
-                if hasattr(node, "_fields"):
-                    for field_name, field_value in ast.iter_fields(node):
-                        self.check_fields(field_value)
-                        self.check_strategy_and_config_settings(field_value)
-                        # add this check to handle the case where field_value is a slice
-                        if isinstance(field_value, ast.Slice):
-                            self.visit(field_value)
-                        # add this check to handle the case where field_value is a target
-                        if isinstance(field_value, ast.expr_context):
-                            self.visit(field_value)
-
-            def check_fields(self, field_value):
-                if isinstance(field_value, list):
-                    for item in field_value:
-                        if isinstance(item, ast.AST):
-                            self.visit(item)
-
-            def check_strategy_and_config_settings(self, field_value):
-                if (isinstance(field_value, ast.AST) and
-                        hasattr(node, "targets") and
-                        isinstance(node.targets, list)):
-                    for target in node.targets:
-                        if (hasattr(target, "id") and
-                                (target.id == "order_time_in_force" or
-                                 target.id == "order_types" or
-                                 target.id == "unfilledtimeout") and
-                                hasattr(field_value, "keys") and
-                                isinstance(field_value.keys, list)):
-                            for key in field_value.keys:
-                                self.visit(key)
-
-            def visit_Name(self, node):
-                # if the name is in the mapping, update it
-                if node.id in _name_mapping:
-                    node.id = _name_mapping[node.id]
-                return node
-
-            def visit_Import(self, node):
-                # do not update the names in import statements
-                return node
-
-            def visit_ImportFrom(self, node):
-                # do not update the names in import statements
-                if hasattr(node, "module"):
-                    if node.module == "freqtrade.strategy.hyper":
-                        node.module = "freqtrade.strategy"
-                return node
-
-            def visit_FunctionDef(self, node):
-                # if the function name is in the mapping, update it
-                if node.name in _function_mapping:
-                    node.name = _function_mapping[node.name]
-                return self.generic_visit(node)
-
-            def visit_Attribute(self, node):
-                # if the attribute name is 'nr_of_successful_buys',
-                # update it to 'nr_of_successful_entries'
-                if isinstance(node.value, ast.Name) and \
-                        node.value.id == 'trades' and \
-                        node.attr == 'nr_of_successful_buys':
-                    node.attr = 'nr_of_successful_entries'
-                return self.generic_visit(node)
-
-            def visit_ClassDef(self, node):
-                # check if the class is derived from IStrategy
-                if any(isinstance(base, ast.Name) and
-                       base.id == 'IStrategy' for base in node.bases):
-                    # check if the INTERFACE_VERSION variable exists
-                    has_interface_version = any(
-                        isinstance(child, ast.Assign) and
-                        isinstance(child.targets[0], ast.Name) and
-                        child.targets[0].id == 'INTERFACE_VERSION'
-                        for child in node.body
-                    )
-
-                    # if the INTERFACE_VERSION variable does not exist, add it as the first child
-                    if not has_interface_version:
-                        node.body.insert(0, ast.parse('INTERFACE_VERSION = 3').body[0])
-                    # otherwise, update its value to 3
-                    else:
-                        for child in node.body:
-                            if isinstance(child, ast.Assign) and \
-                                    isinstance(child.targets[0], ast.Name) and \
-                                    child.targets[0].id == 'INTERFACE_VERSION':
-                                child.value = ast.parse('3').body[0].value
-                return self.generic_visit(node)
-
-            def visit_Subscript(self, node):
-                if isinstance(node.slice, ast.Constant):
-                    if node.slice.value in strategy_updater.rename_dict:
-                        # Replace the slice attributes with the values from rename_dict
-                        node.slice.value = strategy_updater.rename_dict[node.slice.value]
-                if hasattr(node.slice, "elts"):
-                    for elt in node.slice.elts:
-                        if isinstance(elt, ast.Constant) and \
-                                elt.value in strategy_updater.rename_dict:
-                            elt.value = strategy_updater.rename_dict[elt.value]
-                return node
-
-            def visit_Constant(self, node):
-                # do not update the names in import statements
-                if node.value in \
-                        strategy_updater.otif_ot_unfilledtimeout:
-                    node.value = \
-                        strategy_updater.otif_ot_unfilledtimeout[node.value]
-                return node
-
-        # use the visitor to update the names and functions in the AST
-        NameUpdater().visit(node)
-
-        # first fix the comments so it understands "\n" properly inside multi line comments.
-        ast.fix_missing_locations(node)
-        ast.increment_lineno(node, n=1)
-
-        # generate the new code from the updated AST
-        return ast.unparse(node)
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
new file mode 100644
index 000000000..b62bc7822
--- /dev/null
+++ b/freqtrade/strategy/strategyupdater.py
@@ -0,0 +1,225 @@
+import ast
+import os
+import shutil
+from pathlib import Path
+
+import astor
+
+
+class StrategyUpdater:
+    name_mapping = {
+        'ticker_interval': 'timeframe',
+        'buy': 'enter_long',
+        'sell': 'exit_long',
+        'buy_tag': 'enter_tag',
+        'sell_reason': 'exit_reason',
+
+        'sell_signal': 'exit_signal',
+        'custom_sell': 'custom_exit',
+        'force_sell': 'force_exit',
+        'emergency_sell': 'emergency_exit',
+
+        # Strategy/config settings:
+        'use_sell_signal': 'use_exit_signal',
+        'sell_profit_only': 'exit_profit_only',
+        'sell_profit_offset': 'exit_profit_offset',
+        'ignore_roi_if_buy_signal': 'ignore_roi_if_entry_signal',
+        'forcebuy_enable': 'force_entry_enable',
+    }
+
+    function_mapping = {
+        'populate_buy_trend': 'populate_entry_trend',
+        'populate_sell_trend': 'populate_exit_trend',
+        'custom_sell': 'custom_exit',
+        'check_buy_timeout': 'check_entry_timeout',
+        'check_sell_timeout': 'check_exit_timeout',
+        # '': '',
+    }
+    # order_time_in_force, order_types, unfilledtimeout
+    otif_ot_unfilledtimeout = {
+        'buy': 'entry',
+        'sell': 'exit',
+    }
+
+    # create a dictionary that maps the old column names to the new ones
+    rename_dict = {'buy': 'enter_long', 'sell': 'exit_long', 'buy_tag': 'enter_tag'}
+
+    def start(self, config, strategy_obj: dict) -> None:
+        """
+        Run strategy updater
+        It updates a strategy to v3 with the help of the ast-module
+        :return: None
+        """
+
+        source_file = strategy_obj['location']
+        strategies_backup_folder = Path.joinpath(config['user_data_dir'], "strategies_orig_updater")
+        target_file = Path.joinpath(strategies_backup_folder, strategy_obj['location_rel'])
+
+        # read the file
+        with open(source_file, 'r') as f:
+            old_code = f.read()
+        if not os.path.exists(strategies_backup_folder):
+            os.makedirs(strategies_backup_folder)
+
+        # backup original
+        # => currently no date after the filename,
+        # could get overridden pretty fast if this is fired twice!
+        # The folder is always the same and the file name too (currently).
+        shutil.copy(source_file, target_file)
+
+        # update the code
+        new_code = StrategyUpdater.update_code(self, old_code)
+
+        # write the modified code to the destination folder
+        with open(source_file, 'w') as f:
+            f.write(new_code)
+        print(f"conversion of file {source_file} successful.")
+
+    # define the function to update the code
+    def update_code(self, code):
+        # parse the code into an AST
+        tree = ast.parse(code)
+
+        # use the AST to update the code
+        updated_code = self.modify_ast(
+            tree)
+
+        # return the modified code without executing it
+        return updated_code
+
+    # function that uses the ast module to update the code
+    def modify_ast(self, tree):  # noqa
+        # use the visitor to update the names and functions in the AST
+        NameUpdater().visit(tree)
+
+        # first fix the comments, so it understands "\n" properly inside multi line comments.
+        ast.fix_missing_locations(tree)
+        ast.increment_lineno(tree, n=1)
+
+        # generate the new code from the updated AST
+        return astor.to_source(tree)
+
+
+# Here we go through each respective node, slice, elt, key ... to replace outdated entries.
+class NameUpdater(ast.NodeTransformer):
+    def generic_visit(self, node):
+        # traverse the AST recursively by calling the visitor method for each child node
+        if hasattr(node, "_fields"):
+            for field_name, field_value in ast.iter_fields(node):
+                self.visit(field_value)
+                self.generic_visit(field_value)
+                self.check_fields(field_value)
+                self.check_strategy_and_config_settings(node, field_value)
+                # add this check to handle the case where field_value is a slice
+                if isinstance(field_value, ast.Slice):
+                    self.visit(field_value)
+                # add this check to handle the case where field_value is a target
+                if isinstance(field_value, ast.expr_context):
+                    self.visit(field_value)
+
+    def check_fields(self, field_value):
+        if isinstance(field_value, list):
+            for item in field_value:
+                if isinstance(item, ast.AST):
+                    self.visit(item)
+
+    def check_strategy_and_config_settings(self, node, field_value):
+        if (isinstance(field_value, ast.AST) and
+                hasattr(node, "targets") and
+                isinstance(node.targets, list)):
+            for target in node.targets:
+                if (hasattr(target, "id") and
+                        hasattr(field_value, "keys") and
+                        isinstance(field_value.keys, list)):
+                    if (target.id == "order_time_in_force" or
+                            target.id == "order_types" or
+                            target.id == "unfilledtimeout"):
+                        for key in field_value.keys:
+                            self.visit(key)
+                # Check if the target is a Subscript object with a "value" attribute
+                if isinstance(target, ast.Subscript) and hasattr(target.value, "attr"):
+                    if target.value.attr == "loc":
+                        self.visit(target)
+
+    def visit_Name(self, node):
+        # if the name is in the mapping, update it
+        if node.id in StrategyUpdater.name_mapping:
+            node.id = StrategyUpdater.name_mapping[node.id]
+        return node
+
+    def visit_Import(self, node):
+        # do not update the names in import statements
+        return node
+
+    def visit_ImportFrom(self, node):
+        # do not update the names in import statements
+        if hasattr(node, "module"):
+            if node.module == "freqtrade.strategy.hyper":
+                node.module = "freqtrade.strategy"
+        return node
+
+    def visit_FunctionDef(self, node):
+        # if the function name is in the mapping, update it
+        if node.name in StrategyUpdater.function_mapping:
+            node.name = StrategyUpdater.function_mapping[node.name]
+        return self.generic_visit(node)
+
+    def visit_Attribute(self, node):
+        # if the attribute name is 'nr_of_successful_buys',
+        # update it to 'nr_of_successful_entries'
+        if isinstance(node.value, ast.Name) and \
+                node.value.id == 'trades' and \
+                node.attr == 'nr_of_successful_buys':
+            node.attr = 'nr_of_successful_entries'
+        return self.generic_visit(node)
+
+    def visit_ClassDef(self, node):
+        # check if the class is derived from IStrategy
+        if any(isinstance(base, ast.Name) and
+               base.id == 'IStrategy' for base in node.bases):
+            # check if the INTERFACE_VERSION variable exists
+            has_interface_version = any(
+                isinstance(child, ast.Assign) and
+                isinstance(child.targets[0], ast.Name) and
+                child.targets[0].id == 'INTERFACE_VERSION'
+                for child in node.body
+            )
+
+            # if the INTERFACE_VERSION variable does not exist, add it as the first child
+            if not has_interface_version:
+                node.body.insert(0, ast.parse('INTERFACE_VERSION = 3').body[0])
+            # otherwise, update its value to 3
+            else:
+                for child in node.body:
+                    if isinstance(child, ast.Assign) and \
+                            isinstance(child.targets[0], ast.Name) and \
+                            child.targets[0].id == 'INTERFACE_VERSION':
+                        child.value = ast.parse('3').body[0].value
+        return self.generic_visit(node)
+
+    def visit_Subscript(self, node):
+        if isinstance(node.slice, ast.Constant):
+            if node.slice.value in StrategyUpdater.rename_dict:
+                # Replace the slice attributes with the values from rename_dict
+                node.slice.value = StrategyUpdater.rename_dict[node.slice.value]
+        if hasattr(node.slice, "elts"):
+            self.visit_slice_elts(node.slice.elts)
+        if hasattr(node.slice.value, "elts"):
+            self.visit_slice_elts(node.slice.value.elts)
+        return node
+
+    # elts can have elts (technically recursively)
+    def visit_slice_elts(self, elts):
+        for elt in elts:
+            if isinstance(elt, ast.Constant) and elt.value in StrategyUpdater.rename_dict:
+                elt.value = StrategyUpdater.rename_dict[elt.value]
+            elif hasattr(elt, "elts"):
+                self.visit_slice_elts(elt.elts)
+
+    def visit_Constant(self, node):
+        # do not update the names in import statements
+        if node.value in \
+                StrategyUpdater.otif_ot_unfilledtimeout:
+            node.value = \
+                StrategyUpdater.otif_ot_unfilledtimeout[node.value]
+        return node

From 82218d01f48051e2a43ad097a7453f3a1da533ac Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Fri, 30 Dec 2022 21:48:06 +0100
Subject: [PATCH 003/147] sped up the function generic_visit that now skips
 unnecessary fields added mentioning of skipped class names since they could
 not be found

---
 freqtrade/commands/strategy_utils_commands.py | 5 +++--
 freqtrade/strategy/strategyupdater.py         | 8 ++++++--
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 13405089f..cf7ba5e13 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -25,11 +25,12 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
         config, enum_failed=True, recursive=config.get('recursive_strategy_search', False))
 
     filtered_strategy_objs = []
-    for args_strategy in args['strategy_list']:
-        for strategy_obj in strategy_objs:
+    for strategy_obj in strategy_objs:
+        for args_strategy in args['strategy_list']:
             if strategy_obj['name'] == args_strategy and strategy_obj not in filtered_strategy_objs:
                 filtered_strategy_objs.append(strategy_obj)
                 break
+        print(f"strategy {strategy_obj['name']} could not be loaded or found and is skipped.")
 
     for filtered_strategy_obj in filtered_strategy_objs:
         # Initialize backtesting object
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index b62bc7822..74bb4454c 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -52,6 +52,7 @@ class StrategyUpdater:
         """
 
         source_file = strategy_obj['location']
+        print(f"started conversion of {source_file}")
         strategies_backup_folder = Path.joinpath(config['user_data_dir'], "strategies_orig_updater")
         target_file = Path.joinpath(strategies_backup_folder, strategy_obj['location_rel'])
 
@@ -106,6 +107,8 @@ class NameUpdater(ast.NodeTransformer):
         # traverse the AST recursively by calling the visitor method for each child node
         if hasattr(node, "_fields"):
             for field_name, field_value in ast.iter_fields(node):
+                if not isinstance(field_value, ast.AST):
+                    continue  # to avoid unnecessary loops
                 self.visit(field_value)
                 self.generic_visit(field_value)
                 self.check_fields(field_value)
@@ -204,8 +207,9 @@ class NameUpdater(ast.NodeTransformer):
                 node.slice.value = StrategyUpdater.rename_dict[node.slice.value]
         if hasattr(node.slice, "elts"):
             self.visit_slice_elts(node.slice.elts)
-        if hasattr(node.slice.value, "elts"):
-            self.visit_slice_elts(node.slice.value.elts)
+        if hasattr(node.slice, "value"):
+            if hasattr(node.slice.value, "elts"):
+                self.visit_slice_elts(node.slice.value.elts)
         return node
 
     # elts can have elts (technically recursively)

From a51e44eea304e548c74c190aed6a6adb8f81d0ed Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Sun, 1 Jan 2023 12:37:15 +0100
Subject: [PATCH 004/147] Adding tests

---
 freqtrade/commands/strategy_utils_commands.py | 10 +++-
 freqtrade/strategy/strategyupdater.py         | 35 +++++-------
 tests/test_strategy_updater.py                | 56 +++++++++++++++++++
 3 files changed, 76 insertions(+), 25 deletions(-)
 create mode 100644 tests/test_strategy_updater.py

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index cf7ba5e13..1f3c27e0d 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -25,12 +25,16 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
         config, enum_failed=True, recursive=config.get('recursive_strategy_search', False))
 
     filtered_strategy_objs = []
-    for strategy_obj in strategy_objs:
-        for args_strategy in args['strategy_list']:
+    for args_strategy in args['strategy_list']:
+        found = False
+        for strategy_obj in strategy_objs:
             if strategy_obj['name'] == args_strategy and strategy_obj not in filtered_strategy_objs:
                 filtered_strategy_objs.append(strategy_obj)
+                found = True
                 break
-        print(f"strategy {strategy_obj['name']} could not be loaded or found and is skipped.")
+
+        if not found:
+            print(f"strategy {strategy_obj['name']} could not be loaded or found and is skipped.")
 
     for filtered_strategy_obj in filtered_strategy_objs:
         # Initialize backtesting object
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 74bb4454c..396d57a8a 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -70,7 +70,6 @@ class StrategyUpdater:
 
         # update the code
         new_code = StrategyUpdater.update_code(self, old_code)
-
         # write the modified code to the destination folder
         with open(source_file, 'w') as f:
             f.write(new_code)
@@ -82,8 +81,7 @@ class StrategyUpdater:
         tree = ast.parse(code)
 
         # use the AST to update the code
-        updated_code = self.modify_ast(
-            tree)
+        updated_code = self.modify_ast(self, tree)
 
         # return the modified code without executing it
         return updated_code
@@ -107,18 +105,8 @@ class NameUpdater(ast.NodeTransformer):
         # traverse the AST recursively by calling the visitor method for each child node
         if hasattr(node, "_fields"):
             for field_name, field_value in ast.iter_fields(node):
-                if not isinstance(field_value, ast.AST):
-                    continue  # to avoid unnecessary loops
-                self.visit(field_value)
-                self.generic_visit(field_value)
-                self.check_fields(field_value)
                 self.check_strategy_and_config_settings(node, field_value)
-                # add this check to handle the case where field_value is a slice
-                if isinstance(field_value, ast.Slice):
-                    self.visit(field_value)
-                # add this check to handle the case where field_value is a target
-                if isinstance(field_value, ast.expr_context):
-                    self.visit(field_value)
+                self.check_fields(field_value)
 
     def check_fields(self, field_value):
         if isinstance(field_value, list):
@@ -139,10 +127,6 @@ class NameUpdater(ast.NodeTransformer):
                             target.id == "unfilledtimeout"):
                         for key in field_value.keys:
                             self.visit(key)
-                # Check if the target is a Subscript object with a "value" attribute
-                if isinstance(target, ast.Subscript) and hasattr(target.value, "attr"):
-                    if target.value.attr == "loc":
-                        self.visit(target)
 
     def visit_Name(self, node):
         # if the name is in the mapping, update it
@@ -154,11 +138,14 @@ class NameUpdater(ast.NodeTransformer):
         # do not update the names in import statements
         return node
 
+    # This function is currently never successfully triggered
+    # since freqtrade currently only allows valid code to be processed.
+    # The module .hyper does not anymore exist and by that fails to even
+    # reach this function to be updated currently.
     def visit_ImportFrom(self, node):
-        # do not update the names in import statements
-        if hasattr(node, "module"):
-            if node.module == "freqtrade.strategy.hyper":
-                node.module = "freqtrade.strategy"
+        # if hasattr(node, "module"):
+        #    if node.module == "freqtrade.strategy.hyper":
+        #        node.module = "freqtrade.strategy"
         return node
 
     def visit_FunctionDef(self, node):
@@ -210,6 +197,10 @@ class NameUpdater(ast.NodeTransformer):
         if hasattr(node.slice, "value"):
             if hasattr(node.slice.value, "elts"):
                 self.visit_slice_elts(node.slice.value.elts)
+        # Check if the target is a Subscript object with a "value" attribute
+        # if isinstance(target, ast.Subscript) and hasattr(target.value, "attr"):
+        #    if target.value.attr == "loc":
+        #        self.visit(target)
         return node
 
     # elts can have elts (technically recursively)
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
new file mode 100644
index 000000000..6997abdce
--- /dev/null
+++ b/tests/test_strategy_updater.py
@@ -0,0 +1,56 @@
+# pragma pylint: disable=missing-docstring, protected-access, invalid-name
+
+from freqtrade.strategy.strategyupdater import StrategyUpdater
+
+
+def test_strategy_updater(default_conf, caplog) -> None:
+    modified_code1 = StrategyUpdater.update_code(StrategyUpdater, """
+class testClass(IStrategy):
+    def populate_buy_trend():
+        pass
+    def populate_sell_trend():
+        pass
+    def check_buy_timeout():
+        pass
+    def check_sell_timeout():
+        pass
+    def custom_sell():
+        pass
+""")
+
+    modified_code2 = StrategyUpdater.update_code(StrategyUpdater, """
+buy_some_parameter = IntParameter(space='buy')
+sell_some_parameter = IntParameter(space='sell')
+ticker_interval = '15m'
+""")
+    modified_code3 = StrategyUpdater.update_code(StrategyUpdater, """
+use_sell_signal = True
+sell_profit_only = True
+sell_profit_offset = True
+ignore_roi_if_buy_signal = True
+forcebuy_enable = True
+""")
+    modified_code4 = StrategyUpdater.update_code(StrategyUpdater, """
+dataframe.loc[reduce(lambda x, y: x & y, conditions), 'buy'] = 1
+dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
+""")
+    assert "populate_entry_trend" in modified_code1
+    assert "populate_exit_trend" in modified_code1
+    assert "check_entry_timeout" in modified_code1
+    assert "check_exit_timeout" in modified_code1
+    assert "custom_exit" in modified_code1
+    assert "INTERFACE_VERSION = 3" in modified_code1
+
+    assert "timeframe" in modified_code2
+    # check for not editing hyperopt spaces
+    assert "space='buy'" in modified_code2
+    assert "space='sell'" in modified_code2
+
+    assert "use_exit_signal" in modified_code3
+    assert "exit_profit_only" in modified_code3
+    assert "exit_profit_offset" in modified_code3
+    assert "ignore_roi_if_entry_signal" in modified_code3
+    assert "force_entry_enable" in modified_code3
+
+    assert "enter_long" in modified_code4
+    assert "exit_long" in modified_code4

From 762dd4f024907ea9f9ddd0ac303eaf9f77e6dec4 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Sun, 1 Jan 2023 18:57:38 +0100
Subject: [PATCH 005/147] Adding tests added more code inside NameUpdater to
 grab more variables.

---
 freqtrade/strategy/strategyupdater.py | 40 +++++++++++++++++++++------
 tests/test_strategy_updater.py        | 11 +++++++-
 2 files changed, 42 insertions(+), 9 deletions(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 396d57a8a..5b4bb8be0 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -128,6 +128,15 @@ class NameUpdater(ast.NodeTransformer):
                         for key in field_value.keys:
                             self.visit(key)
 
+    def check_args(self, node):
+        if isinstance(node.args, ast.arguments):
+            self.check_args(node.args)
+        if hasattr(node, "args"):
+            if isinstance(node.args, list):
+                for arg in node.args:
+                    arg.arg = StrategyUpdater.name_mapping[arg.arg]
+        return node
+
     def visit_Name(self, node):
         # if the name is in the mapping, update it
         if node.id in StrategyUpdater.name_mapping:
@@ -152,6 +161,8 @@ class NameUpdater(ast.NodeTransformer):
         # if the function name is in the mapping, update it
         if node.name in StrategyUpdater.function_mapping:
             node.name = StrategyUpdater.function_mapping[node.name]
+        if hasattr(node, "args"):
+            self.check_args(node)
         return self.generic_visit(node)
 
     def visit_Attribute(self, node):
@@ -193,10 +204,10 @@ class NameUpdater(ast.NodeTransformer):
                 # Replace the slice attributes with the values from rename_dict
                 node.slice.value = StrategyUpdater.rename_dict[node.slice.value]
         if hasattr(node.slice, "elts"):
-            self.visit_slice_elts(node.slice.elts)
+            self.visit_elts(node.slice.elts)
         if hasattr(node.slice, "value"):
             if hasattr(node.slice.value, "elts"):
-                self.visit_slice_elts(node.slice.value.elts)
+                self.visit_elts(node.slice.value.elts)
         # Check if the target is a Subscript object with a "value" attribute
         # if isinstance(target, ast.Subscript) and hasattr(target.value, "attr"):
         #    if target.value.attr == "loc":
@@ -204,12 +215,25 @@ class NameUpdater(ast.NodeTransformer):
         return node
 
     # elts can have elts (technically recursively)
-    def visit_slice_elts(self, elts):
-        for elt in elts:
-            if isinstance(elt, ast.Constant) and elt.value in StrategyUpdater.rename_dict:
-                elt.value = StrategyUpdater.rename_dict[elt.value]
-            elif hasattr(elt, "elts"):
-                self.visit_slice_elts(elt.elts)
+    def visit_elts(self, elts):
+        if isinstance(elts, list):
+            for elt in elts:
+                self.visit_elt(elt)
+        else:
+            self.visit_elt(elts)
+
+    # sub function again needed since the structure itself is highly flexible ...
+    def visit_elt(self, elt):
+        if isinstance(elt, ast.Constant) and elt.value in StrategyUpdater.rename_dict:
+            elt.value = StrategyUpdater.rename_dict[elt.value]
+        if hasattr(elt, "elts"):
+            self.visit_elts(elt.elts)
+        if hasattr(elt, "args"):
+            if isinstance(elt.args, ast.arguments):
+                self.visit_elts(elt.args)
+            else:
+                for arg in elt.args:
+                    self.visit_elts(arg)
 
     def visit_Constant(self, node):
         # do not update the names in import statements
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 6997abdce..cf18fcc25 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -4,6 +4,11 @@ from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 def test_strategy_updater(default_conf, caplog) -> None:
+    modified_code5 = StrategyUpdater.update_code(StrategyUpdater, """
+def confirm_trade_exit(sell_reason: str):
+    pass
+""")
+
     modified_code1 = StrategyUpdater.update_code(StrategyUpdater, """
 class testClass(IStrategy):
     def populate_buy_trend():
@@ -31,9 +36,10 @@ ignore_roi_if_buy_signal = True
 forcebuy_enable = True
 """)
     modified_code4 = StrategyUpdater.update_code(StrategyUpdater, """
-dataframe.loc[reduce(lambda x, y: x & y, conditions), 'buy'] = 1
+dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
 dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
 """)
+
     assert "populate_entry_trend" in modified_code1
     assert "populate_exit_trend" in modified_code1
     assert "check_entry_timeout" in modified_code1
@@ -54,3 +60,6 @@ dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
 
     assert "enter_long" in modified_code4
     assert "exit_long" in modified_code4
+    assert "enter_tag" in modified_code4
+
+    assert "exit_reason" in modified_code5

From 66f7c913570b29be29d180caa1e50ff75f2438b2 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Sun, 1 Jan 2023 22:03:45 +0100
Subject: [PATCH 006/147] Adding tests added more code inside NameUpdater to
 grab more variables.

---
 freqtrade/strategy/strategyupdater.py | 18 +++++++++-
 requirements.txt                      | 20 +++++++++++
 tests/test_strategy_updater.py        | 50 +++++++++++++++++++++------
 3 files changed, 77 insertions(+), 11 deletions(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 5b4bb8be0..1a0423076 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -107,12 +107,16 @@ class NameUpdater(ast.NodeTransformer):
             for field_name, field_value in ast.iter_fields(node):
                 self.check_strategy_and_config_settings(node, field_value)
                 self.check_fields(field_value)
+                for child in ast.iter_child_nodes(node):
+                    self.generic_visit(child)
 
     def check_fields(self, field_value):
         if isinstance(field_value, list):
             for item in field_value:
-                if isinstance(item, ast.AST):
+                if isinstance(item, ast.AST) or isinstance(item, ast.If):
                     self.visit(item)
+        if isinstance(field_value, ast.Name):
+            self.visit_Name(field_value)
 
     def check_strategy_and_config_settings(self, node, field_value):
         if (isinstance(field_value, ast.AST) and
@@ -157,6 +161,11 @@ class NameUpdater(ast.NodeTransformer):
         #        node.module = "freqtrade.strategy"
         return node
 
+    def visit_If(self, node: ast.If):
+        for child in ast.iter_child_nodes(node):
+            self.visit(child)
+        return self.generic_visit(node)
+
     def visit_FunctionDef(self, node):
         # if the function name is in the mapping, update it
         if node.name in StrategyUpdater.function_mapping:
@@ -165,6 +174,13 @@ class NameUpdater(ast.NodeTransformer):
             self.check_args(node)
         return self.generic_visit(node)
 
+    def visit_Assign(self, node):
+        if hasattr(node, "targets") and isinstance(node.targets, list):
+            for target in node.targets:
+                if hasattr(target, "id") and target.id in StrategyUpdater.name_mapping:
+                    target.id = StrategyUpdater.name_mapping[target.id]
+        return node
+
     def visit_Attribute(self, node):
         # if the attribute name is 'nr_of_successful_buys',
         # update it to 'nr_of_successful_entries'
diff --git a/requirements.txt b/requirements.txt
index 90bc4f702..3229ec3c4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -57,3 +57,23 @@ schedule==1.1.0
 #WS Messages
 websockets==10.4
 janus==1.0.0
+
+pytest~=7.2.0
+freqtrade~=2022.12.dev0
+filelock~=3.8.2
+plotly~=5.11.0
+setuptools~=65.6.3
+starlette~=0.22.0
+gym~=0.21.0
+torch~=1.13.1
+scikit-learn~=1.1.3
+scipy~=1.9.3
+xgboost~=1.7.2
+catboost~=1.1.1
+lightgbm~=3.3.3
+astor~=0.8.1
+ta~=0.10.2
+finta~=1.3
+tapy~=1.9.1
+matplotlib~=3.6.2
+PyYAML~=6.0
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index cf18fcc25..5736e5c76 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -4,11 +4,11 @@ from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 def test_strategy_updater(default_conf, caplog) -> None:
-    modified_code5 = StrategyUpdater.update_code(StrategyUpdater, """
-def confirm_trade_exit(sell_reason: str):
-    pass
+    modified_code2 = StrategyUpdater.update_code(StrategyUpdater, """
+ticker_interval = '15m'
+buy_some_parameter = IntParameter(space='buy')
+sell_some_parameter = IntParameter(space='sell')
 """)
-
     modified_code1 = StrategyUpdater.update_code(StrategyUpdater, """
 class testClass(IStrategy):
     def populate_buy_trend():
@@ -21,12 +21,6 @@ class testClass(IStrategy):
         pass
     def custom_sell():
         pass
-""")
-
-    modified_code2 = StrategyUpdater.update_code(StrategyUpdater, """
-buy_some_parameter = IntParameter(space='buy')
-sell_some_parameter = IntParameter(space='sell')
-ticker_interval = '15m'
 """)
     modified_code3 = StrategyUpdater.update_code(StrategyUpdater, """
 use_sell_signal = True
@@ -38,6 +32,32 @@ forcebuy_enable = True
     modified_code4 = StrategyUpdater.update_code(StrategyUpdater, """
 dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
 dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
+""")
+    modified_code5 = StrategyUpdater.update_code(StrategyUpdater, """
+def confirm_trade_exit(sell_reason: str):
+    pass
+    """)
+    modified_code6 = StrategyUpdater.update_code(StrategyUpdater, """
+order_time_in_force = {
+    'buy': 'gtc',
+    'sell': 'ioc'
+}
+order_types = {
+    'buy': 'limit',
+    'sell': 'market',
+    'stoploss': 'market',
+    'stoploss_on_exchange': False
+}
+unfilledtimeout = {
+    'buy': 1,
+    'sell': 2
+}
+""")
+
+    modified_code7 = StrategyUpdater.update_code(StrategyUpdater, """
+def confirm_trade_exit(sell_reason):
+    if (sell_reason == 'stop_loss'):
+        pass
 """)
 
     assert "populate_entry_trend" in modified_code1
@@ -63,3 +83,13 @@ dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
     assert "enter_tag" in modified_code4
 
     assert "exit_reason" in modified_code5
+
+    assert "'entry': 'gtc'" in modified_code6
+    assert "'exit': 'ioc'" in modified_code6
+    assert "'entry': 'limit'" in modified_code6
+    assert "'exit': 'market'" in modified_code6
+    assert "'entry': 1" in modified_code6
+    assert "'exit': 2" in modified_code6
+
+    assert "exit_reason" in modified_code7
+    assert "exit_reason == 'stop_loss'" in modified_code7

From e89609dc3a9fc32003243785c9a2e173a4ebd09d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 2 Jan 2023 08:51:54 +0100
Subject: [PATCH 007/147] Fix crash due to invalid parameter

---
 freqtrade/strategy/strategyupdater.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 1a0423076..ab757e0a9 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -81,7 +81,7 @@ class StrategyUpdater:
         tree = ast.parse(code)
 
         # use the AST to update the code
-        updated_code = self.modify_ast(self, tree)
+        updated_code = self.modify_ast(tree)
 
         # return the modified code without executing it
         return updated_code

From a712c5d42c567751be0949a2202f48d138547c25 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 2 Jan 2023 08:44:00 +0100
Subject: [PATCH 008/147] Improve if formatting

---
 freqtrade/strategy/strategyupdater.py | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index ab757e0a9..a0547932c 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -184,9 +184,11 @@ class NameUpdater(ast.NodeTransformer):
     def visit_Attribute(self, node):
         # if the attribute name is 'nr_of_successful_buys',
         # update it to 'nr_of_successful_entries'
-        if isinstance(node.value, ast.Name) and \
-                node.value.id == 'trades' and \
-                node.attr == 'nr_of_successful_buys':
+        if (
+            isinstance(node.value, ast.Name)
+            and node.value.id == 'trades'
+            and node.attr == 'nr_of_successful_buys'
+        ):
             node.attr = 'nr_of_successful_entries'
         return self.generic_visit(node)
 
@@ -208,9 +210,11 @@ class NameUpdater(ast.NodeTransformer):
             # otherwise, update its value to 3
             else:
                 for child in node.body:
-                    if isinstance(child, ast.Assign) and \
-                            isinstance(child.targets[0], ast.Name) and \
-                            child.targets[0].id == 'INTERFACE_VERSION':
+                    if (
+                        isinstance(child, ast.Assign)
+                        and isinstance(child.targets[0], ast.Name)
+                        and child.targets[0].id == 'INTERFACE_VERSION'
+                    ):
                         child.value = ast.parse('3').body[0].value
         return self.generic_visit(node)
 
@@ -253,8 +257,6 @@ class NameUpdater(ast.NodeTransformer):
 
     def visit_Constant(self, node):
         # do not update the names in import statements
-        if node.value in \
-                StrategyUpdater.otif_ot_unfilledtimeout:
-            node.value = \
-                StrategyUpdater.otif_ot_unfilledtimeout[node.value]
+        if node.value in StrategyUpdater.otif_ot_unfilledtimeout:
+            node.value = StrategyUpdater.otif_ot_unfilledtimeout[node.value]
         return node

From df25dbc048594870d6e5c9356575b47326d8ddef Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 2 Jan 2023 08:52:18 +0100
Subject: [PATCH 009/147] Don't require a configuration for strategy-updater

---
 freqtrade/commands/arguments.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/freqtrade/commands/arguments.py b/freqtrade/commands/arguments.py
index 9990ad230..a3cdc378a 100644
--- a/freqtrade/commands/arguments.py
+++ b/freqtrade/commands/arguments.py
@@ -111,7 +111,8 @@ ARGS_ANALYZE_ENTRIES_EXITS = ["exportfilename", "analysis_groups", "enter_reason
 NO_CONF_REQURIED = ["convert-data", "convert-trade-data", "download-data", "list-timeframes",
                     "list-markets", "list-pairs", "list-strategies", "list-freqaimodels",
                     "list-data", "hyperopt-list", "hyperopt-show", "backtest-filter",
-                    "plot-dataframe", "plot-profit", "show-trades", "trades-to-ohlcv"]
+                    "plot-dataframe", "plot-profit", "show-trades", "trades-to-ohlcv",
+                    "strategy-updater"]
 
 NO_CONF_ALLOWED = ["create-userdir", "list-exchanges", "new-strategy"]
 

From 61d7129d7ce65edcbbdd75f7047d47ad75051cce Mon Sep 17 00:00:00 2001
From: hippocritical <41228167+hippocritical@users.noreply.github.com>
Date: Mon, 2 Jan 2023 16:51:05 +0100
Subject: [PATCH 010/147] Update freqtrade/commands/strategy_utils_commands.py

Co-authored-by: Matthias <xmatthias@outlook.com>
---
 freqtrade/commands/strategy_utils_commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 1f3c27e0d..0325f411c 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -39,4 +39,4 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     for filtered_strategy_obj in filtered_strategy_objs:
         # Initialize backtesting object
         instance_strategy_updater = StrategyUpdater()
-        StrategyUpdater.start(instance_strategy_updater, config, filtered_strategy_obj)
+        self.start(config, filtered_strategy_obj)

From 0817e1698f654a13fd6f01c2519dee5f1cc19f99 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Mon, 2 Jan 2023 20:45:56 +0100
Subject: [PATCH 011/147] requirements thinned out again
 StrategyResolver.search_all_objects(enum_failed) set to False since we got no
 use in True shortened update_code call added modified_code8 test which
 currently still fails. (and thereby is commented out)

---
 freqtrade/commands/strategy_utils_commands.py |  2 +-
 freqtrade/strategy/strategyupdater.py         |  8 +++++---
 requirements.txt                              | 18 ------------------
 tests/test_strategy_updater.py                | 11 +++++++++++
 4 files changed, 17 insertions(+), 22 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 1f3c27e0d..5d8ede9a2 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -22,7 +22,7 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
 
     strategy_objs = StrategyResolver.search_all_objects(
-        config, enum_failed=True, recursive=config.get('recursive_strategy_search', False))
+        config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
 
     filtered_strategy_objs = []
     for args_strategy in args['strategy_list']:
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 1a0423076..7f3a1feff 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -69,7 +69,7 @@ class StrategyUpdater:
         shutil.copy(source_file, target_file)
 
         # update the code
-        new_code = StrategyUpdater.update_code(self, old_code)
+        new_code = self.update_code(old_code)
         # write the modified code to the destination folder
         with open(source_file, 'w') as f:
             f.write(new_code)
@@ -113,7 +113,8 @@ class NameUpdater(ast.NodeTransformer):
     def check_fields(self, field_value):
         if isinstance(field_value, list):
             for item in field_value:
-                if isinstance(item, ast.AST) or isinstance(item, ast.If):
+                if (isinstance(item, ast.AST) or isinstance(item, ast.If) or
+                        isinstance(item, ast.Expr)):
                     self.visit(item)
         if isinstance(field_value, ast.Name):
             self.visit_Name(field_value)
@@ -138,7 +139,8 @@ class NameUpdater(ast.NodeTransformer):
         if hasattr(node, "args"):
             if isinstance(node.args, list):
                 for arg in node.args:
-                    arg.arg = StrategyUpdater.name_mapping[arg.arg]
+                    if arg.arg in StrategyUpdater.name_mapping:
+                        arg.arg = StrategyUpdater.name_mapping[arg.arg]
         return node
 
     def visit_Name(self, node):
diff --git a/requirements.txt b/requirements.txt
index 3229ec3c4..da1db316b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -58,22 +58,4 @@ schedule==1.1.0
 websockets==10.4
 janus==1.0.0
 
-pytest~=7.2.0
-freqtrade~=2022.12.dev0
-filelock~=3.8.2
-plotly~=5.11.0
-setuptools~=65.6.3
-starlette~=0.22.0
-gym~=0.21.0
-torch~=1.13.1
-scikit-learn~=1.1.3
-scipy~=1.9.3
-xgboost~=1.7.2
-catboost~=1.1.1
-lightgbm~=3.3.3
 astor~=0.8.1
-ta~=0.10.2
-finta~=1.3
-tapy~=1.9.1
-matplotlib~=3.6.2
-PyYAML~=6.0
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 5736e5c76..682c715fe 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -59,6 +59,11 @@ def confirm_trade_exit(sell_reason):
     if (sell_reason == 'stop_loss'):
         pass
 """)
+    #    modified_code8 = StrategyUpdater.update_code(StrategyUpdater, """
+    # sell_reason == 'sell_signal'
+    # sell_reason == 'force_sell'
+    # sell_reason == 'emergency_sell'
+    # """)
 
     assert "populate_entry_trend" in modified_code1
     assert "populate_exit_trend" in modified_code1
@@ -93,3 +98,9 @@ def confirm_trade_exit(sell_reason):
 
     assert "exit_reason" in modified_code7
     assert "exit_reason == 'stop_loss'" in modified_code7
+
+    # those tests currently don't work, next in line.
+    # assert "exit_signal" in modified_code8
+    # assert "exit_reason" in modified_code8
+    # assert "force_exit" in modified_code8
+    # assert "emergency_exit" in modified_code8

From 71ec32ac9e8360a87b9aeec32327f2824af24f0f Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Mon, 2 Jan 2023 23:35:51 +0100
Subject: [PATCH 012/147] removed prints for strategy could not be loaded
 changed back to ast, astor is not really needed.

---
 freqtrade/commands/strategy_utils_commands.py |  8 +-------
 freqtrade/strategy/strategyupdater.py         | 18 ++++++++----------
 2 files changed, 9 insertions(+), 17 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 5aeac2266..4a7eacda0 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -26,17 +26,11 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
 
     filtered_strategy_objs = []
     for args_strategy in args['strategy_list']:
-        found = False
         for strategy_obj in strategy_objs:
             if strategy_obj['name'] == args_strategy and strategy_obj not in filtered_strategy_objs:
                 filtered_strategy_objs.append(strategy_obj)
-                found = True
                 break
 
-        if not found:
-            print(f"strategy {strategy_obj['name']} could not be loaded or found and is skipped.")
-
     for filtered_strategy_obj in filtered_strategy_objs:
-        # Initialize backtesting object
         instance_strategy_updater = StrategyUpdater()
-        self.start(config, filtered_strategy_obj)
+        instance_strategy_updater.start(config, filtered_strategy_obj)
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 8a55de1b6..d12d3eaaa 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -3,8 +3,6 @@ import os
 import shutil
 from pathlib import Path
 
-import astor
-
 
 class StrategyUpdater:
     name_mapping = {
@@ -59,7 +57,7 @@ class StrategyUpdater:
         # read the file
         with open(source_file, 'r') as f:
             old_code = f.read()
-        if not os.path.exists(strategies_backup_folder):
+        if not strategies_backup_folder.is_dir():
             os.makedirs(strategies_backup_folder)
 
         # backup original
@@ -96,7 +94,7 @@ class StrategyUpdater:
         ast.increment_lineno(tree, n=1)
 
         # generate the new code from the updated AST
-        return astor.to_source(tree)
+        return ast.dump(tree)
 
 
 # Here we go through each respective node, slice, elt, key ... to replace outdated entries.
@@ -187,9 +185,9 @@ class NameUpdater(ast.NodeTransformer):
         # if the attribute name is 'nr_of_successful_buys',
         # update it to 'nr_of_successful_entries'
         if (
-            isinstance(node.value, ast.Name)
-            and node.value.id == 'trades'
-            and node.attr == 'nr_of_successful_buys'
+                isinstance(node.value, ast.Name)
+                and node.value.id == 'trades'
+                and node.attr == 'nr_of_successful_buys'
         ):
             node.attr = 'nr_of_successful_entries'
         return self.generic_visit(node)
@@ -213,9 +211,9 @@ class NameUpdater(ast.NodeTransformer):
             else:
                 for child in node.body:
                     if (
-                        isinstance(child, ast.Assign)
-                        and isinstance(child.targets[0], ast.Name)
-                        and child.targets[0].id == 'INTERFACE_VERSION'
+                            isinstance(child, ast.Assign)
+                            and isinstance(child.targets[0], ast.Name)
+                            and child.targets[0].id == 'INTERFACE_VERSION'
                     ):
                         child.value = ast.parse('3').body[0].value
         return self.generic_visit(node)

From ed55296d202d725b5d2d5e95e60273a8d21dcf1a Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Wed, 4 Jan 2023 23:49:33 +0100
Subject: [PATCH 013/147] removed prints for strategy could not be loaded
 Changed logic to contain much less if conditions

currently still missing:
Webhook terminology, Telegram notification settings, Strategy/Config settings
---
 freqtrade/strategy/strategyupdater.py | 124 ++++++++++++--------------
 tests/test_strategy_updater.py        |  31 ++++---
 2 files changed, 73 insertions(+), 82 deletions(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index d12d3eaaa..ad14bb903 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -3,6 +3,8 @@ import os
 import shutil
 from pathlib import Path
 
+import astor
+
 
 class StrategyUpdater:
     name_mapping = {
@@ -79,7 +81,7 @@ class StrategyUpdater:
         tree = ast.parse(code)
 
         # use the AST to update the code
-        updated_code = self.modify_ast(tree)
+        updated_code = self.modify_ast(self, tree)
 
         # return the modified code without executing it
         return updated_code
@@ -94,67 +96,67 @@ class StrategyUpdater:
         ast.increment_lineno(tree, n=1)
 
         # generate the new code from the updated AST
-        return ast.dump(tree)
+        return astor.to_source(tree)
 
 
 # Here we go through each respective node, slice, elt, key ... to replace outdated entries.
 class NameUpdater(ast.NodeTransformer):
     def generic_visit(self, node):
-        # traverse the AST recursively by calling the visitor method for each child node
-        if hasattr(node, "_fields"):
-            for field_name, field_value in ast.iter_fields(node):
-                self.check_strategy_and_config_settings(node, field_value)
-                self.check_fields(field_value)
-                for child in ast.iter_child_nodes(node):
-                    self.generic_visit(child)
 
-    def check_fields(self, field_value):
-        if isinstance(field_value, list):
-            for item in field_value:
-                if (isinstance(item, ast.AST) or isinstance(item, ast.If) or
-                        isinstance(item, ast.Expr)):
-                    self.visit(item)
-        if isinstance(field_value, ast.Name):
-            self.visit_Name(field_value)
+        # space is not yet transferred from buy/sell to entry/exit and thereby has to be skipped.
+        if isinstance(node, ast.keyword):
+            if node.arg == "space":
+                return node
 
-    def check_strategy_and_config_settings(self, node, field_value):
-        if (isinstance(field_value, ast.AST) and
-                hasattr(node, "targets") and
-                isinstance(node.targets, list)):
-            for target in node.targets:
-                if (hasattr(target, "id") and
-                        hasattr(field_value, "keys") and
-                        isinstance(field_value.keys, list)):
-                    if (target.id == "order_time_in_force" or
-                            target.id == "order_types" or
-                            target.id == "unfilledtimeout"):
-                        for key in field_value.keys:
-                            self.visit(key)
+        # from here on this is the original function.
+        for field, old_value in ast.iter_fields(node):
+            if isinstance(old_value, list):
+                new_values = []
+                for value in old_value:
+                    if isinstance(value, ast.AST):
+                        value = self.visit(value)
+                        if value is None:
+                            continue
+                        elif not isinstance(value, ast.AST):
+                            new_values.extend(value)
+                            continue
+                    new_values.append(value)
+                old_value[:] = new_values
+            elif isinstance(old_value, ast.AST):
+                new_node = self.visit(old_value)
+                if new_node is None:
+                    delattr(node, field)
+                else:
+                    setattr(node, field, new_node)
+        return node
 
-    def check_args(self, node):
-        if isinstance(node.args, ast.arguments):
-            self.check_args(node.args)
-        if hasattr(node, "args"):
-            if isinstance(node.args, list):
-                for arg in node.args:
-                    if arg.arg in StrategyUpdater.name_mapping:
-                        arg.arg = StrategyUpdater.name_mapping[arg.arg]
+    def visit_Expr(self, node):
+        node.value.left.id = self.check_dict(StrategyUpdater.name_mapping, node.value.left.id)
+        self.visit(node.value)
+        return node
+
+    # Renames an element if contained inside a dictionary.
+    @staticmethod
+    def check_dict(current_dict: dict, element: str):
+        if element in current_dict:
+            element = current_dict[element]
+        return element
+
+    def visit_arguments(self, node):
+        if isinstance(node.args, list):
+            for arg in node.args:
+                arg.arg = self.check_dict(StrategyUpdater.name_mapping, arg.arg)
         return node
 
     def visit_Name(self, node):
         # if the name is in the mapping, update it
-        if node.id in StrategyUpdater.name_mapping:
-            node.id = StrategyUpdater.name_mapping[node.id]
+        node.id = self.check_dict(StrategyUpdater.name_mapping, node.id)
         return node
 
     def visit_Import(self, node):
         # do not update the names in import statements
         return node
 
-    # This function is currently never successfully triggered
-    # since freqtrade currently only allows valid code to be processed.
-    # The module .hyper does not anymore exist and by that fails to even
-    # reach this function to be updated currently.
     def visit_ImportFrom(self, node):
         # if hasattr(node, "module"):
         #    if node.module == "freqtrade.strategy.hyper":
@@ -164,33 +166,21 @@ class NameUpdater(ast.NodeTransformer):
     def visit_If(self, node: ast.If):
         for child in ast.iter_child_nodes(node):
             self.visit(child)
-        return self.generic_visit(node)
+        return node
 
     def visit_FunctionDef(self, node):
-        # if the function name is in the mapping, update it
-        if node.name in StrategyUpdater.function_mapping:
-            node.name = StrategyUpdater.function_mapping[node.name]
-        if hasattr(node, "args"):
-            self.check_args(node)
-        return self.generic_visit(node)
-
-    def visit_Assign(self, node):
-        if hasattr(node, "targets") and isinstance(node.targets, list):
-            for target in node.targets:
-                if hasattr(target, "id") and target.id in StrategyUpdater.name_mapping:
-                    target.id = StrategyUpdater.name_mapping[target.id]
+        node.name = self.check_dict(StrategyUpdater.function_mapping, node.name)
+        self.generic_visit(node)
         return node
 
     def visit_Attribute(self, node):
-        # if the attribute name is 'nr_of_successful_buys',
-        # update it to 'nr_of_successful_entries'
         if (
                 isinstance(node.value, ast.Name)
                 and node.value.id == 'trades'
                 and node.attr == 'nr_of_successful_buys'
         ):
             node.attr = 'nr_of_successful_entries'
-        return self.generic_visit(node)
+        return node
 
     def visit_ClassDef(self, node):
         # check if the class is derived from IStrategy
@@ -216,7 +206,8 @@ class NameUpdater(ast.NodeTransformer):
                             and child.targets[0].id == 'INTERFACE_VERSION'
                     ):
                         child.value = ast.parse('3').body[0].value
-        return self.generic_visit(node)
+        self.generic_visit(node)
+        return node
 
     def visit_Subscript(self, node):
         if isinstance(node.slice, ast.Constant):
@@ -228,10 +219,6 @@ class NameUpdater(ast.NodeTransformer):
         if hasattr(node.slice, "value"):
             if hasattr(node.slice.value, "elts"):
                 self.visit_elts(node.slice.value.elts)
-        # Check if the target is a Subscript object with a "value" attribute
-        # if isinstance(target, ast.Subscript) and hasattr(target.value, "attr"):
-        #    if target.value.attr == "loc":
-        #        self.visit(target)
         return node
 
     # elts can have elts (technically recursively)
@@ -241,6 +228,7 @@ class NameUpdater(ast.NodeTransformer):
                 self.visit_elt(elt)
         else:
             self.visit_elt(elts)
+        return elts
 
     # sub function again needed since the structure itself is highly flexible ...
     def visit_elt(self, elt):
@@ -254,9 +242,9 @@ class NameUpdater(ast.NodeTransformer):
             else:
                 for arg in elt.args:
                     self.visit_elts(arg)
+        return elt
 
     def visit_Constant(self, node):
-        # do not update the names in import statements
-        if node.value in StrategyUpdater.otif_ot_unfilledtimeout:
-            node.value = StrategyUpdater.otif_ot_unfilledtimeout[node.value]
+        node.value = self.check_dict(StrategyUpdater.otif_ot_unfilledtimeout, node.value)
+        node.value = self.check_dict(StrategyUpdater.name_mapping, node.value)
         return node
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 682c715fe..3ece2b3d8 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -4,11 +4,6 @@ from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 def test_strategy_updater(default_conf, caplog) -> None:
-    modified_code2 = StrategyUpdater.update_code(StrategyUpdater, """
-ticker_interval = '15m'
-buy_some_parameter = IntParameter(space='buy')
-sell_some_parameter = IntParameter(space='sell')
-""")
     modified_code1 = StrategyUpdater.update_code(StrategyUpdater, """
 class testClass(IStrategy):
     def populate_buy_trend():
@@ -21,6 +16,11 @@ class testClass(IStrategy):
         pass
     def custom_sell():
         pass
+""")
+    modified_code2 = StrategyUpdater.update_code(StrategyUpdater, """
+ticker_interval = '15m'
+buy_some_parameter = IntParameter(space='buy')
+sell_some_parameter = IntParameter(space='sell')
 """)
     modified_code3 = StrategyUpdater.update_code(StrategyUpdater, """
 use_sell_signal = True
@@ -59,11 +59,14 @@ def confirm_trade_exit(sell_reason):
     if (sell_reason == 'stop_loss'):
         pass
 """)
-    #    modified_code8 = StrategyUpdater.update_code(StrategyUpdater, """
-    # sell_reason == 'sell_signal'
-    # sell_reason == 'force_sell'
-    # sell_reason == 'emergency_sell'
-    # """)
+    modified_code8 = StrategyUpdater.update_code(StrategyUpdater, """
+sell_reason == 'sell_signal'
+sell_reason == 'force_sell'
+sell_reason == 'emergency_sell'
+""")
+
+    # currently still missing:
+    # Webhook terminology, Telegram notification settings, Strategy/Config settings
 
     assert "populate_entry_trend" in modified_code1
     assert "populate_exit_trend" in modified_code1
@@ -100,7 +103,7 @@ def confirm_trade_exit(sell_reason):
     assert "exit_reason == 'stop_loss'" in modified_code7
 
     # those tests currently don't work, next in line.
-    # assert "exit_signal" in modified_code8
-    # assert "exit_reason" in modified_code8
-    # assert "force_exit" in modified_code8
-    # assert "emergency_exit" in modified_code8
+    assert "exit_signal" in modified_code8
+    assert "exit_reason" in modified_code8
+    assert "force_exit" in modified_code8
+    assert "emergency_exit" in modified_code8

From 4435c4fd0d1de2e6b57375051d8007ca7435c5ac Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Thu, 5 Jan 2023 22:56:06 +0100
Subject: [PATCH 014/147] removed prints for strategy could not be loaded
 Changed logic to contain much less if conditions

currently still missing:
Webhook terminology, Telegram notification settings, Strategy/Config settings
---
 freqtrade/commands/strategy_utils_commands.py |  4 ++++
 freqtrade/strategy/strategyupdater.py         | 10 +++++-----
 tests/test_strategy_updater.py                | 17 +++++++++--------
 3 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 4a7eacda0..75b8a9cc0 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -1,4 +1,5 @@
 import logging
+import time
 from typing import Any, Dict
 
 from freqtrade.configuration import setup_utils_configuration
@@ -33,4 +34,7 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
 
     for filtered_strategy_obj in filtered_strategy_objs:
         instance_strategy_updater = StrategyUpdater()
+        start = time.perf_counter()
         instance_strategy_updater.start(config, filtered_strategy_obj)
+        elapsed = time.perf_counter() - start
+        print(f"Conversion of {filtered_strategy_obj['name']} took {elapsed:.1f} seconds.")
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index ad14bb903..e26dd5e79 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -52,7 +52,6 @@ class StrategyUpdater:
         """
 
         source_file = strategy_obj['location']
-        print(f"started conversion of {source_file}")
         strategies_backup_folder = Path.joinpath(config['user_data_dir'], "strategies_orig_updater")
         target_file = Path.joinpath(strategies_backup_folder, strategy_obj['location_rel'])
 
@@ -73,7 +72,6 @@ class StrategyUpdater:
         # write the modified code to the destination folder
         with open(source_file, 'w') as f:
             f.write(new_code)
-        print(f"conversion of file {source_file} successful.")
 
     # define the function to update the code
     def update_code(self, code):
@@ -81,7 +79,7 @@ class StrategyUpdater:
         tree = ast.parse(code)
 
         # use the AST to update the code
-        updated_code = self.modify_ast(self, tree)
+        updated_code = self.modify_ast(tree)
 
         # return the modified code without executing it
         return updated_code
@@ -96,6 +94,7 @@ class StrategyUpdater:
         ast.increment_lineno(tree, n=1)
 
         # generate the new code from the updated AST
+        # without indent {} parameters would just be written straight one after the other.
         return astor.to_source(tree)
 
 
@@ -131,8 +130,9 @@ class NameUpdater(ast.NodeTransformer):
         return node
 
     def visit_Expr(self, node):
-        node.value.left.id = self.check_dict(StrategyUpdater.name_mapping, node.value.left.id)
-        self.visit(node.value)
+        if hasattr(node.value, "left") and hasattr(node.value.left, "id"):
+            node.value.left.id = self.check_dict(StrategyUpdater.name_mapping, node.value.left.id)
+            self.visit(node.value)
         return node
 
     # Renames an element if contained inside a dictionary.
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 3ece2b3d8..a00340427 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -4,7 +4,8 @@ from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 def test_strategy_updater(default_conf, caplog) -> None:
-    modified_code1 = StrategyUpdater.update_code(StrategyUpdater, """
+    instance_strategy_updater = StrategyUpdater()
+    modified_code1 = instance_strategy_updater.update_code("""
 class testClass(IStrategy):
     def populate_buy_trend():
         pass
@@ -17,27 +18,27 @@ class testClass(IStrategy):
     def custom_sell():
         pass
 """)
-    modified_code2 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code2 = instance_strategy_updater.update_code("""
 ticker_interval = '15m'
 buy_some_parameter = IntParameter(space='buy')
 sell_some_parameter = IntParameter(space='sell')
 """)
-    modified_code3 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code3 = instance_strategy_updater.update_code("""
 use_sell_signal = True
 sell_profit_only = True
 sell_profit_offset = True
 ignore_roi_if_buy_signal = True
 forcebuy_enable = True
 """)
-    modified_code4 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code4 = instance_strategy_updater.update_code("""
 dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
 dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
 """)
-    modified_code5 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code5 = instance_strategy_updater.update_code("""
 def confirm_trade_exit(sell_reason: str):
     pass
     """)
-    modified_code6 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code6 = instance_strategy_updater.update_code("""
 order_time_in_force = {
     'buy': 'gtc',
     'sell': 'ioc'
@@ -54,12 +55,12 @@ unfilledtimeout = {
 }
 """)
 
-    modified_code7 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code7 = instance_strategy_updater.update_code("""
 def confirm_trade_exit(sell_reason):
     if (sell_reason == 'stop_loss'):
         pass
 """)
-    modified_code8 = StrategyUpdater.update_code(StrategyUpdater, """
+    modified_code8 = instance_strategy_updater.update_code("""
 sell_reason == 'sell_signal'
 sell_reason == 'force_sell'
 sell_reason == 'emergency_sell'

From 06edc5c04491b15b2b43c0b9f0900cbf91958e8d Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Fri, 17 Feb 2023 21:01:09 +0100
Subject: [PATCH 015/147] changed to ast_comments, added tests for comments.

---
 freqtrade/commands/strategy_utils_commands.py | 43 ++++++++++-----
 freqtrade/strategy/strategyupdater.py         | 54 ++++++++++---------
 tests/test_strategy_updater.py                | 20 +++++++
 3 files changed, 78 insertions(+), 39 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 75b8a9cc0..dc94f2b67 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -1,10 +1,12 @@
 import logging
+import os
 import time
 from typing import Any, Dict
 
 from freqtrade.configuration import setup_utils_configuration
 from freqtrade.enums import RunMode
 from freqtrade.resolvers import StrategyResolver
+from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 logger = logging.getLogger(__name__)
@@ -17,24 +19,37 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     :return: None
     """
 
-    # Import here to avoid loading backtesting module when it's not used
-    from freqtrade.strategy.strategyupdater import StrategyUpdater
-
     config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
 
     strategy_objs = StrategyResolver.search_all_objects(
         config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
 
     filtered_strategy_objs = []
-    for args_strategy in args['strategy_list']:
-        for strategy_obj in strategy_objs:
-            if strategy_obj['name'] == args_strategy and strategy_obj not in filtered_strategy_objs:
-                filtered_strategy_objs.append(strategy_obj)
-                break
+    if hasattr(args, "strategy_list"):
+        for args_strategy in args['strategy_list']:
+            for strategy_obj in strategy_objs:
+                if (strategy_obj['name'] == args_strategy
+                        and strategy_obj not in filtered_strategy_objs):
+                    filtered_strategy_objs.append(strategy_obj)
+                    break
 
-    for filtered_strategy_obj in filtered_strategy_objs:
-        instance_strategy_updater = StrategyUpdater()
-        start = time.perf_counter()
-        instance_strategy_updater.start(config, filtered_strategy_obj)
-        elapsed = time.perf_counter() - start
-        print(f"Conversion of {filtered_strategy_obj['name']} took {elapsed:.1f} seconds.")
+        for filtered_strategy_obj in filtered_strategy_objs:
+            start_conversion(filtered_strategy_obj, config)
+    else:
+        processed_locations = set()
+        for strategy_obj in strategy_objs:
+            if strategy_obj['location'] not in processed_locations:
+                processed_locations.add(strategy_obj['location'])
+                start_conversion(strategy_obj, config)
+
+
+def start_conversion(strategy_obj, config):
+    # try:
+    print(f"Conversion of {os.path.basename(strategy_obj['location'])} started.")
+    instance_strategy_updater = StrategyUpdater()
+    start = time.perf_counter()
+    instance_strategy_updater.start(config, strategy_obj)
+    elapsed = time.perf_counter() - start
+    print(f"Conversion of {os.path.basename(strategy_obj['location'])} took {elapsed:.1f} seconds.")
+    # except:
+    #    pass
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index e26dd5e79..db19d4fba 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -1,9 +1,8 @@
-import ast
 import os
 import shutil
 from pathlib import Path
 
-import astor
+import ast_comments
 
 
 class StrategyUpdater:
@@ -76,7 +75,7 @@ class StrategyUpdater:
     # define the function to update the code
     def update_code(self, code):
         # parse the code into an AST
-        tree = ast.parse(code)
+        tree = ast_comments.parse(code)
 
         # use the AST to update the code
         updated_code = self.modify_ast(tree)
@@ -90,38 +89,43 @@ class StrategyUpdater:
         NameUpdater().visit(tree)
 
         # first fix the comments, so it understands "\n" properly inside multi line comments.
-        ast.fix_missing_locations(tree)
-        ast.increment_lineno(tree, n=1)
+        ast_comments.fix_missing_locations(tree)
+        ast_comments.increment_lineno(tree, n=1)
 
         # generate the new code from the updated AST
         # without indent {} parameters would just be written straight one after the other.
-        return astor.to_source(tree)
+
+        # ast_comments would be amazing since this is the only solution that carries over comments,
+        # but it does currently not have an unparse function, hopefully in the future ... !
+        # return ast_comments.unparse(tree)
+
+        return ast_comments.unparse(tree)
 
 
 # Here we go through each respective node, slice, elt, key ... to replace outdated entries.
-class NameUpdater(ast.NodeTransformer):
+class NameUpdater(ast_comments.NodeTransformer):
     def generic_visit(self, node):
 
         # space is not yet transferred from buy/sell to entry/exit and thereby has to be skipped.
-        if isinstance(node, ast.keyword):
+        if isinstance(node, ast_comments.keyword):
             if node.arg == "space":
                 return node
 
         # from here on this is the original function.
-        for field, old_value in ast.iter_fields(node):
+        for field, old_value in ast_comments.iter_fields(node):
             if isinstance(old_value, list):
                 new_values = []
                 for value in old_value:
-                    if isinstance(value, ast.AST):
+                    if isinstance(value, ast_comments.AST):
                         value = self.visit(value)
                         if value is None:
                             continue
-                        elif not isinstance(value, ast.AST):
+                        elif not isinstance(value, ast_comments.AST):
                             new_values.extend(value)
                             continue
                     new_values.append(value)
                 old_value[:] = new_values
-            elif isinstance(old_value, ast.AST):
+            elif isinstance(old_value, ast_comments.AST):
                 new_node = self.visit(old_value)
                 if new_node is None:
                     delattr(node, field)
@@ -163,8 +167,8 @@ class NameUpdater(ast.NodeTransformer):
         #        node.module = "freqtrade.strategy"
         return node
 
-    def visit_If(self, node: ast.If):
-        for child in ast.iter_child_nodes(node):
+    def visit_If(self, node: ast_comments.If):
+        for child in ast_comments.iter_child_nodes(node):
             self.visit(child)
         return node
 
@@ -175,7 +179,7 @@ class NameUpdater(ast.NodeTransformer):
 
     def visit_Attribute(self, node):
         if (
-                isinstance(node.value, ast.Name)
+                isinstance(node.value, ast_comments.Name)
                 and node.value.id == 'trades'
                 and node.attr == 'nr_of_successful_buys'
         ):
@@ -184,33 +188,33 @@ class NameUpdater(ast.NodeTransformer):
 
     def visit_ClassDef(self, node):
         # check if the class is derived from IStrategy
-        if any(isinstance(base, ast.Name) and
+        if any(isinstance(base, ast_comments.Name) and
                base.id == 'IStrategy' for base in node.bases):
             # check if the INTERFACE_VERSION variable exists
             has_interface_version = any(
-                isinstance(child, ast.Assign) and
-                isinstance(child.targets[0], ast.Name) and
+                isinstance(child, ast_comments.Assign) and
+                isinstance(child.targets[0], ast_comments.Name) and
                 child.targets[0].id == 'INTERFACE_VERSION'
                 for child in node.body
             )
 
             # if the INTERFACE_VERSION variable does not exist, add it as the first child
             if not has_interface_version:
-                node.body.insert(0, ast.parse('INTERFACE_VERSION = 3').body[0])
+                node.body.insert(0, ast_comments.parse('INTERFACE_VERSION = 3').body[0])
             # otherwise, update its value to 3
             else:
                 for child in node.body:
                     if (
-                            isinstance(child, ast.Assign)
-                            and isinstance(child.targets[0], ast.Name)
+                            isinstance(child, ast_comments.Assign)
+                            and isinstance(child.targets[0], ast_comments.Name)
                             and child.targets[0].id == 'INTERFACE_VERSION'
                     ):
-                        child.value = ast.parse('3').body[0].value
+                        child.value = ast_comments.parse('3').body[0].value
         self.generic_visit(node)
         return node
 
     def visit_Subscript(self, node):
-        if isinstance(node.slice, ast.Constant):
+        if isinstance(node.slice, ast_comments.Constant):
             if node.slice.value in StrategyUpdater.rename_dict:
                 # Replace the slice attributes with the values from rename_dict
                 node.slice.value = StrategyUpdater.rename_dict[node.slice.value]
@@ -232,12 +236,12 @@ class NameUpdater(ast.NodeTransformer):
 
     # sub function again needed since the structure itself is highly flexible ...
     def visit_elt(self, elt):
-        if isinstance(elt, ast.Constant) and elt.value in StrategyUpdater.rename_dict:
+        if isinstance(elt, ast_comments.Constant) and elt.value in StrategyUpdater.rename_dict:
             elt.value = StrategyUpdater.rename_dict[elt.value]
         if hasattr(elt, "elts"):
             self.visit_elts(elt.elts)
         if hasattr(elt, "args"):
-            if isinstance(elt.args, ast.arguments):
+            if isinstance(elt.args, ast_comments.arguments):
                 self.visit_elts(elt.args)
             else:
                 for arg in elt.args:
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index a00340427..927c5e99f 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -65,7 +65,23 @@ sell_reason == 'sell_signal'
 sell_reason == 'force_sell'
 sell_reason == 'emergency_sell'
 """)
+    modified_code9 = instance_strategy_updater.update_code("""
+# This is the 1st comment
+import talib.abstract as ta
+# This is the 2nd comment
+import freqtrade.vendor.qtpylib.indicators as qtpylib
 
+
+class someStrategy(IStrategy):
+    # This is the 3rd comment
+    # This attribute will be overridden if the config file contains "minimal_roi"
+    minimal_roi = {
+        "0": 0.50
+    }
+
+    # This is the 4th comment
+    stoploss = -0.1
+""")
     # currently still missing:
     # Webhook terminology, Telegram notification settings, Strategy/Config settings
 
@@ -108,3 +124,7 @@ sell_reason == 'emergency_sell'
     assert "exit_reason" in modified_code8
     assert "force_exit" in modified_code8
     assert "emergency_exit" in modified_code8
+
+    assert "This is the 1st comment" in modified_code9
+    assert "This is the 2nd comment" in modified_code9
+    assert "This is the 3rd comment" in modified_code9

From bcef00edeef1ea1e5611aef6d6d39eb31448195f Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Fri, 17 Feb 2023 21:04:26 +0100
Subject: [PATCH 016/147] changed to ast_comments, added tests for comments.

---
 user_data/strategies/.gitkeep | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 user_data/strategies/.gitkeep

diff --git a/user_data/strategies/.gitkeep b/user_data/strategies/.gitkeep
deleted file mode 100644
index e69de29bb..000000000

From 87b75134016ed748b5d6732a21fc7ca053ca2631 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Fri, 3 Mar 2023 18:53:09 +0100
Subject: [PATCH 017/147] fixed --strategy-list moved ast comments to
 requirements.txt >=1.0.0 (since that is the first version that adds the
 comments unparsing)

---
 freqtrade/commands/strategy_utils_commands.py | 2 +-
 requirements.txt                              | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index dc94f2b67..0124b73b6 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -25,7 +25,7 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
         config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
 
     filtered_strategy_objs = []
-    if hasattr(args, "strategy_list"):
+    if 'strategy_list' in args:
         for args_strategy in args['strategy_list']:
             for strategy_obj in strategy_objs:
                 if (strategy_obj['name'] == args_strategy
diff --git a/requirements.txt b/requirements.txt
index 40bae63b6..14c468da0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -58,4 +58,4 @@ schedule==1.1.0
 websockets==10.4
 janus==1.0.0
 
-astor~=0.8.1
+ast-comments>=1.0.0

From a3dee9350f2a4c9f17491b402a4613c66cc1e3d0 Mon Sep 17 00:00:00 2001
From: Andy Lawless <paranoidandy@msn.com>
Date: Fri, 3 Mar 2023 20:37:05 +0000
Subject: [PATCH 018/147] Move bot_loop_start call to run on every candle

---
 freqtrade/optimize/backtesting.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index 83b65d24b..ccb027317 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -205,7 +205,6 @@ class Backtesting:
         self.strategy.order_types['stoploss_on_exchange'] = False
 
         self.strategy.ft_bot_start()
-        strategy_safe_wrapper(self.strategy.bot_loop_start, supress_error=True)()
 
     def _load_protections(self, strategy: IStrategy):
         if self.config.get('enable_protections', False):
@@ -1159,6 +1158,7 @@ class Backtesting:
         while current_time <= end_date:
             open_trade_count_start = LocalTrade.bt_open_open_trade_count
             self.check_abort()
+            strategy_safe_wrapper(self.strategy.bot_loop_start, supress_error=True)()
             for i, pair in enumerate(data):
                 row_index = indexes[pair]
                 row = self.validate_row(data, pair, row_index, current_time)

From b262f0b3742033df7688e5ffb1d3affede620090 Mon Sep 17 00:00:00 2001
From: Andy Lawless <paranoidandy@msn.com>
Date: Fri, 3 Mar 2023 20:46:43 +0000
Subject: [PATCH 019/147] Update docs re: bot_loop_start in backtest

---
 docs/bot-basics.md         | 2 +-
 docs/strategy-callbacks.md | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/bot-basics.md b/docs/bot-basics.md
index 925fc7862..1d5668eb3 100644
--- a/docs/bot-basics.md
+++ b/docs/bot-basics.md
@@ -57,10 +57,10 @@ This loop will be repeated again and again until the bot is stopped.
 
 * Load historic data for configured pairlist.
 * Calls `bot_start()` once.
-* Calls `bot_loop_start()` once.
 * Calculate indicators (calls `populate_indicators()` once per pair).
 * Calculate entry / exit signals (calls `populate_entry_trend()` and `populate_exit_trend()` once per pair).
 * Loops per candle simulating entry and exit points.
+  * Calls `bot_loop_start()` strategy callback.
   * Check for Order timeouts, either via the `unfilledtimeout` configuration, or via `check_entry_timeout()` / `check_exit_timeout()` strategy callbacks.
   * Calls `adjust_entry_price()` strategy callback for open entry orders.
   * Check for trade entry signals (`enter_long` / `enter_short` columns).
diff --git a/docs/strategy-callbacks.md b/docs/strategy-callbacks.md
index 81366c66e..64b6bd551 100644
--- a/docs/strategy-callbacks.md
+++ b/docs/strategy-callbacks.md
@@ -51,7 +51,8 @@ During hyperopt, this runs only once at startup.
 
 ## Bot loop start
 
-A simple callback which is called once at the start of every bot throttling iteration (roughly every 5 seconds, unless configured differently).
+A simple callback which is called once at the start of every bot throttling iteration in dry/live mode (roughly every 5
+seconds, unless configured differently) or once per candle in backtest/hyperopt mode.
 This can be used to perform calculations which are pair independent (apply to all pairs), loading of external data, etc.
 
 ``` python

From d0d6f53dec489d022fd301375bf4478646b0a41f Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Sun, 5 Mar 2023 16:19:26 +0100
Subject: [PATCH 020/147] fixed github formatting errors

---
 freqtrade/commands/strategy_utils_commands.py | 6 +++---
 freqtrade/strategy/strategyupdater.py         | 7 +++----
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 0124b73b6..aca368742 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -1,6 +1,6 @@
 import logging
-import os
 import time
+from pathlib import Path
 from typing import Any, Dict
 
 from freqtrade.configuration import setup_utils_configuration
@@ -45,11 +45,11 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
 
 def start_conversion(strategy_obj, config):
     # try:
-    print(f"Conversion of {os.path.basename(strategy_obj['location'])} started.")
+    print(f"Conversion of {Path(strategy_obj['location']).name} started.")
     instance_strategy_updater = StrategyUpdater()
     start = time.perf_counter()
     instance_strategy_updater.start(config, strategy_obj)
     elapsed = time.perf_counter() - start
-    print(f"Conversion of {os.path.basename(strategy_obj['location'])} took {elapsed:.1f} seconds.")
+    print(f"Conversion of {Path(strategy_obj['location']).name} took {elapsed:.1f} seconds.")
     # except:
     #    pass
diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index db19d4fba..6fe1f326c 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -1,4 +1,3 @@
-import os
 import shutil
 from pathlib import Path
 
@@ -55,10 +54,10 @@ class StrategyUpdater:
         target_file = Path.joinpath(strategies_backup_folder, strategy_obj['location_rel'])
 
         # read the file
-        with open(source_file, 'r') as f:
+        with Path(source_file).open('r') as f:
             old_code = f.read()
         if not strategies_backup_folder.is_dir():
-            os.makedirs(strategies_backup_folder)
+            Path(strategies_backup_folder).mkdir(parents=True, exist_ok=True)
 
         # backup original
         # => currently no date after the filename,
@@ -69,7 +68,7 @@ class StrategyUpdater:
         # update the code
         new_code = self.update_code(old_code)
         # write the modified code to the destination folder
-        with open(source_file, 'w') as f:
+        with Path(source_file).open('w') as f:
             f.write(new_code)
 
     # define the function to update the code

From b072fae507200321d2a4cb3ce81f27e2eb879d34 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Sun, 5 Mar 2023 18:48:32 +0100
Subject: [PATCH 021/147] added strategy-updater compartment inside utils.md

---
 docs/utils.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/docs/utils.md b/docs/utils.md
index 87c7f6aa6..3d6eda3ce 100644
--- a/docs/utils.md
+++ b/docs/utils.md
@@ -947,7 +947,6 @@ Common arguments:
   --userdir PATH, --user-data-dir PATH
                         Path to userdata directory.
 ```
-
 ### Examples
 
 Print trades with id 2 and 3 as json
@@ -955,3 +954,13 @@ Print trades with id 2 and 3 as json
 ``` bash
 freqtrade show-trades --db-url sqlite:///tradesv3.sqlite --trade-ids 2 3 --print-json
 ```
+
+### Strategy-Updater
+Updates a list strategies or all strategies within the strategies folder to be v3 compliant including futures.
+If the command runs without --strategy-list then all files inside the strategies folder will be converted.
+```
+usage: freqtrade strategy_updater 
+
+optional arguments:
+  --strategy-list       defines a list of strategies that should be converted
+```

From 30fd1e742efead96b3ae12fa75b44d1be7231560 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 9 Mar 2023 07:14:54 +0000
Subject: [PATCH 022/147] Add 3.8 block for strategyUpdater

---
 freqtrade/commands/strategy_utils_commands.py | 4 ++++
 tests/test_strategy_updater.py                | 8 ++++++++
 2 files changed, 12 insertions(+)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index aca368742..ed4d0bf1a 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -1,4 +1,5 @@
 import logging
+import sys
 import time
 from pathlib import Path
 from typing import Any, Dict
@@ -19,6 +20,9 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     :return: None
     """
 
+    if sys.version_info == (3, 8):  # pragma: no cover
+        sys.exit("Freqtrade strategy updater requires Python version >= 3.9")
+
     config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
 
     strategy_objs = StrategyResolver.search_all_objects(
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 927c5e99f..ea971af72 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -1,8 +1,16 @@
 # pragma pylint: disable=missing-docstring, protected-access, invalid-name
 
+import sys
+
+import pytest
+
 from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
+if sys.version_info < (3, 9):
+    pytest.skip("StrategyUpdater is not compatible with Python 3.8", allow_module_level=True)
+
+
 def test_strategy_updater(default_conf, caplog) -> None:
     instance_strategy_updater = StrategyUpdater()
     modified_code1 = instance_strategy_updater.update_code("""

From bfc7f48f17c82b759e8a012e372b3ee92017263a Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Fri, 10 Mar 2023 08:59:07 +0100
Subject: [PATCH 023/147] added checks for python3.8  or lower since
 ast_comments.unparse() needs python 3.9 or higher. testing with python 3.8
 would make the build fail tests, skipping it there.

---
 freqtrade/commands/strategy_utils_commands.py |  47 ++--
 tests/test_strategy_updater.py                | 227 +++++++++---------
 2 files changed, 143 insertions(+), 131 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index aca368742..56a28cf65 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -1,4 +1,5 @@
 import logging
+import sys
 import time
 from pathlib import Path
 from typing import Any, Dict
@@ -19,28 +20,34 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     :return: None
     """
 
-    config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
+    if sys.version_info <= (3, 8):
+        print("This code requires Python 3.9 or higher. "
+              "We cannot continue. "
+              "Please upgrade your python version to use this command.")
 
-    strategy_objs = StrategyResolver.search_all_objects(
-        config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
-
-    filtered_strategy_objs = []
-    if 'strategy_list' in args:
-        for args_strategy in args['strategy_list']:
-            for strategy_obj in strategy_objs:
-                if (strategy_obj['name'] == args_strategy
-                        and strategy_obj not in filtered_strategy_objs):
-                    filtered_strategy_objs.append(strategy_obj)
-                    break
-
-        for filtered_strategy_obj in filtered_strategy_objs:
-            start_conversion(filtered_strategy_obj, config)
     else:
-        processed_locations = set()
-        for strategy_obj in strategy_objs:
-            if strategy_obj['location'] not in processed_locations:
-                processed_locations.add(strategy_obj['location'])
-                start_conversion(strategy_obj, config)
+        config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
+
+        strategy_objs = StrategyResolver.search_all_objects(
+            config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
+
+        filtered_strategy_objs = []
+        if 'strategy_list' in args:
+            for args_strategy in args['strategy_list']:
+                for strategy_obj in strategy_objs:
+                    if (strategy_obj['name'] == args_strategy
+                            and strategy_obj not in filtered_strategy_objs):
+                        filtered_strategy_objs.append(strategy_obj)
+                        break
+
+            for filtered_strategy_obj in filtered_strategy_objs:
+                start_conversion(filtered_strategy_obj, config)
+        else:
+            processed_locations = set()
+            for strategy_obj in strategy_objs:
+                if strategy_obj['location'] not in processed_locations:
+                    processed_locations.add(strategy_obj['location'])
+                    start_conversion(strategy_obj, config)
 
 
 def start_conversion(strategy_obj, config):
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 927c5e99f..3831c2ee6 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -1,130 +1,135 @@
 # pragma pylint: disable=missing-docstring, protected-access, invalid-name
 
+import sys
+
 from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 def test_strategy_updater(default_conf, caplog) -> None:
-    instance_strategy_updater = StrategyUpdater()
-    modified_code1 = instance_strategy_updater.update_code("""
-class testClass(IStrategy):
-    def populate_buy_trend():
-        pass
-    def populate_sell_trend():
-        pass
-    def check_buy_timeout():
-        pass
-    def check_sell_timeout():
-        pass
-    def custom_sell():
-        pass
-""")
-    modified_code2 = instance_strategy_updater.update_code("""
-ticker_interval = '15m'
-buy_some_parameter = IntParameter(space='buy')
-sell_some_parameter = IntParameter(space='sell')
-""")
-    modified_code3 = instance_strategy_updater.update_code("""
-use_sell_signal = True
-sell_profit_only = True
-sell_profit_offset = True
-ignore_roi_if_buy_signal = True
-forcebuy_enable = True
-""")
-    modified_code4 = instance_strategy_updater.update_code("""
-dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
-dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
-""")
-    modified_code5 = instance_strategy_updater.update_code("""
-def confirm_trade_exit(sell_reason: str):
-    pass
+    if sys.version_info <= (3, 8):
+        print("skipped tests since python version is 3.8 or lower.")
+    else:
+        instance_strategy_updater = StrategyUpdater()
+        modified_code1 = instance_strategy_updater.update_code("""
+    class testClass(IStrategy):
+        def populate_buy_trend():
+            pass
+        def populate_sell_trend():
+            pass
+        def check_buy_timeout():
+            pass
+        def check_sell_timeout():
+            pass
+        def custom_sell():
+            pass
     """)
-    modified_code6 = instance_strategy_updater.update_code("""
-order_time_in_force = {
-    'buy': 'gtc',
-    'sell': 'ioc'
-}
-order_types = {
-    'buy': 'limit',
-    'sell': 'market',
-    'stoploss': 'market',
-    'stoploss_on_exchange': False
-}
-unfilledtimeout = {
-    'buy': 1,
-    'sell': 2
-}
-""")
-
-    modified_code7 = instance_strategy_updater.update_code("""
-def confirm_trade_exit(sell_reason):
-    if (sell_reason == 'stop_loss'):
+        modified_code2 = instance_strategy_updater.update_code("""
+    ticker_interval = '15m'
+    buy_some_parameter = IntParameter(space='buy')
+    sell_some_parameter = IntParameter(space='sell')
+    """)
+        modified_code3 = instance_strategy_updater.update_code("""
+    use_sell_signal = True
+    sell_profit_only = True
+    sell_profit_offset = True
+    ignore_roi_if_buy_signal = True
+    forcebuy_enable = True
+    """)
+        modified_code4 = instance_strategy_updater.update_code("""
+    dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
+    dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
+    """)
+        modified_code5 = instance_strategy_updater.update_code("""
+    def confirm_trade_exit(sell_reason: str):
         pass
-""")
-    modified_code8 = instance_strategy_updater.update_code("""
-sell_reason == 'sell_signal'
-sell_reason == 'force_sell'
-sell_reason == 'emergency_sell'
-""")
-    modified_code9 = instance_strategy_updater.update_code("""
-# This is the 1st comment
-import talib.abstract as ta
-# This is the 2nd comment
-import freqtrade.vendor.qtpylib.indicators as qtpylib
-
-
-class someStrategy(IStrategy):
-    # This is the 3rd comment
-    # This attribute will be overridden if the config file contains "minimal_roi"
-    minimal_roi = {
-        "0": 0.50
+        """)
+        modified_code6 = instance_strategy_updater.update_code("""
+    order_time_in_force = {
+        'buy': 'gtc',
+        'sell': 'ioc'
     }
+    order_types = {
+        'buy': 'limit',
+        'sell': 'market',
+        'stoploss': 'market',
+        'stoploss_on_exchange': False
+    }
+    unfilledtimeout = {
+        'buy': 1,
+        'sell': 2
+    }
+    """)
 
-    # This is the 4th comment
-    stoploss = -0.1
-""")
-    # currently still missing:
-    # Webhook terminology, Telegram notification settings, Strategy/Config settings
+        modified_code7 = instance_strategy_updater.update_code("""
+    def confirm_trade_exit(sell_reason):
+        if (sell_reason == 'stop_loss'):
+            pass
+    """)
+        modified_code8 = instance_strategy_updater.update_code("""
+    sell_reason == 'sell_signal'
+    sell_reason == 'force_sell'
+    sell_reason == 'emergency_sell'
+    """)
+        modified_code9 = instance_strategy_updater.update_code("""
+    # This is the 1st comment
+    import talib.abstract as ta
+    # This is the 2nd comment
+    import freqtrade.vendor.qtpylib.indicators as qtpylib
 
-    assert "populate_entry_trend" in modified_code1
-    assert "populate_exit_trend" in modified_code1
-    assert "check_entry_timeout" in modified_code1
-    assert "check_exit_timeout" in modified_code1
-    assert "custom_exit" in modified_code1
-    assert "INTERFACE_VERSION = 3" in modified_code1
 
-    assert "timeframe" in modified_code2
-    # check for not editing hyperopt spaces
-    assert "space='buy'" in modified_code2
-    assert "space='sell'" in modified_code2
+    class someStrategy(IStrategy):
+        # This is the 3rd comment
+        # This attribute will be overridden if the config file contains "minimal_roi"
+        minimal_roi = {
+            "0": 0.50
+        }
 
-    assert "use_exit_signal" in modified_code3
-    assert "exit_profit_only" in modified_code3
-    assert "exit_profit_offset" in modified_code3
-    assert "ignore_roi_if_entry_signal" in modified_code3
-    assert "force_entry_enable" in modified_code3
+        # This is the 4th comment
+        stoploss = -0.1
+    """)
+        # currently still missing:
+        # Webhook terminology, Telegram notification settings, Strategy/Config settings
 
-    assert "enter_long" in modified_code4
-    assert "exit_long" in modified_code4
-    assert "enter_tag" in modified_code4
+        assert "populate_entry_trend" in modified_code1
+        assert "populate_exit_trend" in modified_code1
+        assert "check_entry_timeout" in modified_code1
+        assert "check_exit_timeout" in modified_code1
+        assert "custom_exit" in modified_code1
+        assert "INTERFACE_VERSION = 3" in modified_code1
 
-    assert "exit_reason" in modified_code5
+        assert "timeframe" in modified_code2
+        # check for not editing hyperopt spaces
+        assert "space='buy'" in modified_code2
+        assert "space='sell'" in modified_code2
 
-    assert "'entry': 'gtc'" in modified_code6
-    assert "'exit': 'ioc'" in modified_code6
-    assert "'entry': 'limit'" in modified_code6
-    assert "'exit': 'market'" in modified_code6
-    assert "'entry': 1" in modified_code6
-    assert "'exit': 2" in modified_code6
+        assert "use_exit_signal" in modified_code3
+        assert "exit_profit_only" in modified_code3
+        assert "exit_profit_offset" in modified_code3
+        assert "ignore_roi_if_entry_signal" in modified_code3
+        assert "force_entry_enable" in modified_code3
 
-    assert "exit_reason" in modified_code7
-    assert "exit_reason == 'stop_loss'" in modified_code7
+        assert "enter_long" in modified_code4
+        assert "exit_long" in modified_code4
+        assert "enter_tag" in modified_code4
 
-    # those tests currently don't work, next in line.
-    assert "exit_signal" in modified_code8
-    assert "exit_reason" in modified_code8
-    assert "force_exit" in modified_code8
-    assert "emergency_exit" in modified_code8
+        assert "exit_reason" in modified_code5
 
-    assert "This is the 1st comment" in modified_code9
-    assert "This is the 2nd comment" in modified_code9
-    assert "This is the 3rd comment" in modified_code9
+        assert "'entry': 'gtc'" in modified_code6
+        assert "'exit': 'ioc'" in modified_code6
+        assert "'entry': 'limit'" in modified_code6
+        assert "'exit': 'market'" in modified_code6
+        assert "'entry': 1" in modified_code6
+        assert "'exit': 2" in modified_code6
+
+        assert "exit_reason" in modified_code7
+        assert "exit_reason == 'stop_loss'" in modified_code7
+
+        # those tests currently don't work, next in line.
+        assert "exit_signal" in modified_code8
+        assert "exit_reason" in modified_code8
+        assert "force_exit" in modified_code8
+        assert "emergency_exit" in modified_code8
+
+        assert "This is the 1st comment" in modified_code9
+        assert "This is the 2nd comment" in modified_code9
+        assert "This is the 3rd comment" in modified_code9

From a3988f56b28ddef95fd425e9804d3154491ad994 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Fri, 10 Mar 2023 09:23:56 +0100
Subject: [PATCH 024/147] Sorry matthias, did not see that you already
 committed something and did overwrite you. Added your version to it instead
 of mine and pushed again (since it was already overwritten by me).

---
 freqtrade/commands/strategy_utils_commands.py |  45 ++--
 tests/test_strategy_updater.py                | 232 +++++++++---------
 2 files changed, 138 insertions(+), 139 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index 56a28cf65..ed4d0bf1a 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -20,34 +20,31 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
     :return: None
     """
 
-    if sys.version_info <= (3, 8):
-        print("This code requires Python 3.9 or higher. "
-              "We cannot continue. "
-              "Please upgrade your python version to use this command.")
+    if sys.version_info == (3, 8):  # pragma: no cover
+        sys.exit("Freqtrade strategy updater requires Python version >= 3.9")
 
-    else:
-        config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
+    config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
 
-        strategy_objs = StrategyResolver.search_all_objects(
-            config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
+    strategy_objs = StrategyResolver.search_all_objects(
+        config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
 
-        filtered_strategy_objs = []
-        if 'strategy_list' in args:
-            for args_strategy in args['strategy_list']:
-                for strategy_obj in strategy_objs:
-                    if (strategy_obj['name'] == args_strategy
-                            and strategy_obj not in filtered_strategy_objs):
-                        filtered_strategy_objs.append(strategy_obj)
-                        break
-
-            for filtered_strategy_obj in filtered_strategy_objs:
-                start_conversion(filtered_strategy_obj, config)
-        else:
-            processed_locations = set()
+    filtered_strategy_objs = []
+    if 'strategy_list' in args:
+        for args_strategy in args['strategy_list']:
             for strategy_obj in strategy_objs:
-                if strategy_obj['location'] not in processed_locations:
-                    processed_locations.add(strategy_obj['location'])
-                    start_conversion(strategy_obj, config)
+                if (strategy_obj['name'] == args_strategy
+                        and strategy_obj not in filtered_strategy_objs):
+                    filtered_strategy_objs.append(strategy_obj)
+                    break
+
+        for filtered_strategy_obj in filtered_strategy_objs:
+            start_conversion(filtered_strategy_obj, config)
+    else:
+        processed_locations = set()
+        for strategy_obj in strategy_objs:
+            if strategy_obj['location'] not in processed_locations:
+                processed_locations.add(strategy_obj['location'])
+                start_conversion(strategy_obj, config)
 
 
 def start_conversion(strategy_obj, config):
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 3831c2ee6..26d173871 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -2,134 +2,136 @@
 
 import sys
 
+import pytest
+
 from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
 def test_strategy_updater(default_conf, caplog) -> None:
-    if sys.version_info <= (3, 8):
-        print("skipped tests since python version is 3.8 or lower.")
-    else:
-        instance_strategy_updater = StrategyUpdater()
-        modified_code1 = instance_strategy_updater.update_code("""
-    class testClass(IStrategy):
-        def populate_buy_trend():
-            pass
-        def populate_sell_trend():
-            pass
-        def check_buy_timeout():
-            pass
-        def check_sell_timeout():
-            pass
-        def custom_sell():
-            pass
-    """)
-        modified_code2 = instance_strategy_updater.update_code("""
-    ticker_interval = '15m'
-    buy_some_parameter = IntParameter(space='buy')
-    sell_some_parameter = IntParameter(space='sell')
-    """)
-        modified_code3 = instance_strategy_updater.update_code("""
-    use_sell_signal = True
-    sell_profit_only = True
-    sell_profit_offset = True
-    ignore_roi_if_buy_signal = True
-    forcebuy_enable = True
-    """)
-        modified_code4 = instance_strategy_updater.update_code("""
-    dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
-    dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
-    """)
-        modified_code5 = instance_strategy_updater.update_code("""
-    def confirm_trade_exit(sell_reason: str):
+    if sys.version_info < (3, 9):
+        pytest.skip("StrategyUpdater is not compatible with Python 3.8", allow_module_level=True)
+
+    instance_strategy_updater = StrategyUpdater()
+    modified_code1 = instance_strategy_updater.update_code("""
+class testClass(IStrategy):
+    def populate_buy_trend():
         pass
-        """)
-        modified_code6 = instance_strategy_updater.update_code("""
-    order_time_in_force = {
-        'buy': 'gtc',
-        'sell': 'ioc'
+    def populate_sell_trend():
+        pass
+    def check_buy_timeout():
+        pass
+    def check_sell_timeout():
+        pass
+    def custom_sell():
+        pass
+""")
+    modified_code2 = instance_strategy_updater.update_code("""
+ticker_interval = '15m'
+buy_some_parameter = IntParameter(space='buy')
+sell_some_parameter = IntParameter(space='sell')
+""")
+    modified_code3 = instance_strategy_updater.update_code("""
+use_sell_signal = True
+sell_profit_only = True
+sell_profit_offset = True
+ignore_roi_if_buy_signal = True
+forcebuy_enable = True
+""")
+    modified_code4 = instance_strategy_updater.update_code("""
+dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
+dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
+""")
+    modified_code5 = instance_strategy_updater.update_code("""
+def confirm_trade_exit(sell_reason: str):
+    pass
+    """)
+    modified_code6 = instance_strategy_updater.update_code("""
+order_time_in_force = {
+    'buy': 'gtc',
+    'sell': 'ioc'
+}
+order_types = {
+    'buy': 'limit',
+    'sell': 'market',
+    'stoploss': 'market',
+    'stoploss_on_exchange': False
+}
+unfilledtimeout = {
+    'buy': 1,
+    'sell': 2
+}
+""")
+
+    modified_code7 = instance_strategy_updater.update_code("""
+def confirm_trade_exit(sell_reason):
+    if (sell_reason == 'stop_loss'):
+        pass
+""")
+    modified_code8 = instance_strategy_updater.update_code("""
+sell_reason == 'sell_signal'
+sell_reason == 'force_sell'
+sell_reason == 'emergency_sell'
+""")
+    modified_code9 = instance_strategy_updater.update_code("""
+# This is the 1st comment
+import talib.abstract as ta
+# This is the 2nd comment
+import freqtrade.vendor.qtpylib.indicators as qtpylib
+
+
+class someStrategy(IStrategy):
+    # This is the 3rd comment
+    # This attribute will be overridden if the config file contains "minimal_roi"
+    minimal_roi = {
+        "0": 0.50
     }
-    order_types = {
-        'buy': 'limit',
-        'sell': 'market',
-        'stoploss': 'market',
-        'stoploss_on_exchange': False
-    }
-    unfilledtimeout = {
-        'buy': 1,
-        'sell': 2
-    }
-    """)
 
-        modified_code7 = instance_strategy_updater.update_code("""
-    def confirm_trade_exit(sell_reason):
-        if (sell_reason == 'stop_loss'):
-            pass
-    """)
-        modified_code8 = instance_strategy_updater.update_code("""
-    sell_reason == 'sell_signal'
-    sell_reason == 'force_sell'
-    sell_reason == 'emergency_sell'
-    """)
-        modified_code9 = instance_strategy_updater.update_code("""
-    # This is the 1st comment
-    import talib.abstract as ta
-    # This is the 2nd comment
-    import freqtrade.vendor.qtpylib.indicators as qtpylib
+    # This is the 4th comment
+    stoploss = -0.1
+""")
+    # currently still missing:
+    # Webhook terminology, Telegram notification settings, Strategy/Config settings
 
+    assert "populate_entry_trend" in modified_code1
+    assert "populate_exit_trend" in modified_code1
+    assert "check_entry_timeout" in modified_code1
+    assert "check_exit_timeout" in modified_code1
+    assert "custom_exit" in modified_code1
+    assert "INTERFACE_VERSION = 3" in modified_code1
 
-    class someStrategy(IStrategy):
-        # This is the 3rd comment
-        # This attribute will be overridden if the config file contains "minimal_roi"
-        minimal_roi = {
-            "0": 0.50
-        }
+    assert "timeframe" in modified_code2
+    # check for not editing hyperopt spaces
+    assert "space='buy'" in modified_code2
+    assert "space='sell'" in modified_code2
 
-        # This is the 4th comment
-        stoploss = -0.1
-    """)
-        # currently still missing:
-        # Webhook terminology, Telegram notification settings, Strategy/Config settings
+    assert "use_exit_signal" in modified_code3
+    assert "exit_profit_only" in modified_code3
+    assert "exit_profit_offset" in modified_code3
+    assert "ignore_roi_if_entry_signal" in modified_code3
+    assert "force_entry_enable" in modified_code3
 
-        assert "populate_entry_trend" in modified_code1
-        assert "populate_exit_trend" in modified_code1
-        assert "check_entry_timeout" in modified_code1
-        assert "check_exit_timeout" in modified_code1
-        assert "custom_exit" in modified_code1
-        assert "INTERFACE_VERSION = 3" in modified_code1
+    assert "enter_long" in modified_code4
+    assert "exit_long" in modified_code4
+    assert "enter_tag" in modified_code4
 
-        assert "timeframe" in modified_code2
-        # check for not editing hyperopt spaces
-        assert "space='buy'" in modified_code2
-        assert "space='sell'" in modified_code2
+    assert "exit_reason" in modified_code5
 
-        assert "use_exit_signal" in modified_code3
-        assert "exit_profit_only" in modified_code3
-        assert "exit_profit_offset" in modified_code3
-        assert "ignore_roi_if_entry_signal" in modified_code3
-        assert "force_entry_enable" in modified_code3
+    assert "'entry': 'gtc'" in modified_code6
+    assert "'exit': 'ioc'" in modified_code6
+    assert "'entry': 'limit'" in modified_code6
+    assert "'exit': 'market'" in modified_code6
+    assert "'entry': 1" in modified_code6
+    assert "'exit': 2" in modified_code6
 
-        assert "enter_long" in modified_code4
-        assert "exit_long" in modified_code4
-        assert "enter_tag" in modified_code4
+    assert "exit_reason" in modified_code7
+    assert "exit_reason == 'stop_loss'" in modified_code7
 
-        assert "exit_reason" in modified_code5
+    # those tests currently don't work, next in line.
+    assert "exit_signal" in modified_code8
+    assert "exit_reason" in modified_code8
+    assert "force_exit" in modified_code8
+    assert "emergency_exit" in modified_code8
 
-        assert "'entry': 'gtc'" in modified_code6
-        assert "'exit': 'ioc'" in modified_code6
-        assert "'entry': 'limit'" in modified_code6
-        assert "'exit': 'market'" in modified_code6
-        assert "'entry': 1" in modified_code6
-        assert "'exit': 2" in modified_code6
-
-        assert "exit_reason" in modified_code7
-        assert "exit_reason == 'stop_loss'" in modified_code7
-
-        # those tests currently don't work, next in line.
-        assert "exit_signal" in modified_code8
-        assert "exit_reason" in modified_code8
-        assert "force_exit" in modified_code8
-        assert "emergency_exit" in modified_code8
-
-        assert "This is the 1st comment" in modified_code9
-        assert "This is the 2nd comment" in modified_code9
-        assert "This is the 3rd comment" in modified_code9
+    assert "This is the 1st comment" in modified_code9
+    assert "This is the 2nd comment" in modified_code9
+    assert "This is the 3rd comment" in modified_code9

From 82cb107520d2709afde40f40c342590f3d860a1b Mon Sep 17 00:00:00 2001
From: initrv <ctumko@gmail.com>
Date: Sun, 12 Mar 2023 01:32:55 +0300
Subject: [PATCH 025/147] add tensorboard category

---
 docs/freqai-reinforcement-learning.md         |  4 ++--
 freqtrade/freqai/RL/Base3ActionRLEnv.py       |  2 +-
 freqtrade/freqai/RL/Base4ActionRLEnv.py       |  2 +-
 freqtrade/freqai/RL/Base5ActionRLEnv.py       |  2 +-
 freqtrade/freqai/RL/BaseEnvironment.py        | 21 ++++++++++++-------
 freqtrade/freqai/RL/TensorboardCallback.py    | 14 ++++++-------
 .../prediction_models/ReinforcementLearner.py |  2 +-
 7 files changed, 26 insertions(+), 21 deletions(-)

diff --git a/docs/freqai-reinforcement-learning.md b/docs/freqai-reinforcement-learning.md
index 04ca42a5d..ed6a41825 100644
--- a/docs/freqai-reinforcement-learning.md
+++ b/docs/freqai-reinforcement-learning.md
@@ -248,13 +248,13 @@ FreqAI also provides a built in episodic summary logger called `self.tensorboard
             """
             def calculate_reward(self, action: int) -> float:
                 if not self._is_valid(action):
-                    self.tensorboard_log("is_valid")
+                    self.tensorboard_log("invalid")
                     return -2
 
 ```
 
 !!! Note
-    The `self.tensorboard_log()` function is designed for tracking incremented objects only i.e. events, actions inside the training environment. If the event of interest is a float, the float can be passed as the second argument e.g. `self.tensorboard_log("float_metric1", 0.23)` would add 0.23 to `float_metric`. In this case you can also disable incrementing using `inc=False` parameter.
+    The `self.tensorboard_log()` function is designed for tracking incremented objects only i.e. events, actions inside the training environment. If the event of interest is a float, the float can be passed as the second argument e.g. `self.tensorboard_log("float_metric1", 0.23)`. In this case the metric values are not incremented.
 
 ### Choosing a base environment
 
diff --git a/freqtrade/freqai/RL/Base3ActionRLEnv.py b/freqtrade/freqai/RL/Base3ActionRLEnv.py
index 3b5fffc58..a108d776e 100644
--- a/freqtrade/freqai/RL/Base3ActionRLEnv.py
+++ b/freqtrade/freqai/RL/Base3ActionRLEnv.py
@@ -47,7 +47,7 @@ class Base3ActionRLEnv(BaseEnvironment):
         self._update_unrealized_total_profit()
         step_reward = self.calculate_reward(action)
         self.total_reward += step_reward
-        self.tensorboard_log(self.actions._member_names_[action])
+        self.tensorboard_log(self.actions._member_names_[action], category="actions")
 
         trade_type = None
         if self.is_tradesignal(action):
diff --git a/freqtrade/freqai/RL/Base4ActionRLEnv.py b/freqtrade/freqai/RL/Base4ActionRLEnv.py
index 8f45028b1..4f093f06c 100644
--- a/freqtrade/freqai/RL/Base4ActionRLEnv.py
+++ b/freqtrade/freqai/RL/Base4ActionRLEnv.py
@@ -48,7 +48,7 @@ class Base4ActionRLEnv(BaseEnvironment):
         self._update_unrealized_total_profit()
         step_reward = self.calculate_reward(action)
         self.total_reward += step_reward
-        self.tensorboard_log(self.actions._member_names_[action])
+        self.tensorboard_log(self.actions._member_names_[action], category="actions")
 
         trade_type = None
         if self.is_tradesignal(action):
diff --git a/freqtrade/freqai/RL/Base5ActionRLEnv.py b/freqtrade/freqai/RL/Base5ActionRLEnv.py
index 22d3cae30..490ef3601 100644
--- a/freqtrade/freqai/RL/Base5ActionRLEnv.py
+++ b/freqtrade/freqai/RL/Base5ActionRLEnv.py
@@ -49,7 +49,7 @@ class Base5ActionRLEnv(BaseEnvironment):
         self._update_unrealized_total_profit()
         step_reward = self.calculate_reward(action)
         self.total_reward += step_reward
-        self.tensorboard_log(self.actions._member_names_[action])
+        self.tensorboard_log(self.actions._member_names_[action], category="actions")
 
         trade_type = None
         if self.is_tradesignal(action):
diff --git a/freqtrade/freqai/RL/BaseEnvironment.py b/freqtrade/freqai/RL/BaseEnvironment.py
index 7a4467bf7..df2a89d81 100644
--- a/freqtrade/freqai/RL/BaseEnvironment.py
+++ b/freqtrade/freqai/RL/BaseEnvironment.py
@@ -137,7 +137,8 @@ class BaseEnvironment(gym.Env):
         self.np_random, seed = seeding.np_random(seed)
         return [seed]
 
-    def tensorboard_log(self, metric: str, value: Union[int, float] = 1, inc: bool = True):
+    def tensorboard_log(self, metric: str, value: Optional[Union[int, float]] = None,
+                        category: str = "custom"):
         """
         Function builds the tensorboard_metrics dictionary
         to be parsed by the TensorboardCallback. This
@@ -149,17 +150,23 @@ class BaseEnvironment(gym.Env):
 
         def calculate_reward(self, action: int) -> float:
             if not self._is_valid(action):
-                self.tensorboard_log("is_valid")
+                self.tensorboard_log("invalid")
                 return -2
 
         :param metric: metric to be tracked and incremented
-        :param value: value to increment `metric` by
-        :param inc: sets whether the `value` is incremented or not
+        :param value: `metric` value
+        :param category: `metric` category
         """
-        if not inc or metric not in self.tensorboard_metrics:
-            self.tensorboard_metrics[metric] = value
+        increment = True if not value else False
+        value = 1 if increment else value
+
+        if category not in self.tensorboard_metrics:
+            self.tensorboard_metrics[category] = {}
+
+        if not increment or metric not in self.tensorboard_metrics[category]:
+            self.tensorboard_metrics[category][metric] = value
         else:
-            self.tensorboard_metrics[metric] += value
+            self.tensorboard_metrics[category][metric] += value
 
     def reset_tensorboard_log(self):
         self.tensorboard_metrics = {}
diff --git a/freqtrade/freqai/RL/TensorboardCallback.py b/freqtrade/freqai/RL/TensorboardCallback.py
index b596742e9..1828319cd 100644
--- a/freqtrade/freqai/RL/TensorboardCallback.py
+++ b/freqtrade/freqai/RL/TensorboardCallback.py
@@ -46,14 +46,12 @@ class TensorboardCallback(BaseCallback):
         local_info = self.locals["infos"][0]
         tensorboard_metrics = self.training_env.get_attr("tensorboard_metrics")[0]
 
-        for info in local_info:
-            if info not in ["episode", "terminal_observation"]:
-                self.logger.record(f"_info/{info}", local_info[info])
+        for metric in local_info:
+            if metric not in ["episode", "terminal_observation"]:
+                self.logger.record(f"info/{metric}", local_info[metric])
 
-        for info in tensorboard_metrics:
-            if info in [action.name for action in self.actions]:
-                self.logger.record(f"_actions/{info}", tensorboard_metrics[info])
-            else:
-                self.logger.record(f"_custom/{info}", tensorboard_metrics[info])
+        for category in tensorboard_metrics:
+            for metric in tensorboard_metrics[category]:
+                self.logger.record(f"{category}/{metric}", tensorboard_metrics[category][metric])
 
         return True
diff --git a/freqtrade/freqai/prediction_models/ReinforcementLearner.py b/freqtrade/freqai/prediction_models/ReinforcementLearner.py
index 2a87151f9..e795703d4 100644
--- a/freqtrade/freqai/prediction_models/ReinforcementLearner.py
+++ b/freqtrade/freqai/prediction_models/ReinforcementLearner.py
@@ -100,7 +100,7 @@ class ReinforcementLearner(BaseReinforcementLearningModel):
             """
             # first, penalize if the action is not valid
             if not self._is_valid(action):
-                self.tensorboard_log("is_valid")
+                self.tensorboard_log("invalid", category="actions")
                 return -2
 
             pnl = self.get_unrealized_profit()

From cb086f79ff263e075dc8cb7fcd841059b7153082 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 15:46:34 +0100
Subject: [PATCH 026/147] Improve doc wording and command parameters

---
 docs/utils.md                   | 47 ++++++++++++++++++++++++++++-----
 freqtrade/commands/arguments.py |  2 +-
 requirements.txt                |  2 +-
 3 files changed, 43 insertions(+), 8 deletions(-)

diff --git a/docs/utils.md b/docs/utils.md
index 3d6eda3ce..eb675442f 100644
--- a/docs/utils.md
+++ b/docs/utils.md
@@ -947,6 +947,7 @@ Common arguments:
   --userdir PATH, --user-data-dir PATH
                         Path to userdata directory.
 ```
+
 ### Examples
 
 Print trades with id 2 and 3 as json
@@ -956,11 +957,45 @@ freqtrade show-trades --db-url sqlite:///tradesv3.sqlite --trade-ids 2 3 --print
 ```
 
 ### Strategy-Updater
-Updates a list strategies or all strategies within the strategies folder to be v3 compliant including futures.
-If the command runs without --strategy-list then all files inside the strategies folder will be converted.
-```
-usage: freqtrade strategy_updater 
 
-optional arguments:
-  --strategy-list       defines a list of strategies that should be converted
+Updates listed strategies or all strategies within the strategies folder to be v3 compliant.
+If the command runs without --strategy-list then all strategies inside the strategies folder will be converted.
+Your original strategy will remain available in the `user_data/strategies_orig_updater/` directory.
+
+!!! Warning "Conversion results"
+    Strategy updater will work on a "best effort" approach. Please do your due diligence and verify the results of the conversion.
+    We also recommend to run a python formatter (e.g. `black`) to format results in a sane manner.
+
+```
+usage: freqtrade strategy-updater [-h] [-v] [--logfile FILE] [-V] [-c PATH]
+                                  [-d PATH] [--userdir PATH]
+                                  [--strategy-list STRATEGY_LIST [STRATEGY_LIST ...]]
+
+options:
+  -h, --help            show this help message and exit
+  --strategy-list STRATEGY_LIST [STRATEGY_LIST ...]
+                        Provide a space-separated list of strategies to
+                        backtest. Please note that timeframe needs to be set
+                        either in config or via command line. When using this
+                        together with `--export trades`, the strategy-name is
+                        injected into the filename (so `backtest-data.json`
+                        becomes `backtest-data-SampleStrategy.json`
+
+Common arguments:
+  -v, --verbose         Verbose mode (-vv for more, -vvv to get all messages).
+  --logfile FILE, --log-file FILE
+                        Log to the file specified. Special values are:
+                        'syslog', 'journald'. See the documentation for more
+                        details.
+  -V, --version         show program's version number and exit
+  -c PATH, --config PATH
+                        Specify configuration file (default:
+                        `userdir/config.json` or `config.json` whichever
+                        exists). Multiple --config options may be used. Can be
+                        set to `-` to read config from stdin.
+  -d PATH, --datadir PATH, --data-dir PATH
+                        Path to directory with historical backtesting data.
+  --userdir PATH, --user-data-dir PATH
+                        Path to userdata directory.
+
 ```
diff --git a/freqtrade/commands/arguments.py b/freqtrade/commands/arguments.py
index a3cdc378a..9b714a864 100644
--- a/freqtrade/commands/arguments.py
+++ b/freqtrade/commands/arguments.py
@@ -116,7 +116,7 @@ NO_CONF_REQURIED = ["convert-data", "convert-trade-data", "download-data", "list
 
 NO_CONF_ALLOWED = ["create-userdir", "list-exchanges", "new-strategy"]
 
-ARGS_STRATEGY_UTILS = ARGS_COMMON_OPTIMIZE + ["strategy_list"]
+ARGS_STRATEGY_UTILS = ["strategy_list"]
 
 
 class Arguments:
diff --git a/requirements.txt b/requirements.txt
index 7607a3664..a0ff8e03a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -56,4 +56,4 @@ schedule==1.1.0
 websockets==10.4
 janus==1.0.0
 
-ast-comments>=1.0.0
+ast-comments==1.0.0

From d2a412d2c65ee34576ac06638748700bb3ee4e03 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 15:47:03 +0100
Subject: [PATCH 027/147] Simplify start_strategy_update

---
 freqtrade/commands/strategy_utils_commands.py | 30 ++++++++-----------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/freqtrade/commands/strategy_utils_commands.py b/freqtrade/commands/strategy_utils_commands.py
index ed4d0bf1a..e579ec475 100644
--- a/freqtrade/commands/strategy_utils_commands.py
+++ b/freqtrade/commands/strategy_utils_commands.py
@@ -29,31 +29,27 @@ def start_strategy_update(args: Dict[str, Any]) -> None:
         config, enum_failed=False, recursive=config.get('recursive_strategy_search', False))
 
     filtered_strategy_objs = []
-    if 'strategy_list' in args:
-        for args_strategy in args['strategy_list']:
-            for strategy_obj in strategy_objs:
-                if (strategy_obj['name'] == args_strategy
-                        and strategy_obj not in filtered_strategy_objs):
-                    filtered_strategy_objs.append(strategy_obj)
-                    break
+    if args['strategy_list']:
+        filtered_strategy_objs = [
+            strategy_obj for strategy_obj in strategy_objs
+            if strategy_obj['name'] in args['strategy_list']
+        ]
 
-        for filtered_strategy_obj in filtered_strategy_objs:
-            start_conversion(filtered_strategy_obj, config)
     else:
-        processed_locations = set()
-        for strategy_obj in strategy_objs:
-            if strategy_obj['location'] not in processed_locations:
-                processed_locations.add(strategy_obj['location'])
-                start_conversion(strategy_obj, config)
+        # Use all available entries.
+        filtered_strategy_objs = strategy_objs
+
+    processed_locations = set()
+    for strategy_obj in filtered_strategy_objs:
+        if strategy_obj['location'] not in processed_locations:
+            processed_locations.add(strategy_obj['location'])
+            start_conversion(strategy_obj, config)
 
 
 def start_conversion(strategy_obj, config):
-    # try:
     print(f"Conversion of {Path(strategy_obj['location']).name} started.")
     instance_strategy_updater = StrategyUpdater()
     start = time.perf_counter()
     instance_strategy_updater.start(config, strategy_obj)
     elapsed = time.perf_counter() - start
     print(f"Conversion of {Path(strategy_obj['location']).name} took {elapsed:.1f} seconds.")
-    # except:
-    #    pass

From 0911cd72a2fb2ed5fd87c6d3f7ad3eb2706edb6d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 15:59:02 +0100
Subject: [PATCH 028/147] Add test for strategy-updater start method

---
 freqtrade/commands/arguments.py |  2 +-
 tests/commands/test_commands.py | 37 ++++++++++++++++++++++++++++++++-
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/freqtrade/commands/arguments.py b/freqtrade/commands/arguments.py
index 9b714a864..47aa37fdf 100644
--- a/freqtrade/commands/arguments.py
+++ b/freqtrade/commands/arguments.py
@@ -116,7 +116,7 @@ NO_CONF_REQURIED = ["convert-data", "convert-trade-data", "download-data", "list
 
 NO_CONF_ALLOWED = ["create-userdir", "list-exchanges", "new-strategy"]
 
-ARGS_STRATEGY_UTILS = ["strategy_list"]
+ARGS_STRATEGY_UTILS = ["strategy_list", "strategy_path", "recursive_strategy_search"]
 
 
 class Arguments:
diff --git a/tests/commands/test_commands.py b/tests/commands/test_commands.py
index 0ba1924a7..179712c6d 100644
--- a/tests/commands/test_commands.py
+++ b/tests/commands/test_commands.py
@@ -14,7 +14,8 @@ from freqtrade.commands import (start_backtesting_show, start_convert_data, star
                                 start_hyperopt_show, start_install_ui, start_list_data,
                                 start_list_exchanges, start_list_markets, start_list_strategies,
                                 start_list_timeframes, start_new_strategy, start_show_trades,
-                                start_test_pairlist, start_trading, start_webserver)
+                                start_strategy_update, start_test_pairlist, start_trading,
+                                start_webserver)
 from freqtrade.commands.db_commands import start_convert_db
 from freqtrade.commands.deploy_commands import (clean_ui_subdir, download_and_install_ui,
                                                 get_ui_download_url, read_ui_version)
@@ -1546,3 +1547,37 @@ def test_start_convert_db(mocker, fee, tmpdir, caplog):
     start_convert_db(pargs)
 
     assert db_target_file.is_file()
+
+
+def test_start_strategy_updater(mocker,  tmpdir):
+    sc_mock = mocker.patch('freqtrade.commands.strategy_utils_commands.start_conversion')
+    teststrats = Path(__file__).parent.parent / 'strategy/strats'
+    args = [
+        "strategy-updater",
+        "--userdir",
+        str(tmpdir),
+        "--strategy-path",
+        str(teststrats),
+    ]
+    pargs = get_args(args)
+    pargs['config'] = None
+    start_strategy_update(pargs)
+    # Number of strategies in the test directory
+    assert sc_mock.call_count == 11
+
+    sc_mock.reset_mock()
+    args = [
+        "strategy-updater",
+        "--userdir",
+        str(tmpdir),
+        "--strategy-path",
+        str(teststrats),
+        "--strategy-list",
+        "StrategyTestV3",
+        "StrategyTestV2"
+    ]
+    pargs = get_args(args)
+    pargs['config'] = None
+    start_strategy_update(pargs)
+    # Number of strategies in the test directory
+    assert sc_mock.call_count == 2

From b5c4f9ebe293097c08554e06c785a3e40ed993b1 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 16:26:12 +0100
Subject: [PATCH 029/147] Split updater_tests to be clearer

---
 tests/test_strategy_updater.py | 139 ++++++++++++++++++++-------------
 1 file changed, 86 insertions(+), 53 deletions(-)

diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 26d173871..7205a609d 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -7,9 +7,11 @@ import pytest
 from freqtrade.strategy.strategyupdater import StrategyUpdater
 
 
-def test_strategy_updater(default_conf, caplog) -> None:
-    if sys.version_info < (3, 9):
-        pytest.skip("StrategyUpdater is not compatible with Python 3.8", allow_module_level=True)
+if sys.version_info < (3, 9):
+    pytest.skip("StrategyUpdater is not compatible with Python 3.8", allow_module_level=True)
+
+
+def test_strategy_updater_methods(default_conf, caplog) -> None:
 
     instance_strategy_updater = StrategyUpdater()
     modified_code1 = instance_strategy_updater.update_code("""
@@ -25,11 +27,32 @@ class testClass(IStrategy):
     def custom_sell():
         pass
 """)
+
+    assert "populate_entry_trend" in modified_code1
+    assert "populate_exit_trend" in modified_code1
+    assert "check_entry_timeout" in modified_code1
+    assert "check_exit_timeout" in modified_code1
+    assert "custom_exit" in modified_code1
+    assert "INTERFACE_VERSION = 3" in modified_code1
+
+
+def test_strategy_updater_params(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+
     modified_code2 = instance_strategy_updater.update_code("""
 ticker_interval = '15m'
 buy_some_parameter = IntParameter(space='buy')
 sell_some_parameter = IntParameter(space='sell')
 """)
+
+    assert "timeframe" in modified_code2
+    # check for not editing hyperopt spaces
+    assert "space='buy'" in modified_code2
+    assert "space='sell'" in modified_code2
+
+
+def test_strategy_updater_constants(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
     modified_code3 = instance_strategy_updater.update_code("""
 use_sell_signal = True
 sell_profit_only = True
@@ -37,15 +60,38 @@ sell_profit_offset = True
 ignore_roi_if_buy_signal = True
 forcebuy_enable = True
 """)
-    modified_code4 = instance_strategy_updater.update_code("""
+
+    assert "use_exit_signal" in modified_code3
+    assert "exit_profit_only" in modified_code3
+    assert "exit_profit_offset" in modified_code3
+    assert "ignore_roi_if_entry_signal" in modified_code3
+    assert "force_entry_enable" in modified_code3
+
+
+def test_strategy_updater_df_columns(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+    modified_code = instance_strategy_updater.update_code("""
 dataframe.loc[reduce(lambda x, y: x & y, conditions), ["buy", "buy_tag"]] = (1, "buy_signal_1")
 dataframe.loc[reduce(lambda x, y: x & y, conditions), 'sell'] = 1
 """)
-    modified_code5 = instance_strategy_updater.update_code("""
+
+    assert "enter_long" in modified_code
+    assert "exit_long" in modified_code
+    assert "enter_tag" in modified_code
+
+
+def test_strategy_updater_method_params(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+    modified_code = instance_strategy_updater.update_code("""
 def confirm_trade_exit(sell_reason: str):
     pass
     """)
-    modified_code6 = instance_strategy_updater.update_code("""
+    assert "exit_reason" in modified_code
+
+
+def test_strategy_updater_dicts(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+    modified_code = instance_strategy_updater.update_code("""
 order_time_in_force = {
     'buy': 'gtc',
     'sell': 'ioc'
@@ -62,17 +108,44 @@ unfilledtimeout = {
 }
 """)
 
-    modified_code7 = instance_strategy_updater.update_code("""
+    assert "'entry': 'gtc'" in modified_code
+    assert "'exit': 'ioc'" in modified_code
+    assert "'entry': 'limit'" in modified_code
+    assert "'exit': 'market'" in modified_code
+    assert "'entry': 1" in modified_code
+    assert "'exit': 2" in modified_code
+
+
+def test_strategy_updater_comparisons(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+    modified_code = instance_strategy_updater.update_code("""
 def confirm_trade_exit(sell_reason):
     if (sell_reason == 'stop_loss'):
         pass
 """)
-    modified_code8 = instance_strategy_updater.update_code("""
+    assert "exit_reason" in modified_code
+    assert "exit_reason == 'stop_loss'" in modified_code
+
+
+def test_strategy_updater_strings(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+
+    modified_code = instance_strategy_updater.update_code("""
 sell_reason == 'sell_signal'
 sell_reason == 'force_sell'
 sell_reason == 'emergency_sell'
 """)
-    modified_code9 = instance_strategy_updater.update_code("""
+
+    # those tests currently don't work, next in line.
+    assert "exit_signal" in modified_code
+    assert "exit_reason" in modified_code
+    assert "force_exit" in modified_code
+    assert "emergency_exit" in modified_code
+
+
+def test_strategy_updater_comments(default_conf, caplog) -> None:
+    instance_strategy_updater = StrategyUpdater()
+    modified_code = instance_strategy_updater.update_code("""
 # This is the 1st comment
 import talib.abstract as ta
 # This is the 2nd comment
@@ -89,49 +162,9 @@ class someStrategy(IStrategy):
     # This is the 4th comment
     stoploss = -0.1
 """)
+
+    assert "This is the 1st comment" in modified_code
+    assert "This is the 2nd comment" in modified_code
+    assert "This is the 3rd comment" in modified_code
     # currently still missing:
     # Webhook terminology, Telegram notification settings, Strategy/Config settings
-
-    assert "populate_entry_trend" in modified_code1
-    assert "populate_exit_trend" in modified_code1
-    assert "check_entry_timeout" in modified_code1
-    assert "check_exit_timeout" in modified_code1
-    assert "custom_exit" in modified_code1
-    assert "INTERFACE_VERSION = 3" in modified_code1
-
-    assert "timeframe" in modified_code2
-    # check for not editing hyperopt spaces
-    assert "space='buy'" in modified_code2
-    assert "space='sell'" in modified_code2
-
-    assert "use_exit_signal" in modified_code3
-    assert "exit_profit_only" in modified_code3
-    assert "exit_profit_offset" in modified_code3
-    assert "ignore_roi_if_entry_signal" in modified_code3
-    assert "force_entry_enable" in modified_code3
-
-    assert "enter_long" in modified_code4
-    assert "exit_long" in modified_code4
-    assert "enter_tag" in modified_code4
-
-    assert "exit_reason" in modified_code5
-
-    assert "'entry': 'gtc'" in modified_code6
-    assert "'exit': 'ioc'" in modified_code6
-    assert "'entry': 'limit'" in modified_code6
-    assert "'exit': 'market'" in modified_code6
-    assert "'entry': 1" in modified_code6
-    assert "'exit': 2" in modified_code6
-
-    assert "exit_reason" in modified_code7
-    assert "exit_reason == 'stop_loss'" in modified_code7
-
-    # those tests currently don't work, next in line.
-    assert "exit_signal" in modified_code8
-    assert "exit_reason" in modified_code8
-    assert "force_exit" in modified_code8
-    assert "emergency_exit" in modified_code8
-
-    assert "This is the 1st comment" in modified_code9
-    assert "This is the 2nd comment" in modified_code9
-    assert "This is the 3rd comment" in modified_code9

From f5848ea891723fcdf33e8794f2018c0547f8252d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 16:29:18 +0100
Subject: [PATCH 030/147] Add test for successful_buys

---
 tests/test_strategy_updater.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 7205a609d..4aad152bf 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -84,9 +84,11 @@ def test_strategy_updater_method_params(default_conf, caplog) -> None:
     instance_strategy_updater = StrategyUpdater()
     modified_code = instance_strategy_updater.update_code("""
 def confirm_trade_exit(sell_reason: str):
+    nr_orders = trades.nr_of_successful_buys
     pass
     """)
     assert "exit_reason" in modified_code
+    assert "nr_orders = trades.nr_of_successful_entries" in modified_code
 
 
 def test_strategy_updater_dicts(default_conf, caplog) -> None:

From f584edf809c5413f7136ef7c7e1cda5888f5363d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 16:45:56 +0100
Subject: [PATCH 031/147] Improve tests by simply running a full strategy
 through everything

---
 freqtrade/strategy/strategyupdater.py |  4 ++-
 tests/commands/test_commands.py       |  2 +-
 tests/test_strategy_updater.py        | 42 +++++++++++++++++++++++++++
 3 files changed, 46 insertions(+), 2 deletions(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index 6fe1f326c..bc692b71c 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -3,6 +3,8 @@ from pathlib import Path
 
 import ast_comments
 
+from freqtrade.constants import Config
+
 
 class StrategyUpdater:
     name_mapping = {
@@ -42,7 +44,7 @@ class StrategyUpdater:
     # create a dictionary that maps the old column names to the new ones
     rename_dict = {'buy': 'enter_long', 'sell': 'exit_long', 'buy_tag': 'enter_tag'}
 
-    def start(self, config, strategy_obj: dict) -> None:
+    def start(self, config: Config, strategy_obj: dict) -> None:
         """
         Run strategy updater
         It updates a strategy to v3 with the help of the ast-module
diff --git a/tests/commands/test_commands.py b/tests/commands/test_commands.py
index 179712c6d..318590b32 100644
--- a/tests/commands/test_commands.py
+++ b/tests/commands/test_commands.py
@@ -1549,7 +1549,7 @@ def test_start_convert_db(mocker, fee, tmpdir, caplog):
     assert db_target_file.is_file()
 
 
-def test_start_strategy_updater(mocker,  tmpdir):
+def test_start_strategy_updater(mocker, tmpdir):
     sc_mock = mocker.patch('freqtrade.commands.strategy_utils_commands.start_conversion')
     teststrats = Path(__file__).parent.parent / 'strategy/strats'
     args = [
diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index 4aad152bf..d3bdd27b5 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -1,16 +1,56 @@
 # pragma pylint: disable=missing-docstring, protected-access, invalid-name
 
+import re
+import shutil
 import sys
+from pathlib import Path
 
 import pytest
 
+from freqtrade.commands.strategy_utils_commands import start_strategy_update
 from freqtrade.strategy.strategyupdater import StrategyUpdater
+from tests.conftest import get_args
 
 
 if sys.version_info < (3, 9):
     pytest.skip("StrategyUpdater is not compatible with Python 3.8", allow_module_level=True)
 
 
+def test_strategy_updater_start(tmpdir, capsys) -> None:
+    # Effective test without mocks.
+    teststrats = Path(__file__).parent / 'strategy/strats'
+    tmpdirp = Path(tmpdir) / "strategies"
+    tmpdirp.mkdir()
+    shutil.copy(teststrats / 'strategy_test_v2.py', tmpdirp)
+    old_code = (teststrats / 'strategy_test_v2.py').read_text()
+
+    args = [
+        "strategy-updater",
+        "--userdir",
+        str(tmpdir),
+        "--strategy-list",
+        "StrategyTestV2"
+         ]
+    pargs = get_args(args)
+    pargs['config'] = None
+
+    start_strategy_update(pargs)
+
+    assert Path(tmpdir / "strategies_orig_updater").exists()
+    # Backup file exists
+    assert Path(tmpdir / "strategies_orig_updater" / 'strategy_test_v2.py').exists()
+    # updated file exists
+    new_file = Path(tmpdirp / 'strategy_test_v2.py')
+    assert new_file.exists()
+    new_code = new_file.read_text()
+    assert 'INTERFACE_VERSION = 3' in new_code
+    assert 'INTERFACE_VERSION = 2' in old_code
+    captured = capsys.readouterr()
+
+    assert 'Conversion of strategy_test_v2.py started.' in captured.out
+    assert re.search(r'Conversion of strategy_test_v2\.py took .* seconds', captured.out)
+
+
 def test_strategy_updater_methods(default_conf, caplog) -> None:
 
     instance_strategy_updater = StrategyUpdater()
@@ -155,6 +195,7 @@ import freqtrade.vendor.qtpylib.indicators as qtpylib
 
 
 class someStrategy(IStrategy):
+    INTERFACE_VERSION = 2
     # This is the 3rd comment
     # This attribute will be overridden if the config file contains "minimal_roi"
     minimal_roi = {
@@ -168,5 +209,6 @@ class someStrategy(IStrategy):
     assert "This is the 1st comment" in modified_code
     assert "This is the 2nd comment" in modified_code
     assert "This is the 3rd comment" in modified_code
+    assert "INTERFACE_VERSION = 3" in modified_code
     # currently still missing:
     # Webhook terminology, Telegram notification settings, Strategy/Config settings

From a10f78e3ef3d2ee3c1605ec8c22dee46d64525cf Mon Sep 17 00:00:00 2001
From: initrv <ctumko@gmail.com>
Date: Sun, 12 Mar 2023 23:29:27 +0300
Subject: [PATCH 032/147] fix increment in case of 0

---
 freqtrade/freqai/RL/BaseEnvironment.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/freqai/RL/BaseEnvironment.py b/freqtrade/freqai/RL/BaseEnvironment.py
index df2a89d81..a9a9a613c 100644
--- a/freqtrade/freqai/RL/BaseEnvironment.py
+++ b/freqtrade/freqai/RL/BaseEnvironment.py
@@ -157,7 +157,7 @@ class BaseEnvironment(gym.Env):
         :param value: `metric` value
         :param category: `metric` category
         """
-        increment = True if not value else False
+        increment = True if value is None else False
         value = 1 if increment else value
 
         if category not in self.tensorboard_metrics:

From f3a1177badd09e84c81e0f220b77c36082a656d8 Mon Sep 17 00:00:00 2001
From: initrv <ctumko@gmail.com>
Date: Mon, 13 Mar 2023 17:53:35 +0300
Subject: [PATCH 033/147] bring inc back

---
 freqtrade/freqai/RL/BaseEnvironment.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/freqtrade/freqai/RL/BaseEnvironment.py b/freqtrade/freqai/RL/BaseEnvironment.py
index a9a9a613c..7ac77361c 100644
--- a/freqtrade/freqai/RL/BaseEnvironment.py
+++ b/freqtrade/freqai/RL/BaseEnvironment.py
@@ -138,7 +138,7 @@ class BaseEnvironment(gym.Env):
         return [seed]
 
     def tensorboard_log(self, metric: str, value: Optional[Union[int, float]] = None,
-                        category: str = "custom"):
+                        inc: Optional[bool] = None, category: str = "custom"):
         """
         Function builds the tensorboard_metrics dictionary
         to be parsed by the TensorboardCallback. This
@@ -155,6 +155,7 @@ class BaseEnvironment(gym.Env):
 
         :param metric: metric to be tracked and incremented
         :param value: `metric` value
+        :param inc: (deprecated) sets whether the `value` is incremented or not
         :param category: `metric` category
         """
         increment = True if value is None else False

From 47ab285252996cf7eabd109eba09973272917b26 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 20:49:35 +0100
Subject: [PATCH 034/147] Minor test fix

---
 tests/rpc/test_rpc_telegram.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tests/rpc/test_rpc_telegram.py b/tests/rpc/test_rpc_telegram.py
index 1dc255b3e..59b6df489 100644
--- a/tests/rpc/test_rpc_telegram.py
+++ b/tests/rpc/test_rpc_telegram.py
@@ -302,8 +302,7 @@ def test_telegram_status_closed_trade(default_conf, update, mocker, fee) -> None
     telegram, _, msg_mock = get_telegram_testobject(mocker, default_conf)
 
     create_mock_trades(fee)
-    trades = Trade.get_trades([Trade.is_open.is_(False)])
-    trade = trades[0]
+    trade = Trade.get_trades([Trade.is_open.is_(False)]).first()
     context = MagicMock()
     context.args = [str(trade.id)]
     telegram._status(update=update, context=context)

From b469addffb09945f50d36eed0a9273b242d9626c Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 21:00:30 +0100
Subject: [PATCH 035/147] remove usage of .query from regular models

---
 freqtrade/persistence/trade_model.py  | 142 +++++++++++++++-----------
 freqtrade/rpc/rpc.py                  |  39 ++++---
 tests/persistence/test_persistence.py |   8 +-
 3 files changed, 114 insertions(+), 75 deletions(-)

diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 19d71aa7b..a2bbd1ee1 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -7,7 +7,8 @@ from datetime import datetime, timedelta, timezone
 from math import isclose
 from typing import Any, ClassVar, Dict, List, Optional, cast
 
-from sqlalchemy import Enum, Float, ForeignKey, Integer, String, UniqueConstraint, desc, func
+from sqlalchemy import (Enum, Float, ForeignKey, Integer, Result, Select, String, UniqueConstraint,
+                        desc, func, select)
 from sqlalchemy.orm import (Mapped, Query, QueryPropertyDescriptor, lazyload, mapped_column,
                             relationship)
 
@@ -1153,7 +1154,9 @@ class LocalTrade():
         get open trade count
         """
         if Trade.use_db:
-            return Trade.query.filter(Trade.is_open.is_(True)).count()
+            return Trade._session.scalar(
+                select(func.count(Trade.id)).filter(Trade.is_open.is_(True))
+            )
         else:
             return LocalTrade.bt_open_open_trade_count
 
@@ -1287,18 +1290,18 @@ class Trade(ModelBase, LocalTrade):
     def delete(self) -> None:
 
         for order in self.orders:
-            Order.query.session.delete(order)
+            Order._session.delete(order)
 
-        Trade.query.session.delete(self)
+        Trade._session.delete(self)
         Trade.commit()
 
     @staticmethod
     def commit():
-        Trade.query.session.commit()
+        Trade._session.commit()
 
     @staticmethod
     def rollback():
-        Trade.query.session.rollback()
+        Trade._session.rollback()
 
     @staticmethod
     def get_trades_proxy(*, pair: Optional[str] = None, is_open: Optional[bool] = None,
@@ -1332,7 +1335,7 @@ class Trade(ModelBase, LocalTrade):
             )
 
     @staticmethod
-    def get_trades(trade_filter=None, include_orders: bool = True) -> Query['Trade']:
+    def get_trades_query(trade_filter=None, include_orders: bool = True) -> Select['Trade']:
         """
         Helper function to query Trades using filters.
         NOTE: Not supported in Backtesting.
@@ -1347,15 +1350,28 @@ class Trade(ModelBase, LocalTrade):
         if trade_filter is not None:
             if not isinstance(trade_filter, list):
                 trade_filter = [trade_filter]
-            this_query = Trade.query.filter(*trade_filter)
+            this_query = select(Trade).filter(*trade_filter)
         else:
-            this_query = Trade.query
+            this_query = select(Trade)
         if not include_orders:
             # Don't load order relations
             # Consider using noload or raiseload instead of lazyload
             this_query = this_query.options(lazyload(Trade.orders))
         return this_query
 
+    @staticmethod
+    def get_trades(trade_filter=None, include_orders: bool = True) -> Query['Trade']:
+        """
+        Helper function to query Trades using filters.
+        NOTE: Not supported in Backtesting.
+        :param trade_filter: Optional filter to apply to trades
+                             Can be either a Filter object, or a List of filters
+                             e.g. `(trade_filter=[Trade.id == trade_id, Trade.is_open.is_(True),])`
+                             e.g. `(trade_filter=Trade.id == trade_id)`
+        :return: unsorted query object
+        """
+        return Trade._session.execute(Trade.get_trades_query(trade_filter, include_orders))
+
     @staticmethod
     def get_open_order_trades() -> List['Trade']:
         """
@@ -1392,8 +1408,9 @@ class Trade(ModelBase, LocalTrade):
         Retrieves total realized profit
         """
         if Trade.use_db:
-            total_profit = Trade.query.with_entities(
-                func.sum(Trade.close_profit_abs)).filter(Trade.is_open.is_(False)).scalar()
+            total_profit = Trade._session.scalar(
+                select(func.sum(Trade.close_profit_abs)).filter(Trade.is_open.is_(False))
+            )
         else:
             total_profit = sum(
                 t.close_profit_abs for t in LocalTrade.get_trades_proxy(is_open=False))
@@ -1406,8 +1423,9 @@ class Trade(ModelBase, LocalTrade):
         in stake currency
         """
         if Trade.use_db:
-            total_open_stake_amount = Trade.query.with_entities(
-                func.sum(Trade.stake_amount)).filter(Trade.is_open.is_(True)).scalar()
+            total_open_stake_amount = Trade._session.scalar(
+                select(func.sum(Trade.stake_amount)).filter(Trade.is_open.is_(True))
+            )
         else:
             total_open_stake_amount = sum(
                 t.stake_amount for t in LocalTrade.get_trades_proxy(is_open=True))
@@ -1423,15 +1441,18 @@ class Trade(ModelBase, LocalTrade):
         if minutes:
             start_date = datetime.now(timezone.utc) - timedelta(minutes=minutes)
             filters.append(Trade.close_date >= start_date)
-        pair_rates = Trade.query.with_entities(
-            Trade.pair,
-            func.sum(Trade.close_profit).label('profit_sum'),
-            func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
-            func.count(Trade.pair).label('count')
-        ).filter(*filters)\
-            .group_by(Trade.pair) \
-            .order_by(desc('profit_sum_abs')) \
-            .all()
+
+        pair_rates = Trade._session.execute(
+            select(
+                Trade.pair,
+                func.sum(Trade.close_profit).label('profit_sum'),
+                func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
+                func.count(Trade.pair).label('count')
+            ).filter(*filters)
+            .group_by(Trade.pair)
+            .order_by(desc('profit_sum_abs'))
+            ).all()
+
         return [
             {
                 'pair': pair,
@@ -1456,15 +1477,16 @@ class Trade(ModelBase, LocalTrade):
         if (pair is not None):
             filters.append(Trade.pair == pair)
 
-        enter_tag_perf = Trade.query.with_entities(
-            Trade.enter_tag,
-            func.sum(Trade.close_profit).label('profit_sum'),
-            func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
-            func.count(Trade.pair).label('count')
-        ).filter(*filters)\
-            .group_by(Trade.enter_tag) \
-            .order_by(desc('profit_sum_abs')) \
-            .all()
+        enter_tag_perf = Trade._session.execute(
+            select(
+                Trade.enter_tag,
+                func.sum(Trade.close_profit).label('profit_sum'),
+                func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
+                func.count(Trade.pair).label('count')
+            ).filter(*filters)
+            .group_by(Trade.enter_tag)
+            .order_by(desc('profit_sum_abs'))
+        ).all()
 
         return [
             {
@@ -1488,16 +1510,16 @@ class Trade(ModelBase, LocalTrade):
         filters: List = [Trade.is_open.is_(False)]
         if (pair is not None):
             filters.append(Trade.pair == pair)
-
-        sell_tag_perf = Trade.query.with_entities(
-            Trade.exit_reason,
-            func.sum(Trade.close_profit).label('profit_sum'),
-            func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
-            func.count(Trade.pair).label('count')
-        ).filter(*filters)\
-            .group_by(Trade.exit_reason) \
-            .order_by(desc('profit_sum_abs')) \
-            .all()
+        sell_tag_perf = Trade._session.execute(
+            select(
+                Trade.exit_reason,
+                func.sum(Trade.close_profit).label('profit_sum'),
+                func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
+                func.count(Trade.pair).label('count')
+            ).filter(*filters)
+            .group_by(Trade.exit_reason)
+            .order_by(desc('profit_sum_abs'))
+        ).all()
 
         return [
             {
@@ -1521,18 +1543,18 @@ class Trade(ModelBase, LocalTrade):
         filters: List = [Trade.is_open.is_(False)]
         if (pair is not None):
             filters.append(Trade.pair == pair)
-
-        mix_tag_perf = Trade.query.with_entities(
-            Trade.id,
-            Trade.enter_tag,
-            Trade.exit_reason,
-            func.sum(Trade.close_profit).label('profit_sum'),
-            func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
-            func.count(Trade.pair).label('count')
-        ).filter(*filters)\
-            .group_by(Trade.id) \
-            .order_by(desc('profit_sum_abs')) \
-            .all()
+        mix_tag_perf = Trade._session.execute(
+            select(
+                Trade.id,
+                Trade.enter_tag,
+                Trade.exit_reason,
+                func.sum(Trade.close_profit).label('profit_sum'),
+                func.sum(Trade.close_profit_abs).label('profit_sum_abs'),
+                func.count(Trade.pair).label('count')
+            ).filter(*filters)
+            .group_by(Trade.id)
+            .order_by(desc('profit_sum_abs'))
+        ).all()
 
         return_list: List[Dict] = []
         for id, enter_tag, exit_reason, profit, profit_abs, count in mix_tag_perf:
@@ -1568,11 +1590,15 @@ class Trade(ModelBase, LocalTrade):
         NOTE: Not supported in Backtesting.
         :returns: Tuple containing (pair, profit_sum)
         """
-        best_pair = Trade.query.with_entities(
-            Trade.pair, func.sum(Trade.close_profit).label('profit_sum')
-        ).filter(Trade.is_open.is_(False) & (Trade.close_date >= start_date)) \
-            .group_by(Trade.pair) \
-            .order_by(desc('profit_sum')).first()
+        best_pair = Trade._session.execute(
+            select(
+                Trade.pair,
+                func.sum(Trade.close_profit).label('profit_sum')
+            ).filter(Trade.is_open.is_(False) & (Trade.close_date >= start_date))
+            .group_by(Trade.pair)
+            .order_by(desc('profit_sum'))
+        ).first()
+
         return best_pair
 
     @staticmethod
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index 727fc5a37..db2b35049 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -5,7 +5,7 @@ import logging
 from abc import abstractmethod
 from datetime import date, datetime, timedelta, timezone
 from math import isnan
-from typing import Any, Dict, Generator, List, Optional, Tuple, Union
+from typing import Any, Dict, Generator, List, Optional, Sequence, Tuple, Union
 
 import arrow
 import psutil
@@ -13,6 +13,7 @@ from dateutil.relativedelta import relativedelta
 from dateutil.tz import tzlocal
 from numpy import NAN, inf, int64, mean
 from pandas import DataFrame, NaT
+from sqlalchemy import func, select
 
 from freqtrade import __version__
 from freqtrade.configuration.timerange import TimeRange
@@ -339,11 +340,18 @@ class RPC:
         for day in range(0, timescale):
             profitday = start_date - time_offset(day)
             # Only query for necessary columns for performance reasons.
-            trades = Trade.query.session.query(Trade.close_profit_abs).filter(
-                Trade.is_open.is_(False),
-                Trade.close_date >= profitday,
-                Trade.close_date < (profitday + time_offset(1))
-            ).order_by(Trade.close_date).all()
+            trades = Trade._session.execute(
+                select(Trade.close_profit_abs)
+                .filter(Trade.is_open.is_(False),
+                        Trade.close_date >= profitday,
+                        Trade.close_date < (profitday + time_offset(1)))
+                .order_by(Trade.close_date)
+            ).all()
+            # trades = Trade.query.session.query(Trade.close_profit_abs).filter(
+            #     Trade.is_open.is_(False),
+            #     Trade.close_date >= profitday,
+            #     Trade.close_date < (profitday + time_offset(1))
+            # ).order_by(Trade.close_date).all()
 
             curdayprofit = sum(
                 trade.close_profit_abs for trade in trades if trade.close_profit_abs is not None)
@@ -381,14 +389,19 @@ class RPC:
         """ Returns the X last trades """
         order_by: Any = Trade.id if order_by_id else Trade.close_date.desc()
         if limit:
-            trades = Trade.get_trades([Trade.is_open.is_(False)]).order_by(
-                order_by).limit(limit).offset(offset)
+            trades = Trade._session.execute(
+                Trade.get_trades_query([Trade.is_open.is_(False)])
+                .order_by(order_by)
+                .limit(limit)
+                .offset(offset))
         else:
-            trades = Trade.get_trades([Trade.is_open.is_(False)]).order_by(
-                Trade.close_date.desc())
+            trades = Trade._session.execute(
+                Trade.get_trades_query([Trade.is_open.is_(False)])
+                .order_by(Trade.close_date.desc()))
 
         output = [trade.to_json() for trade in trades]
-        total_trades = Trade.get_trades([Trade.is_open.is_(False)]).count()
+        total_trades = Trade._session.scalar(
+            select(func.count(Trade.id)).filter(Trade.is_open.is_(False)))
 
         return {
             "trades": output,
@@ -436,8 +449,8 @@ class RPC:
         """ Returns cumulative profit statistics """
         trade_filter = ((Trade.is_open.is_(False) & (Trade.close_date >= start_date)) |
                         Trade.is_open.is_(True))
-        trades: List[Trade] = Trade.get_trades(
-            trade_filter, include_orders=False).order_by(Trade.id).all()
+        trades: Sequence[Trade] = Trade._session.execute(Trade.get_trades_query(
+            trade_filter, include_orders=False).order_by(Trade.id)).all()
 
         profit_all_coin = []
         profit_all_ratio = []
diff --git a/tests/persistence/test_persistence.py b/tests/persistence/test_persistence.py
index 0598d4134..cd4890db9 100644
--- a/tests/persistence/test_persistence.py
+++ b/tests/persistence/test_persistence.py
@@ -1793,17 +1793,17 @@ def test_get_trades_proxy(fee, use_db, is_short):
 @pytest.mark.usefixtures("init_persistence")
 @pytest.mark.parametrize('is_short', [True, False])
 def test_get_trades__query(fee, is_short):
-    query = Trade.get_trades([])
+    query = Trade.get_trades_query([])
     # without orders there should be no join issued.
-    query1 = Trade.get_trades([], include_orders=False)
+    query1 = Trade.get_trades_query([], include_orders=False)
 
     # Empty "with-options -> default - selectin"
     assert query._with_options == ()
     assert query1._with_options != ()
 
     create_mock_trades(fee, is_short)
-    query = Trade.get_trades([])
-    query1 = Trade.get_trades([], include_orders=False)
+    query = Trade.get_trades_query([])
+    query1 = Trade.get_trades_query([], include_orders=False)
 
     assert query._with_options == ()
     assert query1._with_options != ()

From d45599ca3b5c64c9a488f8235d2f2284ed400728 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 21:09:25 +0100
Subject: [PATCH 036/147] Fix some type errors

---
 freqtrade/data/btanalysis.py         |  2 +-
 freqtrade/persistence/trade_model.py | 27 +++++++++++++--------------
 freqtrade/rpc/rpc.py                 |  4 ++--
 3 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/freqtrade/data/btanalysis.py b/freqtrade/data/btanalysis.py
index 9772506a7..3567f4112 100644
--- a/freqtrade/data/btanalysis.py
+++ b/freqtrade/data/btanalysis.py
@@ -373,7 +373,7 @@ def load_trades_from_db(db_url: str, strategy: Optional[str] = None) -> pd.DataF
     filters = []
     if strategy:
         filters.append(Trade.strategy == strategy)
-    trades = trade_list_to_dataframe(Trade.get_trades(filters).all())
+    trades = trade_list_to_dataframe(list(Trade.get_trades(filters).all()))
 
     return trades
 
diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index a2bbd1ee1..58f6c666a 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -7,10 +7,9 @@ from datetime import datetime, timedelta, timezone
 from math import isclose
 from typing import Any, ClassVar, Dict, List, Optional, cast
 
-from sqlalchemy import (Enum, Float, ForeignKey, Integer, Result, Select, String, UniqueConstraint,
-                        desc, func, select)
-from sqlalchemy.orm import (Mapped, Query, QueryPropertyDescriptor, lazyload, mapped_column,
-                            relationship)
+from sqlalchemy import (Enum, Float, ForeignKey, Integer, ScalarResult, Select, String,
+                        UniqueConstraint, desc, func, select)
+from sqlalchemy.orm import Mapped, QueryPropertyDescriptor, lazyload, mapped_column, relationship
 
 from freqtrade.constants import (DATETIME_PRINT_FORMAT, MATH_CLOSE_PREC, NON_OPEN_EXCHANGE_STATES,
                                  BuySell, LongShort)
@@ -1154,9 +1153,9 @@ class LocalTrade():
         get open trade count
         """
         if Trade.use_db:
-            return Trade._session.scalar(
+            return Trade._session.execute(
                 select(func.count(Trade.id)).filter(Trade.is_open.is_(True))
-            )
+            ).scalar_one()
         else:
             return LocalTrade.bt_open_open_trade_count
 
@@ -1335,7 +1334,7 @@ class Trade(ModelBase, LocalTrade):
             )
 
     @staticmethod
-    def get_trades_query(trade_filter=None, include_orders: bool = True) -> Select['Trade']:
+    def get_trades_query(trade_filter=None, include_orders: bool = True) -> Select:
         """
         Helper function to query Trades using filters.
         NOTE: Not supported in Backtesting.
@@ -1360,7 +1359,7 @@ class Trade(ModelBase, LocalTrade):
         return this_query
 
     @staticmethod
-    def get_trades(trade_filter=None, include_orders: bool = True) -> Query['Trade']:
+    def get_trades(trade_filter=None, include_orders: bool = True) -> ScalarResult['Trade']:
         """
         Helper function to query Trades using filters.
         NOTE: Not supported in Backtesting.
@@ -1370,7 +1369,7 @@ class Trade(ModelBase, LocalTrade):
                              e.g. `(trade_filter=Trade.id == trade_id)`
         :return: unsorted query object
         """
-        return Trade._session.execute(Trade.get_trades_query(trade_filter, include_orders))
+        return Trade._session.scalars(Trade.get_trades_query(trade_filter, include_orders))
 
     @staticmethod
     def get_open_order_trades() -> List['Trade']:
@@ -1378,7 +1377,7 @@ class Trade(ModelBase, LocalTrade):
         Returns all open trades
         NOTE: Not supported in Backtesting.
         """
-        return Trade.get_trades(Trade.open_order_id.isnot(None)).all()
+        return cast(List[Trade], Trade.get_trades(Trade.open_order_id.isnot(None)).all())
 
     @staticmethod
     def get_open_trades_without_assigned_fees():
@@ -1408,12 +1407,12 @@ class Trade(ModelBase, LocalTrade):
         Retrieves total realized profit
         """
         if Trade.use_db:
-            total_profit = Trade._session.scalar(
+            total_profit: float = Trade._session.execute(
                 select(func.sum(Trade.close_profit_abs)).filter(Trade.is_open.is_(False))
-            )
+            ).scalar_one()
         else:
-            total_profit = sum(
-                t.close_profit_abs for t in LocalTrade.get_trades_proxy(is_open=False))
+            total_profit = sum(t.close_profit_abs  # type: ignore
+                               for t in LocalTrade.get_trades_proxy(is_open=False))
         return total_profit or 0
 
     @staticmethod
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index db2b35049..45150423b 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -159,7 +159,7 @@ class RPC:
         """
         # Fetch open trades
         if trade_ids:
-            trades: List[Trade] = Trade.get_trades(trade_filter=Trade.id.in_(trade_ids)).all()
+            trades: Sequence[Trade] = Trade.get_trades(trade_filter=Trade.id.in_(trade_ids)).all()
         else:
             trades = Trade.get_open_trades()
 
@@ -449,7 +449,7 @@ class RPC:
         """ Returns cumulative profit statistics """
         trade_filter = ((Trade.is_open.is_(False) & (Trade.close_date >= start_date)) |
                         Trade.is_open.is_(True))
-        trades: Sequence[Trade] = Trade._session.execute(Trade.get_trades_query(
+        trades: Sequence[Trade] = Trade._session.scalars(Trade.get_trades_query(
             trade_filter, include_orders=False).order_by(Trade.id)).all()
 
         profit_all_coin = []

From 8073989c988aa2c07438d994da77893a565e657d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 21:10:47 +0100
Subject: [PATCH 037/147] Remove more usages of .query

---
 freqtrade/freqtradebot.py                    | 2 +-
 freqtrade/persistence/pairlock_middleware.py | 8 ++++----
 freqtrade/rpc/rpc.py                         | 5 -----
 3 files changed, 5 insertions(+), 10 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index dfac11347..1c181cb26 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -819,7 +819,7 @@ class FreqtradeBot(LoggingMixin):
 
         trade.orders.append(order_obj)
         trade.recalc_trade_from_orders()
-        Trade.query.session.add(trade)
+        Trade._session.add(trade)
         Trade.commit()
 
         # Updating wallets
diff --git a/freqtrade/persistence/pairlock_middleware.py b/freqtrade/persistence/pairlock_middleware.py
index 5ed131a9b..08c947a83 100644
--- a/freqtrade/persistence/pairlock_middleware.py
+++ b/freqtrade/persistence/pairlock_middleware.py
@@ -51,8 +51,8 @@ class PairLocks():
             active=True
         )
         if PairLocks.use_db:
-            PairLock.query.session.add(lock)
-            PairLock.query.session.commit()
+            PairLock._session.add(lock)
+            PairLock._session.commit()
         else:
             PairLocks.locks.append(lock)
         return lock
@@ -106,7 +106,7 @@ class PairLocks():
         for lock in locks:
             lock.active = False
         if PairLocks.use_db:
-            PairLock.query.session.commit()
+            PairLock._session.commit()
 
     @staticmethod
     def unlock_reason(reason: str, now: Optional[datetime] = None) -> None:
@@ -130,7 +130,7 @@ class PairLocks():
             for lock in locks:
                 logger.info(f"Releasing lock for {lock.pair} with reason '{reason}'.")
                 lock.active = False
-            PairLock.query.session.commit()
+            PairLock._session.commit()
         else:
             # used in backtesting mode; don't show log messages for speed
             locksb = PairLocks.get_pair_locks(None)
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index 45150423b..2d29944f8 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -347,11 +347,6 @@ class RPC:
                         Trade.close_date < (profitday + time_offset(1)))
                 .order_by(Trade.close_date)
             ).all()
-            # trades = Trade.query.session.query(Trade.close_profit_abs).filter(
-            #     Trade.is_open.is_(False),
-            #     Trade.close_date >= profitday,
-            #     Trade.close_date < (profitday + time_offset(1))
-            # ).order_by(Trade.close_date).all()
 
             curdayprofit = sum(
                 trade.close_profit_abs for trade in trades if trade.close_profit_abs is not None)

From aa54b7770256a72b20ad7e3f548291951dd59ab2 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 21:12:06 +0100
Subject: [PATCH 038/147] Rename _session to sessoin

---
 freqtrade/commands/db_commands.py            |  2 +-
 freqtrade/freqtradebot.py                    |  2 +-
 freqtrade/persistence/models.py              | 12 ++++----
 freqtrade/persistence/pairlock.py            |  2 +-
 freqtrade/persistence/pairlock_middleware.py |  8 +++---
 freqtrade/persistence/trade_model.py         | 30 ++++++++++----------
 freqtrade/rpc/rpc.py                         | 10 +++----
 7 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/freqtrade/commands/db_commands.py b/freqtrade/commands/db_commands.py
index c424016b1..b4997582d 100644
--- a/freqtrade/commands/db_commands.py
+++ b/freqtrade/commands/db_commands.py
@@ -20,7 +20,7 @@ def start_convert_db(args: Dict[str, Any]) -> None:
     config = setup_utils_configuration(args, RunMode.UTIL_NO_EXCHANGE)
 
     init_db(config['db_url'])
-    session_target = Trade._session
+    session_target = Trade.session
     init_db(config['db_url_from'])
     logger.info("Starting db migration.")
 
diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 1c181cb26..06c8831f5 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -819,7 +819,7 @@ class FreqtradeBot(LoggingMixin):
 
         trade.orders.append(order_obj)
         trade.recalc_trade_from_orders()
-        Trade._session.add(trade)
+        Trade.session.add(trade)
         Trade.commit()
 
         # Updating wallets
diff --git a/freqtrade/persistence/models.py b/freqtrade/persistence/models.py
index d718af2f4..f4058b4eb 100644
--- a/freqtrade/persistence/models.py
+++ b/freqtrade/persistence/models.py
@@ -54,12 +54,12 @@ def init_db(db_url: str) -> None:
     # https://docs.sqlalchemy.org/en/13/orm/contextual.html#thread-local-scope
     # Scoped sessions proxy requests to the appropriate thread-local session.
     # We should use the scoped_session object - not a seperately initialized version
-    Trade._session = scoped_session(sessionmaker(bind=engine, autoflush=False))
-    Order._session = Trade._session
-    PairLock._session = Trade._session
-    Trade.query = Trade._session.query_property()
-    Order.query = Trade._session.query_property()
-    PairLock.query = Trade._session.query_property()
+    Trade.session = scoped_session(sessionmaker(bind=engine, autoflush=False))
+    Order.session = Trade.session
+    PairLock.session = Trade.session
+    Trade.query = Trade.session.query_property()
+    Order.query = Trade.session.query_property()
+    PairLock.query = Trade.session.query_property()
 
     previous_tables = inspect(engine).get_table_names()
     ModelBase.metadata.create_all(engine)
diff --git a/freqtrade/persistence/pairlock.py b/freqtrade/persistence/pairlock.py
index 1e5699145..0cd595b66 100644
--- a/freqtrade/persistence/pairlock.py
+++ b/freqtrade/persistence/pairlock.py
@@ -14,7 +14,7 @@ class PairLock(ModelBase):
     """
     __tablename__ = 'pairlocks'
     query: ClassVar[QueryPropertyDescriptor]
-    _session: ClassVar[SessionType]
+    session: ClassVar[SessionType]
 
     id: Mapped[int] = mapped_column(primary_key=True)
 
diff --git a/freqtrade/persistence/pairlock_middleware.py b/freqtrade/persistence/pairlock_middleware.py
index 08c947a83..e6860bbe6 100644
--- a/freqtrade/persistence/pairlock_middleware.py
+++ b/freqtrade/persistence/pairlock_middleware.py
@@ -51,8 +51,8 @@ class PairLocks():
             active=True
         )
         if PairLocks.use_db:
-            PairLock._session.add(lock)
-            PairLock._session.commit()
+            PairLock.session.add(lock)
+            PairLock.session.commit()
         else:
             PairLocks.locks.append(lock)
         return lock
@@ -106,7 +106,7 @@ class PairLocks():
         for lock in locks:
             lock.active = False
         if PairLocks.use_db:
-            PairLock._session.commit()
+            PairLock.session.commit()
 
     @staticmethod
     def unlock_reason(reason: str, now: Optional[datetime] = None) -> None:
@@ -130,7 +130,7 @@ class PairLocks():
             for lock in locks:
                 logger.info(f"Releasing lock for {lock.pair} with reason '{reason}'.")
                 lock.active = False
-            PairLock._session.commit()
+            PairLock.session.commit()
         else:
             # used in backtesting mode; don't show log messages for speed
             locksb = PairLocks.get_pair_locks(None)
diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 58f6c666a..0cc7ad4ff 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -37,7 +37,7 @@ class Order(ModelBase):
     """
     __tablename__ = 'orders'
     query: ClassVar[QueryPropertyDescriptor]
-    _session: ClassVar[SessionType]
+    session: ClassVar[SessionType]
 
     # Uniqueness should be ensured over pair, order_id
     # its likely that order_id is unique per Pair on some exchanges.
@@ -1153,7 +1153,7 @@ class LocalTrade():
         get open trade count
         """
         if Trade.use_db:
-            return Trade._session.execute(
+            return Trade.session.execute(
                 select(func.count(Trade.id)).filter(Trade.is_open.is_(True))
             ).scalar_one()
         else:
@@ -1189,7 +1189,7 @@ class Trade(ModelBase, LocalTrade):
     """
     __tablename__ = 'trades'
     query: ClassVar[QueryPropertyDescriptor]
-    _session: ClassVar[SessionType]
+    session: ClassVar[SessionType]
 
     use_db: bool = True
 
@@ -1289,18 +1289,18 @@ class Trade(ModelBase, LocalTrade):
     def delete(self) -> None:
 
         for order in self.orders:
-            Order._session.delete(order)
+            Order.session.delete(order)
 
-        Trade._session.delete(self)
+        Trade.session.delete(self)
         Trade.commit()
 
     @staticmethod
     def commit():
-        Trade._session.commit()
+        Trade.session.commit()
 
     @staticmethod
     def rollback():
-        Trade._session.rollback()
+        Trade.session.rollback()
 
     @staticmethod
     def get_trades_proxy(*, pair: Optional[str] = None, is_open: Optional[bool] = None,
@@ -1369,7 +1369,7 @@ class Trade(ModelBase, LocalTrade):
                              e.g. `(trade_filter=Trade.id == trade_id)`
         :return: unsorted query object
         """
-        return Trade._session.scalars(Trade.get_trades_query(trade_filter, include_orders))
+        return Trade.session.scalars(Trade.get_trades_query(trade_filter, include_orders))
 
     @staticmethod
     def get_open_order_trades() -> List['Trade']:
@@ -1407,7 +1407,7 @@ class Trade(ModelBase, LocalTrade):
         Retrieves total realized profit
         """
         if Trade.use_db:
-            total_profit: float = Trade._session.execute(
+            total_profit: float = Trade.session.execute(
                 select(func.sum(Trade.close_profit_abs)).filter(Trade.is_open.is_(False))
             ).scalar_one()
         else:
@@ -1422,7 +1422,7 @@ class Trade(ModelBase, LocalTrade):
         in stake currency
         """
         if Trade.use_db:
-            total_open_stake_amount = Trade._session.scalar(
+            total_open_stake_amount = Trade.session.scalar(
                 select(func.sum(Trade.stake_amount)).filter(Trade.is_open.is_(True))
             )
         else:
@@ -1441,7 +1441,7 @@ class Trade(ModelBase, LocalTrade):
             start_date = datetime.now(timezone.utc) - timedelta(minutes=minutes)
             filters.append(Trade.close_date >= start_date)
 
-        pair_rates = Trade._session.execute(
+        pair_rates = Trade.session.execute(
             select(
                 Trade.pair,
                 func.sum(Trade.close_profit).label('profit_sum'),
@@ -1476,7 +1476,7 @@ class Trade(ModelBase, LocalTrade):
         if (pair is not None):
             filters.append(Trade.pair == pair)
 
-        enter_tag_perf = Trade._session.execute(
+        enter_tag_perf = Trade.session.execute(
             select(
                 Trade.enter_tag,
                 func.sum(Trade.close_profit).label('profit_sum'),
@@ -1509,7 +1509,7 @@ class Trade(ModelBase, LocalTrade):
         filters: List = [Trade.is_open.is_(False)]
         if (pair is not None):
             filters.append(Trade.pair == pair)
-        sell_tag_perf = Trade._session.execute(
+        sell_tag_perf = Trade.session.execute(
             select(
                 Trade.exit_reason,
                 func.sum(Trade.close_profit).label('profit_sum'),
@@ -1542,7 +1542,7 @@ class Trade(ModelBase, LocalTrade):
         filters: List = [Trade.is_open.is_(False)]
         if (pair is not None):
             filters.append(Trade.pair == pair)
-        mix_tag_perf = Trade._session.execute(
+        mix_tag_perf = Trade.session.execute(
             select(
                 Trade.id,
                 Trade.enter_tag,
@@ -1589,7 +1589,7 @@ class Trade(ModelBase, LocalTrade):
         NOTE: Not supported in Backtesting.
         :returns: Tuple containing (pair, profit_sum)
         """
-        best_pair = Trade._session.execute(
+        best_pair = Trade.session.execute(
             select(
                 Trade.pair,
                 func.sum(Trade.close_profit).label('profit_sum')
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index 2d29944f8..f86362841 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -340,7 +340,7 @@ class RPC:
         for day in range(0, timescale):
             profitday = start_date - time_offset(day)
             # Only query for necessary columns for performance reasons.
-            trades = Trade._session.execute(
+            trades = Trade.session.execute(
                 select(Trade.close_profit_abs)
                 .filter(Trade.is_open.is_(False),
                         Trade.close_date >= profitday,
@@ -384,18 +384,18 @@ class RPC:
         """ Returns the X last trades """
         order_by: Any = Trade.id if order_by_id else Trade.close_date.desc()
         if limit:
-            trades = Trade._session.execute(
+            trades = Trade.session.execute(
                 Trade.get_trades_query([Trade.is_open.is_(False)])
                 .order_by(order_by)
                 .limit(limit)
                 .offset(offset))
         else:
-            trades = Trade._session.execute(
+            trades = Trade.session.execute(
                 Trade.get_trades_query([Trade.is_open.is_(False)])
                 .order_by(Trade.close_date.desc()))
 
         output = [trade.to_json() for trade in trades]
-        total_trades = Trade._session.scalar(
+        total_trades = Trade.session.scalar(
             select(func.count(Trade.id)).filter(Trade.is_open.is_(False)))
 
         return {
@@ -444,7 +444,7 @@ class RPC:
         """ Returns cumulative profit statistics """
         trade_filter = ((Trade.is_open.is_(False) & (Trade.close_date >= start_date)) |
                         Trade.is_open.is_(True))
-        trades: Sequence[Trade] = Trade._session.scalars(Trade.get_trades_query(
+        trades: Sequence[Trade] = Trade.session.scalars(Trade.get_trades_query(
             trade_filter, include_orders=False).order_by(Trade.id)).all()
 
         profit_all_coin = []

From 8865af9104f570401ae1bf1e7b0ca7afe7bdf5aa Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 21:19:36 +0100
Subject: [PATCH 039/147] Remove .query from pairlock

---
 freqtrade/persistence/pairlock.py            | 10 ++++------
 freqtrade/persistence/pairlock_middleware.py |  6 ++++--
 freqtrade/rpc/rpc.py                         |  2 +-
 freqtrade/util/binance_mig.py                |  3 ++-
 4 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/freqtrade/persistence/pairlock.py b/freqtrade/persistence/pairlock.py
index 0cd595b66..76382b849 100644
--- a/freqtrade/persistence/pairlock.py
+++ b/freqtrade/persistence/pairlock.py
@@ -1,8 +1,8 @@
 from datetime import datetime, timezone
 from typing import Any, ClassVar, Dict, Optional
 
-from sqlalchemy import String, or_
-from sqlalchemy.orm import Mapped, Query, QueryPropertyDescriptor, mapped_column
+from sqlalchemy import ScalarResult, String, or_, select
+from sqlalchemy.orm import Mapped, QueryPropertyDescriptor, mapped_column
 
 from freqtrade.constants import DATETIME_PRINT_FORMAT
 from freqtrade.persistence.base import ModelBase, SessionType
@@ -37,7 +37,7 @@ class PairLock(ModelBase):
             f'lock_end_time={lock_end_time}, reason={self.reason}, active={self.active})')
 
     @staticmethod
-    def query_pair_locks(pair: Optional[str], now: datetime, side: str = '*') -> Query:
+    def query_pair_locks(pair: Optional[str], now: datetime, side: str = '*') -> ScalarResult['PairLock']:
         """
         Get all currently active locks for this pair
         :param pair: Pair to check for. Returns all current locks if pair is empty
@@ -53,9 +53,7 @@ class PairLock(ModelBase):
         else:
             filters.append(PairLock.side == '*')
 
-        return PairLock.query.filter(
-            *filters
-        )
+        return PairLock.session.scalars(select(PairLock).filter(*filters))
 
     def to_json(self) -> Dict[str, Any]:
         return {
diff --git a/freqtrade/persistence/pairlock_middleware.py b/freqtrade/persistence/pairlock_middleware.py
index e6860bbe6..a8950961e 100644
--- a/freqtrade/persistence/pairlock_middleware.py
+++ b/freqtrade/persistence/pairlock_middleware.py
@@ -2,6 +2,8 @@ import logging
 from datetime import datetime, timezone
 from typing import List, Optional
 
+from sqlalchemy import select
+
 from freqtrade.exchange import timeframe_to_next_date
 from freqtrade.persistence.models import PairLock
 
@@ -126,7 +128,7 @@ class PairLocks():
                        PairLock.active.is_(True),
                        PairLock.reason == reason
                        ]
-            locks = PairLock.query.filter(*filters)
+            locks = PairLock.session.scalars(select(PairLock).filter(*filters)).all()
             for lock in locks:
                 logger.info(f"Releasing lock for {lock.pair} with reason '{reason}'.")
                 lock.active = False
@@ -170,6 +172,6 @@ class PairLocks():
         Return all locks, also locks with expired end date
         """
         if PairLocks.use_db:
-            return PairLock.query.all()
+            return PairLock.session.scalars(select(PairLock)).all()
         else:
             return PairLocks.locks
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index f86362841..6915c2025 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -959,7 +959,7 @@ class RPC:
         if pair:
             locks = PairLocks.get_pair_locks(pair)
         if lockid:
-            locks = PairLock.query.filter(PairLock.id == lockid).all()
+            locks = PairLock.session.scalar(select(PairLock).filter(PairLock.id == lockid)).all()
 
         for lock in locks:
             lock.active = False
diff --git a/freqtrade/util/binance_mig.py b/freqtrade/util/binance_mig.py
index 708bb1db7..37a2d2ef1 100644
--- a/freqtrade/util/binance_mig.py
+++ b/freqtrade/util/binance_mig.py
@@ -1,6 +1,7 @@
 import logging
 
 from packaging import version
+from sqlalchemy import select
 
 from freqtrade.constants import Config
 from freqtrade.enums.tradingmode import TradingMode
@@ -44,7 +45,7 @@ def _migrate_binance_futures_db(config: Config):
             # Should symbol be migrated too?
             # order.symbol = new_pair
     Trade.commit()
-    pls = PairLock.query.filter(PairLock.pair.notlike('%:%'))
+    pls = PairLock.session.scalars(select(PairLock).filter(PairLock.pair.notlike('%:%'))).all()
     for pl in pls:
         pl.pair = f"{pl.pair}:{config['stake_currency']}"
     # print(pls)

From ae361e1d5d82adc78578f99c716e63f95a642c9d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 06:44:53 +0100
Subject: [PATCH 040/147] Update more .query usages

---
 freqtrade/persistence/pairlock.py            | 3 ++-
 freqtrade/persistence/pairlock_middleware.py | 8 ++++----
 freqtrade/persistence/trade_model.py         | 8 ++++----
 freqtrade/rpc/rpc.py                         | 4 ++--
 4 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/freqtrade/persistence/pairlock.py b/freqtrade/persistence/pairlock.py
index 76382b849..af56a392c 100644
--- a/freqtrade/persistence/pairlock.py
+++ b/freqtrade/persistence/pairlock.py
@@ -37,7 +37,8 @@ class PairLock(ModelBase):
             f'lock_end_time={lock_end_time}, reason={self.reason}, active={self.active})')
 
     @staticmethod
-    def query_pair_locks(pair: Optional[str], now: datetime, side: str = '*') -> ScalarResult['PairLock']:
+    def query_pair_locks(
+            pair: Optional[str], now: datetime, side: str = '*') -> ScalarResult['PairLock']:
         """
         Get all currently active locks for this pair
         :param pair: Pair to check for. Returns all current locks if pair is empty
diff --git a/freqtrade/persistence/pairlock_middleware.py b/freqtrade/persistence/pairlock_middleware.py
index a8950961e..0a3d78c4a 100644
--- a/freqtrade/persistence/pairlock_middleware.py
+++ b/freqtrade/persistence/pairlock_middleware.py
@@ -1,6 +1,6 @@
 import logging
 from datetime import datetime, timezone
-from typing import List, Optional
+from typing import List, Optional, Sequence
 
 from sqlalchemy import select
 
@@ -60,8 +60,8 @@ class PairLocks():
         return lock
 
     @staticmethod
-    def get_pair_locks(
-            pair: Optional[str], now: Optional[datetime] = None, side: str = '*') -> List[PairLock]:
+    def get_pair_locks(pair: Optional[str], now: Optional[datetime] = None,
+                       side: str = '*') -> Sequence[PairLock]:
         """
         Get all currently active locks for this pair
         :param pair: Pair to check for. Returns all current locks if pair is empty
@@ -167,7 +167,7 @@ class PairLocks():
         )
 
     @staticmethod
-    def get_all_locks() -> List[PairLock]:
+    def get_all_locks() -> Sequence[PairLock]:
         """
         Return all locks, also locks with expired end date
         """
diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 0cc7ad4ff..101638828 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -5,7 +5,7 @@ import logging
 from collections import defaultdict
 from datetime import datetime, timedelta, timezone
 from math import isclose
-from typing import Any, ClassVar, Dict, List, Optional, cast
+from typing import Any, ClassVar, Dict, List, Optional, Sequence, cast
 
 from sqlalchemy import (Enum, Float, ForeignKey, Integer, ScalarResult, Select, String,
                         UniqueConstraint, desc, func, select)
@@ -263,12 +263,12 @@ class Order(ModelBase):
         return o
 
     @staticmethod
-    def get_open_orders() -> List['Order']:
+    def get_open_orders() -> Sequence['Order']:
         """
         Retrieve open orders from the database
         :return: List of open orders
         """
-        return Order.query.filter(Order.ft_is_open.is_(True)).all()
+        return Order.session.scalars(select(Order).filter(Order.ft_is_open.is_(True))).all()
 
     @staticmethod
     def order_by_id(order_id: str) -> Optional['Order']:
@@ -276,7 +276,7 @@ class Order(ModelBase):
         Retrieve order based on order_id
         :return: Order or None
         """
-        return Order.query.filter(Order.order_id == order_id).first()
+        return Order.session.scalars(select(Order).filter(Order.order_id == order_id)).first()
 
 
 class LocalTrade():
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index 6915c2025..cf1669231 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -954,12 +954,12 @@ class RPC:
     def _rpc_delete_lock(self, lockid: Optional[int] = None,
                          pair: Optional[str] = None) -> Dict[str, Any]:
         """ Delete specific lock(s) """
-        locks = []
+        locks: Sequence[PairLock] = []
 
         if pair:
             locks = PairLocks.get_pair_locks(pair)
         if lockid:
-            locks = PairLock.session.scalar(select(PairLock).filter(PairLock.id == lockid)).all()
+            locks = PairLock.session.scalars(select(PairLock).filter(PairLock.id == lockid)).all()
 
         for lock in locks:
             lock.active = False

From e579ff9532dbcd0c98c462c3dff3c394e8a9fbd4 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 06:48:12 +0100
Subject: [PATCH 041/147] Simplify pairlock querying

---
 freqtrade/commands/db_commands.py            |  2 +-
 freqtrade/persistence/pairlock.py            |  4 ++++
 freqtrade/persistence/pairlock_middleware.py |  2 +-
 freqtrade/persistence/trade_model.py         | 13 +++++++------
 4 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/freqtrade/commands/db_commands.py b/freqtrade/commands/db_commands.py
index b4997582d..c819ca243 100644
--- a/freqtrade/commands/db_commands.py
+++ b/freqtrade/commands/db_commands.py
@@ -36,7 +36,7 @@ def start_convert_db(args: Dict[str, Any]) -> None:
 
     session_target.commit()
 
-    for pairlock in PairLock.query:
+    for pairlock in PairLock.get_all_locks():
         pairlock_count += 1
         make_transient(pairlock)
         session_target.add(pairlock)
diff --git a/freqtrade/persistence/pairlock.py b/freqtrade/persistence/pairlock.py
index af56a392c..e787b5fa0 100644
--- a/freqtrade/persistence/pairlock.py
+++ b/freqtrade/persistence/pairlock.py
@@ -56,6 +56,10 @@ class PairLock(ModelBase):
 
         return PairLock.session.scalars(select(PairLock).filter(*filters))
 
+    @staticmethod
+    def get_all_locks() -> ScalarResult['PairLock']:
+        return PairLock.session.scalars(select(PairLock))
+
     def to_json(self) -> Dict[str, Any]:
         return {
             'id': self.id,
diff --git a/freqtrade/persistence/pairlock_middleware.py b/freqtrade/persistence/pairlock_middleware.py
index 0a3d78c4a..29169a50d 100644
--- a/freqtrade/persistence/pairlock_middleware.py
+++ b/freqtrade/persistence/pairlock_middleware.py
@@ -172,6 +172,6 @@ class PairLocks():
         Return all locks, also locks with expired end date
         """
         if PairLocks.use_db:
-            return PairLock.session.scalars(select(PairLock)).all()
+            return PairLock.get_all_locks().all()
         else:
             return PairLocks.locks
diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 101638828..892707810 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -1607,12 +1607,13 @@ class Trade(ModelBase, LocalTrade):
         NOTE: Not supported in Backtesting.
         :returns: Tuple containing (pair, profit_sum)
         """
-        trading_volume = Order.query.with_entities(
-            func.sum(Order.cost).label('volume')
-        ).filter(
-            Order.order_filled_date >= start_date,
-            Order.status == 'closed'
-        ).scalar()
+        trading_volume = Trade.session.execute(
+            select(
+                func.sum(Order.cost).label('volume')
+            ).filter(
+                Order.order_filled_date >= start_date,
+                Order.status == 'closed'
+            )).scalar_one()
         return trading_volume
 
     @staticmethod

From 6ed337faa38bd1a3c83858f438af3aa1060a446e Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 07:04:15 +0100
Subject: [PATCH 042/147] Update several tests to remove .query

---
 freqtrade/rpc/rpc.py                  |  4 ++--
 tests/conftest.py                     | 10 +++++-----
 tests/persistence/test_migrations.py  |  6 +++---
 tests/persistence/test_persistence.py | 12 ++++++------
 tests/rpc/test_rpc_apiserver.py       | 12 ++++++------
 5 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index cf1669231..eb184c6d6 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -384,13 +384,13 @@ class RPC:
         """ Returns the X last trades """
         order_by: Any = Trade.id if order_by_id else Trade.close_date.desc()
         if limit:
-            trades = Trade.session.execute(
+            trades = Trade.session.scalars(
                 Trade.get_trades_query([Trade.is_open.is_(False)])
                 .order_by(order_by)
                 .limit(limit)
                 .offset(offset))
         else:
-            trades = Trade.session.execute(
+            trades = Trade.session.scalars(
                 Trade.get_trades_query([Trade.is_open.is_(False)])
                 .order_by(Trade.close_date.desc()))
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 3c10de4ec..0aa6e70a8 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -299,7 +299,7 @@ def create_mock_trades(fee, is_short: Optional[bool] = False, use_db: bool = Tru
     """
     def add_trade(trade):
         if use_db:
-            Trade.query.session.add(trade)
+            Trade.session.add(trade)
         else:
             LocalTrade.add_bt_trade(trade)
     is_short1 = is_short if is_short is not None else True
@@ -332,11 +332,11 @@ def create_mock_trades_with_leverage(fee, use_db: bool = True):
     Create some fake trades ...
     """
     if use_db:
-        Trade.query.session.rollback()
+        Trade.session.rollback()
 
     def add_trade(trade):
         if use_db:
-            Trade.query.session.add(trade)
+            Trade.session.add(trade)
         else:
             LocalTrade.add_bt_trade(trade)
 
@@ -366,7 +366,7 @@ def create_mock_trades_with_leverage(fee, use_db: bool = True):
     add_trade(trade)
 
     if use_db:
-        Trade.query.session.flush()
+        Trade.session.flush()
 
 
 def create_mock_trades_usdt(fee, is_short: Optional[bool] = False, use_db: bool = True):
@@ -375,7 +375,7 @@ def create_mock_trades_usdt(fee, is_short: Optional[bool] = False, use_db: bool
     """
     def add_trade(trade):
         if use_db:
-            Trade.query.session.add(trade)
+            Trade.session.add(trade)
         else:
             LocalTrade.add_bt_trade(trade)
 
diff --git a/tests/persistence/test_migrations.py b/tests/persistence/test_migrations.py
index 2a6959d58..5254164c1 100644
--- a/tests/persistence/test_migrations.py
+++ b/tests/persistence/test_migrations.py
@@ -21,8 +21,8 @@ spot, margin, futures = TradingMode.SPOT, TradingMode.MARGIN, TradingMode.FUTURE
 def test_init_create_session(default_conf):
     # Check if init create a session
     init_db(default_conf['db_url'])
-    assert hasattr(Trade, '_session')
-    assert 'scoped_session' in type(Trade._session).__name__
+    assert hasattr(Trade, 'session')
+    assert 'scoped_session' in type(Trade.session).__name__
 
 
 def test_init_custom_db_url(default_conf, tmpdir):
@@ -34,7 +34,7 @@ def test_init_custom_db_url(default_conf, tmpdir):
 
     init_db(default_conf['db_url'])
     assert Path(filename).is_file()
-    r = Trade._session.execute(text("PRAGMA journal_mode"))
+    r = Trade.session.execute(text("PRAGMA journal_mode"))
     assert r.first() == ('wal',)
 
 
diff --git a/tests/persistence/test_persistence.py b/tests/persistence/test_persistence.py
index cd4890db9..24ab75a2d 100644
--- a/tests/persistence/test_persistence.py
+++ b/tests/persistence/test_persistence.py
@@ -1494,7 +1494,7 @@ def test_stoploss_reinitialization(default_conf, fee):
     assert trade.stop_loss_pct == -0.05
     assert trade.initial_stop_loss == 0.95
     assert trade.initial_stop_loss_pct == -0.05
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
 
     # Lower stoploss
@@ -1556,7 +1556,7 @@ def test_stoploss_reinitialization_leverage(default_conf, fee):
     assert trade.stop_loss_pct == -0.1
     assert trade.initial_stop_loss == 0.98
     assert trade.initial_stop_loss_pct == -0.1
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
 
     # Lower stoploss
@@ -1618,7 +1618,7 @@ def test_stoploss_reinitialization_short(default_conf, fee):
     assert trade.stop_loss_pct == -0.1
     assert trade.initial_stop_loss == 1.02
     assert trade.initial_stop_loss_pct == -0.1
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
     # Lower stoploss
     Trade.stoploss_reinitialization(-0.15)
@@ -2443,8 +2443,8 @@ def test_order_to_ccxt(limit_buy_order_open):
 
     order = Order.parse_from_ccxt_object(limit_buy_order_open, 'mocked', 'buy')
     order.ft_trade_id = 1
-    order.query.session.add(order)
-    Order.query.session.commit()
+    order.session.add(order)
+    Order.session.commit()
 
     order_resp = Order.order_by_id(limit_buy_order_open['id'])
     assert order_resp
@@ -2546,7 +2546,7 @@ def test_recalc_trade_from_orders_dca(data) -> None:
         leverage=1.0,
         trading_mode=TradingMode.SPOT
     )
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
 
     for idx, (order, result) in enumerate(data['orders']):
         amount = order[1]
diff --git a/tests/rpc/test_rpc_apiserver.py b/tests/rpc/test_rpc_apiserver.py
index 9c2c3ee3a..5211946ef 100644
--- a/tests/rpc/test_rpc_apiserver.py
+++ b/tests/rpc/test_rpc_apiserver.py
@@ -652,7 +652,7 @@ def test_api_trade_single(botclient, mocker, fee, ticker, markets, is_short):
     assert_response(rc, 404)
     assert rc.json()['detail'] == 'Trade not found.'
 
-    Trade.query.session.rollback()
+    Trade.rollback()
     create_mock_trades(fee, is_short=is_short)
 
     rc = client_get(client, f"{BASE_URI}/trade/3")
@@ -943,7 +943,7 @@ def test_api_performance(botclient, fee):
     )
     trade.close_profit = trade.calc_profit_ratio(trade.close_rate)
     trade.close_profit_abs = trade.calc_profit(trade.close_rate)
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
 
     trade = Trade(
         pair='XRP/ETH',
@@ -960,7 +960,7 @@ def test_api_performance(botclient, fee):
     trade.close_profit = trade.calc_profit_ratio(trade.close_rate)
     trade.close_profit_abs = trade.calc_profit(trade.close_rate)
 
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
 
     rc = client_get(client, f"{BASE_URI}/performance")
@@ -1290,7 +1290,7 @@ def test_api_forceexit(botclient, mocker, ticker, fee, markets):
                      data={"tradeid": "1"})
     assert_response(rc, 502)
     assert rc.json() == {"error": "Error querying /api/v1/forceexit: invalid argument"}
-    Trade.query.session.rollback()
+    Trade.rollback()
 
     create_mock_trades(fee)
     trade = Trade.get_trades([Trade.id == 5]).first()
@@ -1299,7 +1299,7 @@ def test_api_forceexit(botclient, mocker, ticker, fee, markets):
                      data={"tradeid": "5", "ordertype": "market", "amount": 23})
     assert_response(rc)
     assert rc.json() == {'result': 'Created sell order for trade 5.'}
-    Trade.query.session.rollback()
+    Trade.rollback()
 
     trade = Trade.get_trades([Trade.id == 5]).first()
     assert pytest.approx(trade.amount) == 100
@@ -1309,7 +1309,7 @@ def test_api_forceexit(botclient, mocker, ticker, fee, markets):
                      data={"tradeid": "5"})
     assert_response(rc)
     assert rc.json() == {'result': 'Created sell order for trade 5.'}
-    Trade.query.session.rollback()
+    Trade.rollback()
 
     trade = Trade.get_trades([Trade.id == 5]).first()
     assert trade.is_open is False

From 9d6e973e5b91a8c816557f2ad21ca883292527b0 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 07:25:04 +0100
Subject: [PATCH 043/147] remove .query from most tests

---
 tests/persistence/test_migrations.py  |   9 +-
 tests/persistence/test_persistence.py |   7 +-
 tests/plugins/test_pairlocks.py       |   6 +-
 tests/plugins/test_protections.py     |   2 +-
 tests/rpc/test_rpc.py                 |   9 +-
 tests/rpc/test_rpc_apiserver.py       |  11 +-
 tests/rpc/test_rpc_telegram.py        |   7 +-
 tests/test_freqtradebot.py            | 220 +++++++++++++-------------
 tests/test_integration.py             |   7 +-
 9 files changed, 144 insertions(+), 134 deletions(-)

diff --git a/tests/persistence/test_migrations.py b/tests/persistence/test_migrations.py
index 5254164c1..053d6da12 100644
--- a/tests/persistence/test_migrations.py
+++ b/tests/persistence/test_migrations.py
@@ -4,7 +4,7 @@ from pathlib import Path
 from unittest.mock import MagicMock
 
 import pytest
-from sqlalchemy import create_engine, text
+from sqlalchemy import create_engine, select, text
 
 from freqtrade.constants import DEFAULT_DB_PROD_URL
 from freqtrade.enums import TradingMode
@@ -235,8 +235,9 @@ def test_migrate_new(mocker, default_conf, fee, caplog):
     # Run init to test migration
     init_db(default_conf['db_url'])
 
-    assert len(Trade.query.filter(Trade.id == 1).all()) == 1
-    trade = Trade.query.filter(Trade.id == 1).first()
+    trades = Trade.session.scalars(select(Trade).filter(Trade.id == 1)).all()
+    assert len(trades) == 1
+    trade = trades[0]
     assert trade.fee_open == fee.return_value
     assert trade.fee_close == fee.return_value
     assert trade.open_rate_requested is None
@@ -404,7 +405,7 @@ def test_migrate_pairlocks(mocker, default_conf, fee, caplog):
 
     init_db(default_conf['db_url'])
 
-    assert len(PairLock.query.all()) == 2
+    assert len(PairLock.get_all_locks().all()) == 2
     assert len(PairLock.query.filter(PairLock.pair == '*').all()) == 1
     pairlocks = PairLock.query.filter(PairLock.pair == 'ETH/BTC').all()
     assert len(pairlocks) == 1
diff --git a/tests/persistence/test_persistence.py b/tests/persistence/test_persistence.py
index 24ab75a2d..78e97e2e6 100644
--- a/tests/persistence/test_persistence.py
+++ b/tests/persistence/test_persistence.py
@@ -4,6 +4,7 @@ from types import FunctionType
 
 import arrow
 import pytest
+from sqlalchemy import select
 
 from freqtrade.constants import DATETIME_PRINT_FORMAT
 from freqtrade.enums import TradingMode
@@ -2575,11 +2576,11 @@ def test_recalc_trade_from_orders_dca(data) -> None:
         trade.recalc_trade_from_orders()
         Trade.commit()
 
-        orders1 = Order.query.all()
+        orders1 = Order.session.scalars(select(Order)).all()
         assert orders1
         assert len(orders1) == idx + 1
 
-        trade = Trade.query.first()
+        trade = Trade.session.scalars(select(Trade)).first()
         assert trade
         assert len(trade.orders) == idx + 1
         if idx < len(data) - 1:
@@ -2596,6 +2597,6 @@ def test_recalc_trade_from_orders_dca(data) -> None:
     assert pytest.approx(trade.close_profit_abs) == data['end_profit']
     assert pytest.approx(trade.close_profit) == data['end_profit_ratio']
     assert not trade.is_open
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
diff --git a/tests/plugins/test_pairlocks.py b/tests/plugins/test_pairlocks.py
index 0ba9bb746..39bde3cda 100644
--- a/tests/plugins/test_pairlocks.py
+++ b/tests/plugins/test_pairlocks.py
@@ -14,7 +14,7 @@ def test_PairLocks(use_db):
     PairLocks.use_db = use_db
     # No lock should be present
     if use_db:
-        assert len(PairLock.query.all()) == 0
+        assert len(PairLock.get_all_locks().all()) == 0
 
     assert PairLocks.use_db == use_db
 
@@ -88,13 +88,13 @@ def test_PairLocks(use_db):
 
     if use_db:
         locks = PairLocks.get_all_locks()
-        locks_db = PairLock.query.all()
+        locks_db = PairLock.get_all_locks().all()
         assert len(locks) == len(locks_db)
         assert len(locks_db) > 0
     else:
         # Nothing was pushed to the database
         assert len(PairLocks.get_all_locks()) > 0
-        assert len(PairLock.query.all()) == 0
+        assert len(PairLock.get_all_locks().all()) == 0
     # Reset use-db variable
     PairLocks.reset_locks()
     PairLocks.use_db = True
diff --git a/tests/plugins/test_protections.py b/tests/plugins/test_protections.py
index 2bbdf3d4f..5e6128c73 100644
--- a/tests/plugins/test_protections.py
+++ b/tests/plugins/test_protections.py
@@ -74,7 +74,7 @@ def generate_mock_trade(pair: str, fee: float, is_open: bool,
         trade.close(close_price)
         trade.exit_reason = exit_reason
 
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
     return trade
 
diff --git a/tests/rpc/test_rpc.py b/tests/rpc/test_rpc.py
index 1a1802c68..7d829bdb6 100644
--- a/tests/rpc/test_rpc.py
+++ b/tests/rpc/test_rpc.py
@@ -4,6 +4,7 @@ from unittest.mock import ANY, MagicMock, PropertyMock
 
 import pytest
 from numpy import isnan
+from sqlalchemy import select
 
 from freqtrade.edge import PairInfo
 from freqtrade.enums import SignalDirection, State, TradingMode
@@ -354,7 +355,7 @@ def test_rpc_delete_trade(mocker, default_conf, fee, markets, caplog, is_short):
     with pytest.raises(RPCException, match='invalid argument'):
         rpc._rpc_delete('200')
 
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     trades[1].stoploss_order_id = '1234'
     trades[2].stoploss_order_id = '1234'
     assert len(trades) > 2
@@ -717,7 +718,7 @@ def test_rpc_force_exit(default_conf, ticker, fee, mocker) -> None:
     mocker.patch(f'{EXMS}._dry_is_price_crossed', MagicMock(return_value=False))
     freqtradebot.enter_positions()
     # make an limit-buy open trade
-    trade = Trade.query.filter(Trade.id == '3').first()
+    trade = Trade.session.scalars(select(Trade).filter(Trade.id == '3')).first()
     filled_amount = trade.amount / 2
     # Fetch order - it's open first, and closed after cancel_order is called.
     mocker.patch(
@@ -753,7 +754,7 @@ def test_rpc_force_exit(default_conf, ticker, fee, mocker) -> None:
 
     freqtradebot.config['max_open_trades'] = 3
     freqtradebot.enter_positions()
-    trade = Trade.query.filter(Trade.id == '2').first()
+    trade = Trade.session.scalars(select(Trade).filter(Trade.id == '2')).first()
     amount = trade.amount
     # make an limit-buy open trade, if there is no 'filled', don't sell it
     mocker.patch(
@@ -771,7 +772,7 @@ def test_rpc_force_exit(default_conf, ticker, fee, mocker) -> None:
     assert cancel_order_mock.call_count == 2
     assert trade.amount == amount
 
-    trade = Trade.query.filter(Trade.id == '3').first()
+    trade = Trade.session.scalars(select(Trade).filter(Trade.id == '3')).first()
 
     # make an limit-sell open trade
     mocker.patch(
diff --git a/tests/rpc/test_rpc_apiserver.py b/tests/rpc/test_rpc_apiserver.py
index 5211946ef..97319b78b 100644
--- a/tests/rpc/test_rpc_apiserver.py
+++ b/tests/rpc/test_rpc_apiserver.py
@@ -14,6 +14,7 @@ from fastapi import FastAPI, WebSocketDisconnect
 from fastapi.exceptions import HTTPException
 from fastapi.testclient import TestClient
 from requests.auth import _basic_auth_str
+from sqlalchemy import select
 
 from freqtrade.__init__ import __version__
 from freqtrade.enums import CandleType, RunMode, State, TradingMode
@@ -624,7 +625,7 @@ def test_api_trades(botclient, mocker, fee, markets, is_short):
     assert rc.json()['offset'] == 0
 
     create_mock_trades(fee, is_short=is_short)
-    Trade.query.session.flush()
+    Trade.session.flush()
 
     rc = client_get(client, f"{BASE_URI}/trades")
     assert_response(rc)
@@ -677,7 +678,7 @@ def test_api_delete_trade(botclient, mocker, fee, markets, is_short):
     create_mock_trades(fee, is_short=is_short)
 
     ftbot.strategy.order_types['stoploss_on_exchange'] = True
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     trades[1].stoploss_order_id = '1234'
     Trade.commit()
     assert len(trades) > 2
@@ -685,7 +686,7 @@ def test_api_delete_trade(botclient, mocker, fee, markets, is_short):
     rc = client_delete(client, f"{BASE_URI}/trades/1")
     assert_response(rc)
     assert rc.json()['result_msg'] == 'Deleted trade 1. Closed 1 open orders.'
-    assert len(trades) - 1 == len(Trade.query.all())
+    assert len(trades) - 1 == len(Trade.session.scalars(select(Trade)).all())
     assert cancel_mock.call_count == 1
 
     cancel_mock.reset_mock()
@@ -694,11 +695,11 @@ def test_api_delete_trade(botclient, mocker, fee, markets, is_short):
     assert_response(rc, 502)
     assert cancel_mock.call_count == 0
 
-    assert len(trades) - 1 == len(Trade.query.all())
+    assert len(trades) - 1 == len(Trade.session.scalars(select(Trade)).all())
     rc = client_delete(client, f"{BASE_URI}/trades/2")
     assert_response(rc)
     assert rc.json()['result_msg'] == 'Deleted trade 2. Closed 2 open orders.'
-    assert len(trades) - 2 == len(Trade.query.all())
+    assert len(trades) - 2 == len(Trade.session.scalars(select(Trade)).all())
     assert stoploss_mock.call_count == 1
 
     rc = client_delete(client, f"{BASE_URI}/trades/502")
diff --git a/tests/rpc/test_rpc_telegram.py b/tests/rpc/test_rpc_telegram.py
index 59b6df489..b1859f581 100644
--- a/tests/rpc/test_rpc_telegram.py
+++ b/tests/rpc/test_rpc_telegram.py
@@ -14,6 +14,7 @@ import arrow
 import pytest
 import time_machine
 from pandas import DataFrame
+from sqlalchemy import select
 from telegram import Chat, Message, ReplyKeyboardMarkup, Update
 from telegram.error import BadRequest, NetworkError, TelegramError
 
@@ -692,7 +693,7 @@ def test_profit_handle(default_conf_usdt, update, ticker_usdt, ticker_sell_up, f
 
     # Create some test data
     freqtradebot.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
 
     context = MagicMock()
     # Test with invalid 2nd argument (should silently pass)
@@ -945,7 +946,7 @@ def test_telegram_forceexit_handle(default_conf, update, ticker, fee,
     # Create some test data
     freqtradebot.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
 
     # Increase the price and sell it
@@ -1020,7 +1021,7 @@ def test_telegram_force_exit_down_handle(default_conf, update, ticker, fee,
         fetch_ticker=ticker_sell_down
     )
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
 
     # /forceexit 1
diff --git a/tests/test_freqtradebot.py b/tests/test_freqtradebot.py
index 349655243..49d00a860 100644
--- a/tests/test_freqtradebot.py
+++ b/tests/test_freqtradebot.py
@@ -10,6 +10,7 @@ from unittest.mock import ANY, MagicMock, PropertyMock, patch
 import arrow
 import pytest
 from pandas import DataFrame
+from sqlalchemy import select
 
 from freqtrade.constants import CANCEL_REASON, UNLIMITED_STAKE_AMOUNT
 from freqtrade.enums import (CandleType, ExitCheckTuple, ExitType, RPCMessageType, RunMode,
@@ -247,7 +248,7 @@ def test_edge_overrides_stoploss(limit_order, fee, caplog, mocker,
     patch_get_signal(freqtrade)
     freqtrade.strategy.min_roi_reached = MagicMock(return_value=False)
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     caplog.clear()
     #############################################
     ticker_val.update({
@@ -278,7 +279,7 @@ def test_total_open_trades_stakes(mocker, default_conf_usdt, ticker_usdt, fee) -
     freqtrade = FreqtradeBot(default_conf_usdt)
     patch_get_signal(freqtrade)
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
 
     assert trade is not None
     assert trade.stake_amount == 60.0
@@ -286,7 +287,7 @@ def test_total_open_trades_stakes(mocker, default_conf_usdt, ticker_usdt, fee) -
     assert trade.open_date is not None
 
     freqtrade.enter_positions()
-    trade = Trade.query.order_by(Trade.id.desc()).first()
+    trade = Trade.session.scalars(select(Trade).order_by(Trade.id.desc())).first()
 
     assert trade is not None
     assert trade.stake_amount == 60.0
@@ -317,7 +318,7 @@ def test_create_trade(default_conf_usdt, ticker_usdt, limit_order,
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
     freqtrade.create_trade('ETH/USDT')
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade is not None
     assert pytest.approx(trade.stake_amount) == 60.0
@@ -568,12 +569,12 @@ def test_process_trade_creation(default_conf_usdt, ticker_usdt, limit_order, lim
     freqtrade = FreqtradeBot(default_conf_usdt)
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
 
-    trades = Trade.query.filter(Trade.is_open.is_(True)).all()
+    trades = Trade.get_open_trades()
     assert not trades
 
     freqtrade.process()
 
-    trades = Trade.query.filter(Trade.is_open.is_(True)).all()
+    trades = Trade.get_open_trades()
     assert len(trades) == 1
     trade = trades[0]
     assert trade is not None
@@ -640,11 +641,11 @@ def test_process_trade_handling(default_conf_usdt, ticker_usdt, limit_buy_order_
     freqtrade = FreqtradeBot(default_conf_usdt)
     patch_get_signal(freqtrade)
 
-    trades = Trade.query.filter(Trade.is_open.is_(True)).all()
+    trades = Trade.get_open_trades()
     assert not trades
     freqtrade.process()
 
-    trades = Trade.query.filter(Trade.is_open.is_(True)).all()
+    trades = Trade.get_open_trades()
     assert len(trades) == 1
 
     # Nothing happened ...
@@ -671,7 +672,7 @@ def test_process_trade_no_whitelist_pair(default_conf_usdt, ticker_usdt, limit_b
     assert pair not in default_conf_usdt['exchange']['pair_whitelist']
 
     # create open trade not in whitelist
-    Trade.query.session.add(Trade(
+    Trade.session.add(Trade(
         pair=pair,
         stake_amount=0.001,
         fee_open=fee.return_value,
@@ -681,7 +682,7 @@ def test_process_trade_no_whitelist_pair(default_conf_usdt, ticker_usdt, limit_b
         open_rate=0.01,
         exchange='binance',
     ))
-    Trade.query.session.add(Trade(
+    Trade.session.add(Trade(
         pair='ETH/USDT',
         stake_amount=0.001,
         fee_open=fee.return_value,
@@ -838,7 +839,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
 
     # Should create an open trade with an open order id
     # As the order is not fulfilled yet
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
     assert trade.is_open is True
@@ -865,7 +866,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
 
     mocker.patch(f'{EXMS}.create_order', MagicMock(return_value=order))
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.all()[2]
+    trade = Trade.session.scalars(select(Trade)).all()[2]
     trade.is_short = is_short
     assert trade
     assert trade.open_order_id is None
@@ -883,7 +884,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     order['id'] = '555'
     mocker.patch(f'{EXMS}.create_order', MagicMock(return_value=order))
     assert freqtrade.execute_entry(pair, stake_amount)
-    trade = Trade.query.all()[3]
+    trade = Trade.session.scalars(select(Trade)).all()[3]
     trade.is_short = is_short
     assert trade
     assert trade.open_order_id is None
@@ -896,7 +897,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
 
     freqtrade.strategy.custom_stake_amount = lambda **kwargs: 150.0
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.all()[4]
+    trade = Trade.session.scalars(select(Trade)).all()[4]
     trade.is_short = is_short
     assert trade
     assert pytest.approx(trade.stake_amount) == 150
@@ -905,7 +906,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     order['id'] = '557'
     freqtrade.strategy.custom_stake_amount = lambda **kwargs: 20 / 0
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.all()[5]
+    trade = Trade.session.scalars(select(Trade)).all()[5]
     trade.is_short = is_short
     assert trade
     assert pytest.approx(trade.stake_amount) == 2.0
@@ -934,7 +935,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     order['id'] = '5566'
     freqtrade.strategy.custom_entry_price = lambda **kwargs: 0.508
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.all()[6]
+    trade = Trade.session.scalars(select(Trade)).all()[6]
     trade.is_short = is_short
     assert trade
     assert trade.open_rate_requested == 0.508
@@ -951,7 +952,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     )
 
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.all()[7]
+    trade = Trade.session.scalars(select(Trade)).all()[7]
     trade.is_short = is_short
     assert trade
     assert trade.open_rate_requested == 10
@@ -961,7 +962,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     order['id'] = '5568'
     freqtrade.strategy.custom_entry_price = lambda **kwargs: "string price"
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.all()[8]
+    trade = Trade.session.scalars(select(Trade)).all()[8]
     # Trade(id=9, pair=ETH/USDT, amount=0.20000000, is_short=False,
     #   leverage=1.0, open_rate=10.00000000, open_since=...)
     # Trade(id=9, pair=ETH/USDT, amount=0.60000000, is_short=True,
@@ -982,7 +983,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     freqtrade.exchange.get_max_pair_stake_amount = MagicMock(return_value=500)
 
     assert freqtrade.execute_entry(pair, 2000, is_short=is_short)
-    trade = Trade.query.all()[9]
+    trade = Trade.session.scalars(select(Trade)).all()[9]
     trade.is_short = is_short
     assert pytest.approx(trade.stake_amount) == 500
 
@@ -991,7 +992,7 @@ def test_execute_entry(mocker, default_conf_usdt, fee, limit_order,
     freqtrade.strategy.leverage.reset_mock()
     assert freqtrade.execute_entry(pair, 200, leverage_=3)
     assert freqtrade.strategy.leverage.call_count == 0
-    trade = Trade.query.all()[10]
+    trade = Trade.session.scalars(select(Trade)).all()[10]
     assert trade.leverage == 1 if trading_mode == 'spot' else 3
 
 
@@ -1053,7 +1054,7 @@ def test_execute_entry_min_leverage(mocker, default_conf_usdt, fee, limit_order,
     freqtrade.strategy.leverage = MagicMock(return_value=5.0)
 
     assert freqtrade.execute_entry(pair, stake_amount, is_short=is_short)
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade.leverage == 5.0
     # assert trade.stake_amount == 2
 
@@ -1158,7 +1159,7 @@ def test_handle_stoploss_on_exchange(mocker, default_conf_usdt, fee, caplog, is_
     # as a trade actually happened
     caplog.clear()
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
@@ -1271,7 +1272,7 @@ def test_handle_sle_cancel_cant_recreate(mocker, default_conf_usdt, fee, caplog,
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
@@ -1316,7 +1317,7 @@ def test_create_stoploss_order_invalid_order(
     freqtrade.strategy.order_types['stoploss_on_exchange'] = True
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     caplog.clear()
     freqtrade.create_stoploss_order(trade, 200)
@@ -1367,7 +1368,7 @@ def test_create_stoploss_order_insufficient_funds(
     freqtrade.strategy.order_types['stoploss_on_exchange'] = True
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     caplog.clear()
     freqtrade.create_stoploss_order(trade, 200)
@@ -1435,7 +1436,7 @@ def test_handle_stoploss_on_exchange_trailing(
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
@@ -1554,7 +1555,7 @@ def test_handle_stoploss_on_exchange_trailing_error(
     freqtrade.strategy.order_types['stoploss_on_exchange_interval'] = 60
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
@@ -1668,7 +1669,7 @@ def test_handle_stoploss_on_exchange_custom_stop(
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
@@ -1796,7 +1797,7 @@ def test_tsl_on_exchange_compatible_with_edge(mocker, edge_conf, fee, limit_orde
     freqtrade.active_pair_whitelist = freqtrade.edge.adjust(freqtrade.active_pair_whitelist)
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_open = True
     trade.open_order_id = None
     trade.stoploss_order_id = 100
@@ -2162,7 +2163,7 @@ def test_handle_trade(
 
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
 
@@ -2217,7 +2218,7 @@ def test_handle_overlapping_signals(
     freqtrade.enter_positions()
 
     # Buy and Sell triggering, so doing nothing ...
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
 
     nb_trades = len(trades)
     assert nb_trades == 0
@@ -2225,7 +2226,7 @@ def test_handle_overlapping_signals(
     # Buy is triggering, so buying ...
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
     freqtrade.enter_positions()
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     for trade in trades:
         trade.is_short = is_short
     nb_trades = len(trades)
@@ -2235,7 +2236,7 @@ def test_handle_overlapping_signals(
     # Buy and Sell are not triggering, so doing nothing ...
     patch_get_signal(freqtrade, enter_long=False)
     assert freqtrade.handle_trade(trades[0]) is False
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     for trade in trades:
         trade.is_short = is_short
     nb_trades = len(trades)
@@ -2248,7 +2249,7 @@ def test_handle_overlapping_signals(
     else:
         patch_get_signal(freqtrade, enter_long=True, exit_long=True)
     assert freqtrade.handle_trade(trades[0]) is False
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     for trade in trades:
         trade.is_short = is_short
     nb_trades = len(trades)
@@ -2260,7 +2261,7 @@ def test_handle_overlapping_signals(
         patch_get_signal(freqtrade, enter_long=False, exit_short=True)
     else:
         patch_get_signal(freqtrade, enter_long=False, exit_long=True)
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     for trade in trades:
         trade.is_short = is_short
     assert freqtrade.handle_trade(trades[0]) is True
@@ -2291,7 +2292,7 @@ def test_handle_trade_roi(default_conf_usdt, ticker_usdt, limit_order_open, fee,
 
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
 
@@ -2333,7 +2334,7 @@ def test_handle_trade_use_exit_signal(
     freqtrade.strategy.min_roi_reached = MagicMock(return_value=False)
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
 
@@ -2370,7 +2371,7 @@ def test_close_trade(
     # Create trade and sell it
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
 
@@ -2427,7 +2428,7 @@ def test_manage_open_orders_entry_usercustom(
     open_trade.is_short = is_short
     open_trade.orders[0].side = 'sell' if is_short else 'buy'
     open_trade.orders[0].ft_order_side = 'sell' if is_short else 'buy'
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     # Ensure default is to return empty (so not mocked yet)
@@ -2438,7 +2439,8 @@ def test_manage_open_orders_entry_usercustom(
     freqtrade.strategy.check_entry_timeout = MagicMock(return_value=False)
     freqtrade.manage_open_orders()
     assert cancel_order_mock.call_count == 0
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     nb_trades = len(trades)
     assert nb_trades == 1
     assert freqtrade.strategy.check_entry_timeout.call_count == 1
@@ -2446,7 +2448,8 @@ def test_manage_open_orders_entry_usercustom(
 
     freqtrade.manage_open_orders()
     assert cancel_order_mock.call_count == 0
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     nb_trades = len(trades)
     assert nb_trades == 1
     assert freqtrade.strategy.check_entry_timeout.call_count == 1
@@ -2456,7 +2459,8 @@ def test_manage_open_orders_entry_usercustom(
     freqtrade.manage_open_orders()
     assert cancel_order_wr_mock.call_count == 1
     assert rpc_mock.call_count == 2
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     nb_trades = len(trades)
     assert nb_trades == 0
     assert freqtrade.strategy.check_entry_timeout.call_count == 1
@@ -2486,7 +2490,7 @@ def test_manage_open_orders_entry(
     freqtrade = FreqtradeBot(default_conf_usdt)
 
     open_trade.is_short = is_short
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     freqtrade.strategy.check_entry_timeout = MagicMock(return_value=False)
@@ -2524,7 +2528,7 @@ def test_adjust_entry_cancel(
     )
 
     open_trade.is_short = is_short
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     # Timeout to not interfere
@@ -2535,7 +2539,7 @@ def test_adjust_entry_cancel(
     freqtrade.manage_open_orders()
     trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
     assert len(trades) == 0
-    assert len(Order.query.all()) == 0
+    assert len(Order.session.scalars(select(Order)).all()) == 0
     assert log_has_re(
         f"{'Sell' if is_short else 'Buy'} order user requested order cancel*", caplog)
     assert log_has_re(
@@ -2565,7 +2569,7 @@ def test_adjust_entry_maintain_replace(
     )
 
     open_trade.is_short = is_short
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     # Timeout to not interfere
@@ -2586,7 +2590,7 @@ def test_adjust_entry_maintain_replace(
     freqtrade.manage_open_orders()
     trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
     assert len(trades) == 1
-    nb_all_orders = len(Order.query.all())
+    nb_all_orders = len(Order.session.scalars(select(Order)).all())
     assert nb_all_orders == 2
     # New order seems to be in closed status?
     # nb_open_orders = len(Order.get_open_orders())
@@ -2618,7 +2622,7 @@ def test_check_handle_cancelled_buy(
     freqtrade = FreqtradeBot(default_conf_usdt)
     open_trade.orders = []
     open_trade.is_short = is_short
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     # check it does cancel buy orders over the time limit
@@ -2649,7 +2653,7 @@ def test_manage_open_orders_buy_exception(
     freqtrade = FreqtradeBot(default_conf_usdt)
 
     open_trade.is_short = is_short
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     # check it does cancel buy orders over the time limit
@@ -2691,7 +2695,7 @@ def test_manage_open_orders_exit_usercustom(
     open_trade_usdt.close_date = arrow.utcnow().shift(minutes=-601).datetime
     open_trade_usdt.close_profit_abs = 0.001
 
-    Trade.query.session.add(open_trade_usdt)
+    Trade.session.add(open_trade_usdt)
     Trade.commit()
     # Ensure default is false
     freqtrade.manage_open_orders()
@@ -2771,7 +2775,7 @@ def test_manage_open_orders_exit(
     open_trade_usdt.close_profit_abs = 0.001
     open_trade_usdt.is_short = is_short
 
-    Trade.query.session.add(open_trade_usdt)
+    Trade.session.add(open_trade_usdt)
     Trade.commit()
 
     freqtrade.strategy.check_exit_timeout = MagicMock(return_value=False)
@@ -2811,7 +2815,7 @@ def test_check_handle_cancelled_exit(
     open_trade_usdt.close_date = arrow.utcnow().shift(minutes=-601).datetime
     open_trade_usdt.is_short = is_short
 
-    Trade.query.session.add(open_trade_usdt)
+    Trade.session.add(open_trade_usdt)
     Trade.commit()
 
     # check it does cancel sell orders over the time limit
@@ -2848,7 +2852,7 @@ def test_manage_open_orders_partial(
     )
     freqtrade = FreqtradeBot(default_conf_usdt)
     prior_stake = open_trade.stake_amount
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
 
     # check it does cancel buy orders over the time limit
@@ -2893,7 +2897,7 @@ def test_manage_open_orders_partial_fee(
 
     open_trade.fee_open = fee()
     open_trade.fee_close = fee()
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
     # cancelling a half-filled order should update the amount to the bought amount
     # and apply fees if necessary.
@@ -2943,7 +2947,7 @@ def test_manage_open_orders_partial_except(
 
     open_trade.fee_open = fee()
     open_trade.fee_close = fee()
-    Trade.query.session.add(open_trade)
+    Trade.session.add(open_trade)
     Trade.commit()
     # cancelling a half-filled order should update the amount to the bought amount
     # and apply fees if necessary.
@@ -2982,7 +2986,7 @@ def test_manage_open_orders_exception(default_conf_usdt, ticker_usdt, open_trade
     )
     freqtrade = FreqtradeBot(default_conf_usdt)
 
-    Trade.query.session.add(open_trade_usdt)
+    Trade.session.add(open_trade_usdt)
     Trade.commit()
 
     caplog.clear()
@@ -3011,7 +3015,7 @@ def test_handle_cancel_enter(mocker, caplog, default_conf_usdt, limit_order, is_
     freqtrade._notify_enter_cancel = MagicMock()
 
     trade = mock_trade_usdt_4(fee, is_short)
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
 
     l_order['filled'] = 0.0
@@ -3061,7 +3065,7 @@ def test_handle_cancel_enter_exchanges(mocker, caplog, default_conf_usdt, is_sho
     reason = CANCEL_REASON['TIMEOUT']
 
     trade = mock_trade_usdt_4(fee, is_short)
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
     assert freqtrade.handle_cancel_enter(trade, limit_buy_order_canceled_empty, reason)
     assert cancel_order_mock.call_count == 0
@@ -3095,7 +3099,7 @@ def test_handle_cancel_enter_corder_empty(mocker, default_conf_usdt, limit_order
     freqtrade = FreqtradeBot(default_conf_usdt)
     freqtrade._notify_enter_cancel = MagicMock()
     trade = mock_trade_usdt_4(fee, is_short)
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
     Trade.commit()
     l_order['filled'] = 0.0
     l_order['status'] = 'open'
@@ -3261,7 +3265,7 @@ def test_execute_trade_exit_up(default_conf_usdt, ticker_usdt, fee, ticker_usdt_
     freqtrade.enter_positions()
     rpc_mock.reset_mock()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade.is_short == is_short
     assert trade
     assert freqtrade.strategy.confirm_trade_exit.call_count == 0
@@ -3342,7 +3346,7 @@ def test_execute_trade_exit_down(default_conf_usdt, ticker_usdt, fee, ticker_usd
     # Create some test data
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
 
@@ -3415,7 +3419,7 @@ def test_execute_trade_exit_custom_exit_price(
     freqtrade.enter_positions()
     rpc_mock.reset_mock()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
     assert freqtrade.strategy.confirm_trade_exit.call_count == 0
@@ -3492,7 +3496,7 @@ def test_execute_trade_exit_down_stoploss_on_exchange_dry_run(
     # Create some test data
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade.is_short == is_short
     assert trade
 
@@ -3566,7 +3570,7 @@ def test_execute_trade_exit_sloe_cancel_exception(
     patch_get_signal(freqtrade)
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     PairLock.session = MagicMock()
 
     freqtrade.config['dry_run'] = False
@@ -3611,7 +3615,7 @@ def test_execute_trade_exit_with_stoploss_on_exchange(
     # Create some test data
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
     trades = [trade]
@@ -3631,7 +3635,7 @@ def test_execute_trade_exit_with_stoploss_on_exchange(
         exit_check=ExitCheckTuple(exit_type=ExitType.STOP_LOSS)
     )
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
     assert cancel_order.call_count == 1
@@ -3669,7 +3673,7 @@ def test_may_execute_trade_exit_after_stoploss_on_exchange_hit(
     # Create some test data
     freqtrade.enter_positions()
     freqtrade.manage_open_orders()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trades = [trade]
     assert trade.stoploss_order_id is None
 
@@ -3755,7 +3759,7 @@ def test_execute_trade_exit_market_order(
     # Create some test data
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
 
@@ -3830,7 +3834,7 @@ def test_execute_trade_exit_insufficient_funds_error(default_conf_usdt, ticker_u
     # Create some test data
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
 
@@ -3898,7 +3902,7 @@ def test_exit_profit_only(
             exit_type=ExitType.NONE))
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade.is_short == is_short
     oobj = Order.parse_from_ccxt_object(limit_order[eside], limit_order[eside]['symbol'], eside)
     trade.update_order(limit_order[eside])
@@ -3941,7 +3945,7 @@ def test_sell_not_enough_balance(default_conf_usdt, limit_order, limit_order_ope
 
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     amnt = trade.amount
 
     oobj = Order.parse_from_ccxt_object(limit_order['buy'], limit_order['buy']['symbol'], 'buy')
@@ -4009,7 +4013,7 @@ def test_locked_pairs(default_conf_usdt, ticker_usdt, fee,
     # Create some test data
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     assert trade
 
@@ -4064,7 +4068,7 @@ def test_ignore_roi_if_entry_signal(default_conf_usdt, limit_order, limit_order_
 
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     oobj = Order.parse_from_ccxt_object(
         limit_order[eside], limit_order[eside]['symbol'], eside)
@@ -4114,7 +4118,7 @@ def test_trailing_stop_loss(default_conf_usdt, limit_order_open,
     freqtrade.strategy.min_roi_reached = MagicMock(return_value=False)
 
     freqtrade.enter_positions()
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade.is_short == is_short
     assert freqtrade.handle_trade(trade) is False
 
@@ -4189,7 +4193,7 @@ def test_trailing_stop_loss_positive(
     freqtrade.strategy.min_roi_reached = MagicMock(return_value=False)
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade.is_short == is_short
     oobj = Order.parse_from_ccxt_object(limit_order[eside], limit_order[eside]['symbol'], eside)
     trade.update_order(limit_order[eside])
@@ -4286,7 +4290,7 @@ def test_disable_ignore_roi_if_entry_signal(default_conf_usdt, limit_order, limi
 
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
 
     oobj = Order.parse_from_ccxt_object(
@@ -4752,7 +4756,7 @@ def test_order_book_depth_of_market(
     patch_get_signal(freqtrade, enter_short=is_short, enter_long=not is_short)
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     if is_high_delta:
         assert trade is None
     else:
@@ -4763,7 +4767,7 @@ def test_order_book_depth_of_market(
         assert trade.open_date is not None
         assert trade.exchange == 'binance'
 
-        assert len(Trade.query.all()) == 1
+        assert len(Trade.session.scalars(select(Trade)).all()) == 1
 
         # Simulate fulfilled LIMIT_BUY order for trade
         oobj = Order.parse_from_ccxt_object(
@@ -4860,7 +4864,7 @@ def test_order_book_exit_pricing(
 
     freqtrade.enter_positions()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
 
     time.sleep(0.01)  # Race condition fix
@@ -4932,7 +4936,7 @@ def test_sync_wallet_dry_run(mocker, default_conf_usdt, ticker_usdt, fee, limit_
 
     n = bot.enter_positions()
     assert n == 2
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     assert len(trades) == 2
 
     bot.config['max_open_trades'] = 3
@@ -4965,7 +4969,7 @@ def test_cancel_all_open_orders(mocker, default_conf_usdt, fee, limit_order, lim
 
     freqtrade = get_patched_freqtradebot(mocker, default_conf_usdt)
     create_mock_trades(fee, is_short=is_short)
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     assert len(trades) == MOCK_TRADE_COUNT
     freqtrade.cancel_all_open_orders()
     assert buy_mock.call_count == buy_calls
@@ -4981,7 +4985,7 @@ def test_check_for_open_trades(mocker, default_conf_usdt, fee, is_short):
     assert freqtrade.rpc.send_msg.call_count == 0
 
     create_mock_trades(fee, is_short)
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     trade.is_short = is_short
     trade.is_open = True
 
@@ -5149,7 +5153,7 @@ def test_reupdate_enter_order_fees(mocker, default_conf_usdt, fee, caplog, is_sh
         exchange='binance',
         is_short=is_short
     )
-    Trade.query.session.add(trade)
+    Trade.session.add(trade)
 
     freqtrade.handle_insufficient_funds(trade)
     # assert log_has_re(r"Trying to reupdate buy fees for .*", caplog)
@@ -5546,10 +5550,10 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     assert freqtrade.execute_entry(pair, stake_amount)
     # Should create an closed trade with an no open order id
     # Order is filled and trade is open
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 1
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.is_open is True
     assert trade.open_order_id is None
@@ -5559,7 +5563,7 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     # Assume it does nothing since order is closed and trade is open
     freqtrade.update_trades_without_assigned_fees()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.is_open is True
     assert trade.open_order_id is None
@@ -5569,7 +5573,7 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
 
     freqtrade.manage_open_orders()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.is_open is True
     assert trade.open_order_id is None
@@ -5595,10 +5599,10 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     mocker.patch(f'{EXMS}.fetch_order_or_stoploss_order', MagicMock(return_value=open_dca_order_1))
     assert freqtrade.execute_entry(pair, stake_amount, trade=trade)
 
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 2
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id == '651'
     assert trade.open_rate == 11
@@ -5628,14 +5632,14 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     mocker.patch(f'{EXMS}.fetch_order_or_stoploss_order', fetch_order_mm)
     freqtrade.update_trades_without_assigned_fees()
 
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 2
     # Assert that the trade is found as open and without fees
     trades: List[Trade] = Trade.get_open_trades_without_assigned_fees()
     assert len(trades) == 1
     # Assert trade is as expected
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id == '651'
     assert trade.open_rate == 11
@@ -5672,14 +5676,14 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     freqtrade.manage_open_orders()
 
     # Assert trade is as expected (averaged dca)
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
     assert pytest.approx(trade.open_rate) == 9.90909090909
     assert trade.amount == 22
     assert pytest.approx(trade.stake_amount) == 218
 
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 2
 
@@ -5714,14 +5718,14 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     assert freqtrade.execute_entry(pair, stake_amount, trade=trade)
 
     # Assert trade is as expected (averaged dca)
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
     assert pytest.approx(trade.open_rate) == 8.729729729729
     assert trade.amount == 37
     assert trade.stake_amount == 323
 
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 3
 
@@ -5752,7 +5756,7 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
                                         sub_trade_amt=15)
 
     # Assert trade is as expected (averaged dca)
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
     assert trade.is_open
@@ -5760,7 +5764,7 @@ def test_position_adjust(mocker, default_conf_usdt, fee) -> None:
     assert trade.stake_amount == 192.05405405405406
     assert pytest.approx(trade.open_rate) == 8.729729729729
 
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 4
 
@@ -5825,10 +5829,10 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
     assert freqtrade.execute_entry(pair, amount)
     # Should create an closed trade with an no open order id
     # Order is filled and trade is open
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 1
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.is_open is True
     assert trade.open_order_id is None
@@ -5838,7 +5842,7 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
     # Assume it does nothing since order is closed and trade is open
     freqtrade.update_trades_without_assigned_fees()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.is_open is True
     assert trade.open_order_id is None
@@ -5848,7 +5852,7 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
 
     freqtrade.manage_open_orders()
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.is_open is True
     assert trade.open_order_id is None
@@ -5884,7 +5888,7 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
     assert len(trades) == 1
     # Assert trade is as expected (averaged dca)
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
     assert trade.amount == 50
@@ -5893,7 +5897,7 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
     assert pytest.approx(trade.realized_profit) == -152.375
     assert pytest.approx(trade.close_profit_abs) == -152.375
 
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 2
     # Make sure the closed order is found as the second order.
@@ -5926,7 +5930,7 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
                                         sub_trade_amt=amount)
     # Assert trade is as expected (averaged dca)
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
     assert trade.amount == 50
@@ -5935,7 +5939,7 @@ def test_position_adjust2(mocker, default_conf_usdt, fee) -> None:
     # Trade fully realized
     assert pytest.approx(trade.realized_profit) == 94.25
     assert pytest.approx(trade.close_profit_abs) == 94.25
-    orders = Order.query.all()
+    orders = Order.session.scalars(select(Order)).all()
     assert orders
     assert len(orders) == 3
 
@@ -6020,11 +6024,11 @@ def test_position_adjust3(mocker, default_conf_usdt, fee, data) -> None:
                 exit_check=ExitCheckTuple(exit_type=ExitType.PARTIAL_EXIT),
                 sub_trade_amt=amount)
 
-        orders1 = Order.query.all()
+        orders1 = Order.session.scalars(select(Order)).all()
         assert orders1
         assert len(orders1) == idx + 1
 
-        trade = Trade.query.first()
+        trade = Trade.session.scalars(select(Trade)).first()
         assert trade
         if idx < len(data) - 1:
             assert trade.is_open is True
@@ -6039,7 +6043,7 @@ def test_position_adjust3(mocker, default_conf_usdt, fee, data) -> None:
         order_obj = trade.select_order(order[0], False)
         assert order_obj.order_id == f'60{idx}'
 
-    trade = Trade.query.first()
+    trade = Trade.session.scalars(select(Trade)).first()
     assert trade
     assert trade.open_order_id is None
     assert trade.is_open is False
diff --git a/tests/test_integration.py b/tests/test_integration.py
index 4c57c5669..922285309 100644
--- a/tests/test_integration.py
+++ b/tests/test_integration.py
@@ -1,6 +1,7 @@
 from unittest.mock import MagicMock
 
 import pytest
+from sqlalchemy import select
 
 from freqtrade.enums import ExitCheckTuple, ExitType, TradingMode
 from freqtrade.persistence import Trade
@@ -91,7 +92,7 @@ def test_may_execute_exit_stoploss_on_exchange_multi(default_conf, ticker, fee,
     assert freqtrade.strategy.confirm_trade_exit.call_count == 0
     wallets_mock.reset_mock()
 
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     # Make sure stoploss-order is open and trade is bought (since we mock update_trade_state)
     for trade in trades:
         stoploss_order_closed['id'] = '3'
@@ -179,13 +180,13 @@ def test_forcebuy_last_unlimited(default_conf, ticker, fee, mocker, balance_rati
     n = freqtrade.enter_positions()
     assert n == 4
 
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     assert len(trades) == 4
     assert freqtrade.wallets.get_trade_stake_amount('XRP/BTC') == result1
 
     rpc._rpc_force_entry('TKN/BTC', None)
 
-    trades = Trade.query.all()
+    trades = Trade.session.scalars(select(Trade)).all()
     assert len(trades) == 5
 
     for trade in trades:

From 4cfbc55d3418d05449a439d754976fd001f900c4 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 18:07:06 +0100
Subject: [PATCH 044/147] Update remaining tests to get rid of .query

---
 tests/persistence/test_migrations.py  |  4 ++--
 tests/persistence/test_persistence.py |  1 +
 tests/plugins/test_pairlist.py        |  4 ++--
 tests/plugins/test_pairlocks.py       |  4 ++--
 tests/test_freqtradebot.py            | 27 ++++++++++++++++++---------
 5 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/tests/persistence/test_migrations.py b/tests/persistence/test_migrations.py
index 053d6da12..854d39994 100644
--- a/tests/persistence/test_migrations.py
+++ b/tests/persistence/test_migrations.py
@@ -406,8 +406,8 @@ def test_migrate_pairlocks(mocker, default_conf, fee, caplog):
     init_db(default_conf['db_url'])
 
     assert len(PairLock.get_all_locks().all()) == 2
-    assert len(PairLock.query.filter(PairLock.pair == '*').all()) == 1
-    pairlocks = PairLock.query.filter(PairLock.pair == 'ETH/BTC').all()
+    assert len(PairLock.session.scalars(select(PairLock).filter(PairLock.pair == '*')).all()) == 1
+    pairlocks = PairLock.session.scalars(select(PairLock).filter(PairLock.pair == 'ETH/BTC')).all()
     assert len(pairlocks) == 1
     pairlocks[0].pair == 'ETH/BTC'
     pairlocks[0].side == '*'
diff --git a/tests/persistence/test_persistence.py b/tests/persistence/test_persistence.py
index 78e97e2e6..db882d56d 100644
--- a/tests/persistence/test_persistence.py
+++ b/tests/persistence/test_persistence.py
@@ -2017,6 +2017,7 @@ def test_Trade_object_idem():
         'get_open_trades_without_assigned_fees',
         'get_open_order_trades',
         'get_trades',
+        'get_trades_query',
         'get_exit_reason_performance',
         'get_enter_tag_performance',
         'get_mix_tag_performance',
diff --git a/tests/plugins/test_pairlist.py b/tests/plugins/test_pairlist.py
index 18ee365e2..bc8fe84f1 100644
--- a/tests/plugins/test_pairlist.py
+++ b/tests/plugins/test_pairlist.py
@@ -711,8 +711,8 @@ def test_PrecisionFilter_error(mocker, whitelist_conf) -> None:
 
 def test_PerformanceFilter_error(mocker, whitelist_conf, caplog) -> None:
     whitelist_conf['pairlists'] = [{"method": "StaticPairList"}, {"method": "PerformanceFilter"}]
-    if hasattr(Trade, 'query'):
-        del Trade.query
+    if hasattr(Trade, 'session'):
+        del Trade.session
     mocker.patch(f'{EXMS}.exchange_has', MagicMock(return_value=True))
     exchange = get_patched_exchange(mocker, whitelist_conf)
     pm = PairListManager(exchange, whitelist_conf, MagicMock())
diff --git a/tests/plugins/test_pairlocks.py b/tests/plugins/test_pairlocks.py
index 39bde3cda..6b7112f98 100644
--- a/tests/plugins/test_pairlocks.py
+++ b/tests/plugins/test_pairlocks.py
@@ -107,7 +107,7 @@ def test_PairLocks_getlongestlock(use_db):
     # No lock should be present
     PairLocks.use_db = use_db
     if use_db:
-        assert len(PairLock.query.all()) == 0
+        assert len(PairLock.get_all_locks().all()) == 0
 
     assert PairLocks.use_db == use_db
 
@@ -139,7 +139,7 @@ def test_PairLocks_reason(use_db):
     PairLocks.use_db = use_db
     # No lock should be present
     if use_db:
-        assert len(PairLock.query.all()) == 0
+        assert len(PairLock.get_all_locks().all()) == 0
 
     assert PairLocks.use_db == use_db
 
diff --git a/tests/test_freqtradebot.py b/tests/test_freqtradebot.py
index 49d00a860..cea70ec48 100644
--- a/tests/test_freqtradebot.py
+++ b/tests/test_freqtradebot.py
@@ -2499,7 +2499,8 @@ def test_manage_open_orders_entry(
     freqtrade.manage_open_orders()
     assert cancel_order_mock.call_count == 1
     assert rpc_mock.call_count == 2
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     nb_trades = len(trades)
     assert nb_trades == 0
     # Custom user buy-timeout is never called
@@ -2537,7 +2538,8 @@ def test_adjust_entry_cancel(
     # check that order is cancelled
     freqtrade.strategy.adjust_entry_price = MagicMock(return_value=None)
     freqtrade.manage_open_orders()
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 0
     assert len(Order.session.scalars(select(Order)).all()) == 0
     assert log_has_re(
@@ -2578,7 +2580,8 @@ def test_adjust_entry_maintain_replace(
     # Check that order is maintained
     freqtrade.strategy.adjust_entry_price = MagicMock(return_value=old_order['price'])
     freqtrade.manage_open_orders()
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 1
     assert len(Order.get_open_orders()) == 1
     # Entry adjustment is called
@@ -2588,7 +2591,8 @@ def test_adjust_entry_maintain_replace(
     freqtrade.get_valid_enter_price_and_stake = MagicMock(return_value={100, 10, 1})
     freqtrade.strategy.adjust_entry_price = MagicMock(return_value=1234)
     freqtrade.manage_open_orders()
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 1
     nb_all_orders = len(Order.session.scalars(select(Order)).all())
     assert nb_all_orders == 2
@@ -2629,7 +2633,8 @@ def test_check_handle_cancelled_buy(
     freqtrade.manage_open_orders()
     assert cancel_order_mock.call_count == 0
     assert rpc_mock.call_count == 2
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 0
     assert log_has_re(
         f"{'Sell' if is_short else 'Buy'} order cancelled on exchange for Trade.*", caplog)
@@ -2660,7 +2665,8 @@ def test_manage_open_orders_buy_exception(
     freqtrade.manage_open_orders()
     assert cancel_order_mock.call_count == 0
     assert rpc_mock.call_count == 1
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     nb_trades = len(trades)
     assert nb_trades == 1
 
@@ -2860,7 +2866,8 @@ def test_manage_open_orders_partial(
     freqtrade.manage_open_orders()
     assert cancel_order_mock.call_count == 1
     assert rpc_mock.call_count == 3
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 1
     assert trades[0].amount == 23.0
     assert trades[0].stake_amount == open_trade.open_rate * trades[0].amount / leverage
@@ -2907,7 +2914,8 @@ def test_manage_open_orders_partial_fee(
 
     assert cancel_order_mock.call_count == 1
     assert rpc_mock.call_count == 3
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 1
     # Verify that trade has been updated
     assert trades[0].amount == (limit_buy_order_old_partial['amount'] -
@@ -2957,7 +2965,8 @@ def test_manage_open_orders_partial_except(
 
     assert cancel_order_mock.call_count == 1
     assert rpc_mock.call_count == 3
-    trades = Trade.query.filter(Trade.open_order_id.is_(open_trade.open_order_id)).all()
+    trades = Trade.session.scalars(
+        select(Trade).filter(Trade.open_order_id.is_(open_trade.open_order_id))).all()
     assert len(trades) == 1
     # Verify that trade has been updated
 

From b7709126f9430a87bfcd515f4f37b6fa11e4f17c Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 18:07:22 +0100
Subject: [PATCH 045/147] remove .query completely

---
 freqtrade/commands/db_commands.py    | 8 ++++----
 freqtrade/persistence/models.py      | 3 ---
 freqtrade/persistence/pairlock.py    | 3 +--
 freqtrade/persistence/trade_model.py | 4 +---
 4 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/freqtrade/commands/db_commands.py b/freqtrade/commands/db_commands.py
index c819ca243..d83605c6f 100644
--- a/freqtrade/commands/db_commands.py
+++ b/freqtrade/commands/db_commands.py
@@ -1,7 +1,7 @@
 import logging
 from typing import Any, Dict
 
-from sqlalchemy import func
+from sqlalchemy import func, select
 
 from freqtrade.configuration.config_setup import setup_utils_configuration
 from freqtrade.enums import RunMode
@@ -43,9 +43,9 @@ def start_convert_db(args: Dict[str, Any]) -> None:
     session_target.commit()
 
     # Update sequences
-    max_trade_id = session_target.query(func.max(Trade.id)).scalar()
-    max_order_id = session_target.query(func.max(Order.id)).scalar()
-    max_pairlock_id = session_target.query(func.max(PairLock.id)).scalar()
+    max_trade_id = session_target.scalar(select(func.max(Trade.id)))
+    max_order_id = session_target.scalar(select(func.max(Order.id)))
+    max_pairlock_id = session_target.scalar(select(func.max(PairLock.id)))
 
     set_sequence_ids(session_target.get_bind(),
                      trade_id=max_trade_id,
diff --git a/freqtrade/persistence/models.py b/freqtrade/persistence/models.py
index f4058b4eb..eee07e61c 100644
--- a/freqtrade/persistence/models.py
+++ b/freqtrade/persistence/models.py
@@ -57,9 +57,6 @@ def init_db(db_url: str) -> None:
     Trade.session = scoped_session(sessionmaker(bind=engine, autoflush=False))
     Order.session = Trade.session
     PairLock.session = Trade.session
-    Trade.query = Trade.session.query_property()
-    Order.query = Trade.session.query_property()
-    PairLock.query = Trade.session.query_property()
 
     previous_tables = inspect(engine).get_table_names()
     ModelBase.metadata.create_all(engine)
diff --git a/freqtrade/persistence/pairlock.py b/freqtrade/persistence/pairlock.py
index e787b5fa0..1b254c2b2 100644
--- a/freqtrade/persistence/pairlock.py
+++ b/freqtrade/persistence/pairlock.py
@@ -2,7 +2,7 @@ from datetime import datetime, timezone
 from typing import Any, ClassVar, Dict, Optional
 
 from sqlalchemy import ScalarResult, String, or_, select
-from sqlalchemy.orm import Mapped, QueryPropertyDescriptor, mapped_column
+from sqlalchemy.orm import Mapped, mapped_column
 
 from freqtrade.constants import DATETIME_PRINT_FORMAT
 from freqtrade.persistence.base import ModelBase, SessionType
@@ -13,7 +13,6 @@ class PairLock(ModelBase):
     Pair Locks database model.
     """
     __tablename__ = 'pairlocks'
-    query: ClassVar[QueryPropertyDescriptor]
     session: ClassVar[SessionType]
 
     id: Mapped[int] = mapped_column(primary_key=True)
diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 892707810..27be0d726 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -9,7 +9,7 @@ from typing import Any, ClassVar, Dict, List, Optional, Sequence, cast
 
 from sqlalchemy import (Enum, Float, ForeignKey, Integer, ScalarResult, Select, String,
                         UniqueConstraint, desc, func, select)
-from sqlalchemy.orm import Mapped, QueryPropertyDescriptor, lazyload, mapped_column, relationship
+from sqlalchemy.orm import Mapped, lazyload, mapped_column, relationship
 
 from freqtrade.constants import (DATETIME_PRINT_FORMAT, MATH_CLOSE_PREC, NON_OPEN_EXCHANGE_STATES,
                                  BuySell, LongShort)
@@ -36,7 +36,6 @@ class Order(ModelBase):
     Mirrors CCXT Order structure
     """
     __tablename__ = 'orders'
-    query: ClassVar[QueryPropertyDescriptor]
     session: ClassVar[SessionType]
 
     # Uniqueness should be ensured over pair, order_id
@@ -1188,7 +1187,6 @@ class Trade(ModelBase, LocalTrade):
     Note: Fields must be aligned with LocalTrade class
     """
     __tablename__ = 'trades'
-    query: ClassVar[QueryPropertyDescriptor]
     session: ClassVar[SessionType]
 
     use_db: bool = True

From e3e4fbd5ba397558bdd90f985759583e71026f61 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 19:24:37 +0100
Subject: [PATCH 046/147] Minor test fix

---
 tests/rpc/test_rpc_telegram.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tests/rpc/test_rpc_telegram.py b/tests/rpc/test_rpc_telegram.py
index 1dc255b3e..59b6df489 100644
--- a/tests/rpc/test_rpc_telegram.py
+++ b/tests/rpc/test_rpc_telegram.py
@@ -302,8 +302,7 @@ def test_telegram_status_closed_trade(default_conf, update, mocker, fee) -> None
     telegram, _, msg_mock = get_telegram_testobject(mocker, default_conf)
 
     create_mock_trades(fee)
-    trades = Trade.get_trades([Trade.is_open.is_(False)])
-    trade = trades[0]
+    trade = Trade.get_trades([Trade.is_open.is_(False)]).first()
     context = MagicMock()
     context.args = [str(trade.id)]
     telegram._status(update=update, context=context)

From 774eacc561915ff5fdb78d1552089158766a13eb Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 14 Mar 2023 20:27:14 +0100
Subject: [PATCH 047/147] Attempt push to ghcr.io

---
 .github/workflows/ci.yml              | 14 +++++++++++---
 build_helpers/publish_docker_arm64.sh | 14 ++++++++++++++
 2 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7e0483c3d..a1fa487a5 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -16,7 +16,8 @@ on:
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
-
+permissions:
+  repository-projects: read
 jobs:
   build_linux:
 
@@ -321,7 +322,6 @@ jobs:
   build_linux_online:
     # Run pytest with "live" checks
     runs-on: ubuntu-22.04
-    # permissions:
     steps:
     - uses: actions/checkout@v3
 
@@ -472,6 +472,8 @@ jobs:
         build_helpers/publish_docker_multi.sh
 
   deploy_arm:
+    permissions:
+      packages: write
     needs: [ deploy ]
     # Only run on 64bit machines
     runs-on: [self-hosted, linux, ARM64]
@@ -492,9 +494,15 @@ jobs:
       run: |
         echo "${DOCKER_PASSWORD}" | docker login --username ${DOCKER_USERNAME} --password-stdin
 
+    - name: GHCR.io login
+      env:
+        GHCR_USERNAME: ${{ github.actor }}
+        GHCR_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        echo "${GHCR_PASSWORD}" | docker login ghcr.io --username ${GHCR_USERNAME} --password-stdin
+
     - name: Build and test and push docker images
       env:
-        IMAGE_NAME: freqtradeorg/freqtrade
         BRANCH_NAME: ${{ steps.extract_branch.outputs.branch }}
       run: |
         build_helpers/publish_docker_arm64.sh
diff --git a/build_helpers/publish_docker_arm64.sh b/build_helpers/publish_docker_arm64.sh
index f3cedff2e..c362ee825 100755
--- a/build_helpers/publish_docker_arm64.sh
+++ b/build_helpers/publish_docker_arm64.sh
@@ -3,6 +3,8 @@
 # Use BuildKit, otherwise building on ARM fails
 export DOCKER_BUILDKIT=1
 
+IMAGE_NAME=freqtradeorg/freqtrade
+GHCR_IMAGE_NAME=ghcr.io/freqtrade/freqtrade
 # Replace / with _ to create a valid tag
 TAG=$(echo "${BRANCH_NAME}" | sed -e "s/\//_/g")
 TAG_PLOT=${TAG}_plot
@@ -82,6 +84,18 @@ docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI}
 docker manifest create ${IMAGE_NAME}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL_ARM}
 docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI_RL}
 
+# Retag images for GHCR
+docker tag ${IMAGE_NAME}:${TAG} ${GHCR_IMAGE_NAME}:${TAG}
+docker tag ${IMAGE_NAME}:${TAG_PLOT} ${GHCR_IMAGE_NAME}:${TAG_PLOT}
+docker tag ${IMAGE_NAME}:${TAG_FREQAI} ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
+docker tag ${IMAGE_NAME}:${TAG_FREQAI_RL} ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
+
+# Push GHCR iamges
+docker push ${GHCR_IMAGE_NAME}:${TAG}
+docker push ${GHCR_IMAGE_NAME}:${TAG_PLOT}
+docker push ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
+docker push ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
+
 # Tag as latest for develop builds
 if [ "${TAG}" = "develop" ]; then
     echo 'Tagging image as latest'

From db0f449d93d5b79b0b3d5230f8a56ba145d19256 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 06:46:31 +0100
Subject: [PATCH 048/147] Use docker manifest for GHCR builds

---
 build_helpers/publish_docker_arm64.sh | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/build_helpers/publish_docker_arm64.sh b/build_helpers/publish_docker_arm64.sh
index c362ee825..e29cd695d 100755
--- a/build_helpers/publish_docker_arm64.sh
+++ b/build_helpers/publish_docker_arm64.sh
@@ -84,23 +84,27 @@ docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI}
 docker manifest create ${IMAGE_NAME}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL_ARM}
 docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI_RL}
 
-# Retag images for GHCR
-docker tag ${IMAGE_NAME}:${TAG} ${GHCR_IMAGE_NAME}:${TAG}
-docker tag ${IMAGE_NAME}:${TAG_PLOT} ${GHCR_IMAGE_NAME}:${TAG_PLOT}
-docker tag ${IMAGE_NAME}:${TAG_FREQAI} ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
-docker tag ${IMAGE_NAME}:${TAG_FREQAI_RL} ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
+# Recreate multiarch images for GHCR
+docker manifest create ${GHCR_IMAGE_NAME}:${TAG} ${CACHE_IMAGE}:${TAG} ${CACHE_IMAGE}:${TAG_ARM} ${IMAGE_NAME}:${TAG_PI}
+docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG}
 
-# Push GHCR iamges
-docker push ${GHCR_IMAGE_NAME}:${TAG}
-docker push ${GHCR_IMAGE_NAME}:${TAG_PLOT}
-docker push ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
-docker push ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
+docker manifest create ${GHCR_IMAGE_NAME}:${TAG_PLOT} ${CACHE_IMAGE}:${TAG_PLOT} ${CACHE_IMAGE}:${TAG_PLOT_ARM}
+docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG_PLOT}
+
+docker manifest create ${GHCR_IMAGE_NAME}:${TAG_FREQAI} ${CACHE_IMAGE}:${TAG_FREQAI} ${CACHE_IMAGE}:${TAG_FREQAI_ARM}
+docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
+
+docker manifest create ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL_ARM}
+docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
 
 # Tag as latest for develop builds
 if [ "${TAG}" = "develop" ]; then
     echo 'Tagging image as latest'
     docker manifest create ${IMAGE_NAME}:latest ${CACHE_IMAGE}:${TAG_ARM} ${IMAGE_NAME}:${TAG_PI} ${CACHE_IMAGE}:${TAG}
     docker manifest push -p ${IMAGE_NAME}:latest
+
+    docker manifest create ${GHCR_IMAGE_NAME}:latest ${CACHE_IMAGE}:${TAG_ARM} ${IMAGE_NAME}:${TAG_PI} ${CACHE_IMAGE}:${TAG}
+    docker manifest push -p ${GHCR_IMAGE_NAME}:latest
 fi
 
 docker images

From 0d3de0701256b351d66b53a4001b2fae4d69ab7f Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 19:06:08 +0100
Subject: [PATCH 049/147] use Crane to move images around

---
 .github/workflows/ci.yml              | 15 ++++++++-------
 build_helpers/publish_docker_arm64.sh | 27 ++++++++++++---------------
 build_helpers/publish_docker_multi.sh |  3 ++-
 3 files changed, 22 insertions(+), 23 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a1fa487a5..f09e5feac 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -466,7 +466,6 @@ jobs:
 
     - name: Build and test and push docker images
       env:
-        IMAGE_NAME: freqtradeorg/freqtrade
         BRANCH_NAME: ${{ steps.extract_branch.outputs.branch }}
       run: |
         build_helpers/publish_docker_multi.sh
@@ -494,16 +493,18 @@ jobs:
       run: |
         echo "${DOCKER_PASSWORD}" | docker login --username ${DOCKER_USERNAME} --password-stdin
 
-    - name: GHCR.io login
-      env:
-        GHCR_USERNAME: ${{ github.actor }}
-        GHCR_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
-      run: |
-        echo "${GHCR_PASSWORD}" | docker login ghcr.io --username ${GHCR_USERNAME} --password-stdin
+    # - name: GHCR.io login
+    #   env:
+    #     GHCR_USERNAME: ${{ github.actor }}
+    #     GHCR_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+    #   run: |
+        # echo "${GHCR_PASSWORD}" | docker login ghcr.io --username ${GHCR_USERNAME} --password-stdin
 
     - name: Build and test and push docker images
       env:
         BRANCH_NAME: ${{ steps.extract_branch.outputs.branch }}
+        GHCR_USERNAME: ${{ github.actor }}
+        GHCR_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
         build_helpers/publish_docker_arm64.sh
 
diff --git a/build_helpers/publish_docker_arm64.sh b/build_helpers/publish_docker_arm64.sh
index e29cd695d..3de113d37 100755
--- a/build_helpers/publish_docker_arm64.sh
+++ b/build_helpers/publish_docker_arm64.sh
@@ -4,7 +4,9 @@
 export DOCKER_BUILDKIT=1
 
 IMAGE_NAME=freqtradeorg/freqtrade
+CACHE_IMAGE=freqtradeorg/freqtrade_cache
 GHCR_IMAGE_NAME=ghcr.io/freqtrade/freqtrade
+
 # Replace / with _ to create a valid tag
 TAG=$(echo "${BRANCH_NAME}" | sed -e "s/\//_/g")
 TAG_PLOT=${TAG}_plot
@@ -16,7 +18,6 @@ TAG_ARM=${TAG}_arm
 TAG_PLOT_ARM=${TAG_PLOT}_arm
 TAG_FREQAI_ARM=${TAG_FREQAI}_arm
 TAG_FREQAI_RL_ARM=${TAG_FREQAI_RL}_arm
-CACHE_IMAGE=freqtradeorg/freqtrade_cache
 
 echo "Running for ${TAG}"
 
@@ -40,13 +41,13 @@ if [ $? -ne 0 ]; then
     echo "failed building multiarch images"
     return 1
 fi
-# Tag image for upload and next build step
-docker tag freqtrade:$TAG_ARM ${CACHE_IMAGE}:$TAG_ARM
 
 docker build --cache-from freqtrade:${TAG_ARM} --build-arg sourceimage=${CACHE_IMAGE} --build-arg sourcetag=${TAG_ARM} -t freqtrade:${TAG_PLOT_ARM} -f docker/Dockerfile.plot .
 docker build --cache-from freqtrade:${TAG_ARM} --build-arg sourceimage=${CACHE_IMAGE} --build-arg sourcetag=${TAG_ARM} -t freqtrade:${TAG_FREQAI_ARM} -f docker/Dockerfile.freqai .
 docker build --cache-from freqtrade:${TAG_ARM} --build-arg sourceimage=${CACHE_IMAGE} --build-arg sourcetag=${TAG_ARM} -t freqtrade:${TAG_FREQAI_RL_ARM} -f docker/Dockerfile.freqai_rl .
 
+# Tag image for upload and next build step
+docker tag freqtrade:$TAG_ARM ${CACHE_IMAGE}:$TAG_ARM
 docker tag freqtrade:$TAG_PLOT_ARM ${CACHE_IMAGE}:$TAG_PLOT_ARM
 docker tag freqtrade:$TAG_FREQAI_ARM ${CACHE_IMAGE}:$TAG_FREQAI_ARM
 docker tag freqtrade:$TAG_FREQAI_RL_ARM ${CACHE_IMAGE}:$TAG_FREQAI_RL_ARM
@@ -61,7 +62,6 @@ fi
 
 docker images
 
-# docker push ${IMAGE_NAME}
 docker push ${CACHE_IMAGE}:$TAG_PLOT_ARM
 docker push ${CACHE_IMAGE}:$TAG_FREQAI_ARM
 docker push ${CACHE_IMAGE}:$TAG_FREQAI_RL_ARM
@@ -84,18 +84,16 @@ docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI}
 docker manifest create ${IMAGE_NAME}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL_ARM}
 docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI_RL}
 
-# Recreate multiarch images for GHCR
-docker manifest create ${GHCR_IMAGE_NAME}:${TAG} ${CACHE_IMAGE}:${TAG} ${CACHE_IMAGE}:${TAG_ARM} ${IMAGE_NAME}:${TAG_PI}
-docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG}
+# copy images to ghcr.io
 
-docker manifest create ${GHCR_IMAGE_NAME}:${TAG_PLOT} ${CACHE_IMAGE}:${TAG_PLOT} ${CACHE_IMAGE}:${TAG_PLOT_ARM}
-docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG_PLOT}
+alias crane="docker run --rm -v $(pwd)/crane:/home/nonroot/.docker/ gcr.io/go-containerregistry/crane"
 
-docker manifest create ${GHCR_IMAGE_NAME}:${TAG_FREQAI} ${CACHE_IMAGE}:${TAG_FREQAI} ${CACHE_IMAGE}:${TAG_FREQAI_ARM}
-docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
+echo "${GHCR_TOKEN}" | crane auth login ghcr.io -u ${GHCR_USER} --password-stdin
 
-docker manifest create ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL} ${CACHE_IMAGE}:${TAG_FREQAI_RL_ARM}
-docker manifest push -p ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
+crane copy ${IMAGE_NAME}:${TAG} ${GHCR_IMAGE_NAME}:${TAG}
+crane copy ${IMAGE_NAME}:${TAG_PLOT} ${GHCR_IMAGE_NAME}:${TAG_PLOT}
+crane copy ${IMAGE_NAME}:${TAG_FREQAI} ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
+crane copy ${IMAGE_NAME}:${TAG_FREQAI_RL} ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
 
 # Tag as latest for develop builds
 if [ "${TAG}" = "develop" ]; then
@@ -103,8 +101,7 @@ if [ "${TAG}" = "develop" ]; then
     docker manifest create ${IMAGE_NAME}:latest ${CACHE_IMAGE}:${TAG_ARM} ${IMAGE_NAME}:${TAG_PI} ${CACHE_IMAGE}:${TAG}
     docker manifest push -p ${IMAGE_NAME}:latest
 
-    docker manifest create ${GHCR_IMAGE_NAME}:latest ${CACHE_IMAGE}:${TAG_ARM} ${IMAGE_NAME}:${TAG_PI} ${CACHE_IMAGE}:${TAG}
-    docker manifest push -p ${GHCR_IMAGE_NAME}:latest
+    crane copy ${IMAGE_NAME}:latest ${GHCR_IMAGE_NAME}:latest
 fi
 
 docker images
diff --git a/build_helpers/publish_docker_multi.sh b/build_helpers/publish_docker_multi.sh
index 3e5e61564..27fa06b95 100755
--- a/build_helpers/publish_docker_multi.sh
+++ b/build_helpers/publish_docker_multi.sh
@@ -2,6 +2,8 @@
 
 # The below assumes a correctly setup docker buildx environment
 
+IMAGE_NAME=freqtradeorg/freqtrade
+CACHE_IMAGE=freqtradeorg/freqtrade_cache
 # Replace / with _ to create a valid tag
 TAG=$(echo "${BRANCH_NAME}" | sed -e "s/\//_/g")
 TAG_PLOT=${TAG}_plot
@@ -11,7 +13,6 @@ TAG_PI="${TAG}_pi"
 
 PI_PLATFORM="linux/arm/v7"
 echo "Running for ${TAG}"
-CACHE_IMAGE=freqtradeorg/freqtrade_cache
 CACHE_TAG=${CACHE_IMAGE}:${TAG_PI}_cache
 
 # Add commit and commit_message to docker container

From 628f6b8b7cdc4c73d89d3aec678366f021761cb4 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 15 Mar 2023 20:41:08 +0100
Subject: [PATCH 050/147] Fix crane docker permissions

---
 .github/workflows/ci.yml              | 7 -------
 build_helpers/publish_docker_arm64.sh | 7 +++++--
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index f09e5feac..663cfb1be 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -493,13 +493,6 @@ jobs:
       run: |
         echo "${DOCKER_PASSWORD}" | docker login --username ${DOCKER_USERNAME} --password-stdin
 
-    # - name: GHCR.io login
-    #   env:
-    #     GHCR_USERNAME: ${{ github.actor }}
-    #     GHCR_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
-    #   run: |
-        # echo "${GHCR_PASSWORD}" | docker login ghcr.io --username ${GHCR_USERNAME} --password-stdin
-
     - name: Build and test and push docker images
       env:
         BRANCH_NAME: ${{ steps.extract_branch.outputs.branch }}
diff --git a/build_helpers/publish_docker_arm64.sh b/build_helpers/publish_docker_arm64.sh
index 3de113d37..ce0fab6ec 100755
--- a/build_helpers/publish_docker_arm64.sh
+++ b/build_helpers/publish_docker_arm64.sh
@@ -86,9 +86,11 @@ docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI_RL}
 
 # copy images to ghcr.io
 
-alias crane="docker run --rm -v $(pwd)/crane:/home/nonroot/.docker/ gcr.io/go-containerregistry/crane"
+alias crane="docker run --rm --i -v $(pwd)/.crane:/home/nonroot/.docker/ gcr.io/go-containerregistry/crane"
+mkdir .crane
+chmod a+rwx .crane
 
-echo "${GHCR_TOKEN}" | crane auth login ghcr.io -u ${GHCR_USER} --password-stdin
+echo "${GHCR_TOKEN}" | crane auth login ghcr.io -u "${GHCR_USERNAME}" --password-stdin
 
 crane copy ${IMAGE_NAME}:${TAG} ${GHCR_IMAGE_NAME}:${TAG}
 crane copy ${IMAGE_NAME}:${TAG_PLOT} ${GHCR_IMAGE_NAME}:${TAG_PLOT}
@@ -105,6 +107,7 @@ if [ "${TAG}" = "develop" ]; then
 fi
 
 docker images
+rm -rf .crane
 
 # Cleanup old images from arm64 node.
 docker image prune -a --force --filter "until=24h"

From 764d5507a3914d5f109ffd98c3c21fb6e6449aa5 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Thu, 16 Mar 2023 19:33:56 +0100
Subject: [PATCH 051/147] Fix typo in docker param

---
 build_helpers/publish_docker_arm64.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build_helpers/publish_docker_arm64.sh b/build_helpers/publish_docker_arm64.sh
index ce0fab6ec..696f5bc48 100755
--- a/build_helpers/publish_docker_arm64.sh
+++ b/build_helpers/publish_docker_arm64.sh
@@ -86,7 +86,7 @@ docker manifest push -p ${IMAGE_NAME}:${TAG_FREQAI_RL}
 
 # copy images to ghcr.io
 
-alias crane="docker run --rm --i -v $(pwd)/.crane:/home/nonroot/.docker/ gcr.io/go-containerregistry/crane"
+alias crane="docker run --rm -i -v $(pwd)/.crane:/home/nonroot/.docker/ gcr.io/go-containerregistry/crane"
 mkdir .crane
 chmod a+rwx .crane
 

From 9044052b4e1eded666da0b1ad00e50fa5e7ef311 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 17 Mar 2023 06:46:55 +0100
Subject: [PATCH 052/147] Fix exceptions when training fails

---
 freqtrade/freqai/freqai_interface.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/freqtrade/freqai/freqai_interface.py b/freqtrade/freqai/freqai_interface.py
index 884849446..07c357de3 100644
--- a/freqtrade/freqai/freqai_interface.py
+++ b/freqtrade/freqai/freqai_interface.py
@@ -104,6 +104,7 @@ class IFreqaiModel(ABC):
         self.data_provider: Optional[DataProvider] = None
         self.max_system_threads = max(int(psutil.cpu_count() * 2 - 2), 1)
         self.can_short = True  # overridden in start() with strategy.can_short
+        self.model: Any = None
 
         record_params(config, self.full_path)
 
@@ -338,13 +339,14 @@ class IFreqaiModel(ABC):
                     except Exception as msg:
                         logger.warning(
                             f"Training {pair} raised exception {msg.__class__.__name__}. "
-                            f"Message: {msg}, skipping.")
+                            f"Message: {msg}, skipping.", exc_info=True)
+                        self.model = None
 
                     self.dd.pair_dict[pair]["trained_timestamp"] = int(
                         tr_train.stopts)
-                    if self.plot_features:
+                    if self.plot_features and self.model is not None:
                         plot_feature_importance(self.model, pair, dk, self.plot_features)
-                    if self.save_backtest_models:
+                    if self.save_backtest_models and self.model is not None:
                         logger.info('Saving backtest model to disk.')
                         self.dd.save_data(self.model, pair, dk)
                     else:

From 477dc504250f7e305e592664d1a30932e36cfdd8 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 18 Mar 2023 16:32:07 +0000
Subject: [PATCH 053/147] Add pair output to "tossed" messages

---
 freqtrade/freqai/data_kitchen.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/freqtrade/freqai/data_kitchen.py b/freqtrade/freqai/data_kitchen.py
index 66923b5c2..52d487b08 100644
--- a/freqtrade/freqai/data_kitchen.py
+++ b/freqtrade/freqai/data_kitchen.py
@@ -251,7 +251,7 @@ class FreqaiDataKitchen:
                 (drop_index == 0) & (drop_index_labels == 0)
             ]
             logger.info(
-                f"dropped {len(unfiltered_df) - len(filtered_df)} training points"
+                f"{self.pair}: dropped {len(unfiltered_df) - len(filtered_df)} training points"
                 f" due to NaNs in populated dataset {len(unfiltered_df)}."
             )
             if (1 - len(filtered_df) / len(unfiltered_df)) > 0.1 and self.live:
@@ -675,7 +675,7 @@ class FreqaiDataKitchen:
                 ]
 
             logger.info(
-                f"SVM tossed {len(y_pred) - kept_points.sum()}"
+                f"{self.pair}: SVM tossed {len(y_pred) - kept_points.sum()}"
                 f" test points from {len(y_pred)} total points."
             )
 
@@ -949,7 +949,7 @@ class FreqaiDataKitchen:
 
         if (len(do_predict) - do_predict.sum()) > 0:
             logger.info(
-                f"DI tossed {len(do_predict) - do_predict.sum()} predictions for "
+                f"{self.pair}: DI tossed {len(do_predict) - do_predict.sum()} predictions for "
                 "being too far from training data."
             )
 

From 818d2bf92afcb6d41f3c91d3b81fb045dcfd470b Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 18 Mar 2023 17:02:17 +0100
Subject: [PATCH 054/147] Fix stoploss on exchange value in /show_config call

---
 freqtrade/rpc/rpc.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index eb184c6d6..6b82efe71 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -123,7 +123,7 @@ class RPC:
                                 if config['max_open_trades'] != float('inf') else -1),
             'minimal_roi': config['minimal_roi'].copy() if 'minimal_roi' in config else {},
             'stoploss': config.get('stoploss'),
-            'stoploss_on_exchange': config.get('stoploss_on_exchange', False),
+            'stoploss_on_exchange': config.get('order_types', {}).get('stoploss_on_exchange', False),
             'trailing_stop': config.get('trailing_stop'),
             'trailing_stop_positive': config.get('trailing_stop_positive'),
             'trailing_stop_positive_offset': config.get('trailing_stop_positive_offset'),

From d808dd49e81978f84a3ff40bf0cce215b40455ca Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 18 Mar 2023 19:28:13 +0100
Subject: [PATCH 055/147] Fix ruff violation

---
 freqtrade/rpc/rpc.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index 6b82efe71..c6a6f5cae 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -123,7 +123,8 @@ class RPC:
                                 if config['max_open_trades'] != float('inf') else -1),
             'minimal_roi': config['minimal_roi'].copy() if 'minimal_roi' in config else {},
             'stoploss': config.get('stoploss'),
-            'stoploss_on_exchange': config.get('order_types', {}).get('stoploss_on_exchange', False),
+            'stoploss_on_exchange': config.get('order_types',
+                                               {}).get('stoploss_on_exchange', False),
             'trailing_stop': config.get('trailing_stop'),
             'trailing_stop_positive': config.get('trailing_stop_positive'),
             'trailing_stop_positive_offset': config.get('trailing_stop_positive_offset'),

From b0a7b64d444ddffdb47ec11166a3126f54f2d5da Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 17 Mar 2023 20:41:11 +0100
Subject: [PATCH 056/147] Close sessions after telegram calls

---
 freqtrade/rpc/telegram.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/freqtrade/rpc/telegram.py b/freqtrade/rpc/telegram.py
index 0c0b24f00..fda791313 100644
--- a/freqtrade/rpc/telegram.py
+++ b/freqtrade/rpc/telegram.py
@@ -83,6 +83,8 @@ def authorized_only(command_handler: Callable[..., None]) -> Callable[..., Any]:
             self._send_msg(str(e))
         except BaseException:
             logger.exception('Exception occurred within Telegram module')
+        finally:
+            Trade.session.remove()
 
     return wrapper
 

From 62c8dd98d57c8d0ece15ff2a31f83a68f0f2d34d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 17 Mar 2023 20:44:00 +0100
Subject: [PATCH 057/147] Use combination of thread-local and asyncio-aware
 session context

---
 freqtrade/persistence/models.py  | 25 ++++++++++++++++++++++---
 freqtrade/rpc/api_server/deps.py | 15 ++++++++++++---
 tests/rpc/test_rpc_telegram.py   |  6 ++++--
 3 files changed, 38 insertions(+), 8 deletions(-)

diff --git a/freqtrade/persistence/models.py b/freqtrade/persistence/models.py
index eee07e61c..2315c0acc 100644
--- a/freqtrade/persistence/models.py
+++ b/freqtrade/persistence/models.py
@@ -2,7 +2,9 @@
 This module contains the class to persist trades into SQLite
 """
 import logging
-from typing import Any, Dict
+import threading
+from contextvars import ContextVar
+from typing import Any, Dict, Final, Optional
 
 from sqlalchemy import create_engine, inspect
 from sqlalchemy.exc import NoSuchModuleError
@@ -19,6 +21,22 @@ from freqtrade.persistence.trade_model import Order, Trade
 logger = logging.getLogger(__name__)
 
 
+REQUEST_ID_CTX_KEY: Final[str] = 'request_id'
+_request_id_ctx_var: ContextVar[Optional[str]] = ContextVar(REQUEST_ID_CTX_KEY, default=None)
+
+
+def get_request_or_thread_id() -> Optional[str]:
+    """
+    Helper method to get either async context (for fastapi requests), or thread id
+    """
+    id = _request_id_ctx_var.get()
+    if id is None:
+        # when not in request context - use thread id
+        id = str(threading.current_thread().ident)
+
+    return id
+
+
 _SQL_DOCS_URL = 'http://docs.sqlalchemy.org/en/latest/core/engines.html#database-urls'
 
 
@@ -53,8 +71,9 @@ def init_db(db_url: str) -> None:
 
     # https://docs.sqlalchemy.org/en/13/orm/contextual.html#thread-local-scope
     # Scoped sessions proxy requests to the appropriate thread-local session.
-    # We should use the scoped_session object - not a seperately initialized version
-    Trade.session = scoped_session(sessionmaker(bind=engine, autoflush=False))
+    # Since we also use fastAPI, we need to make it aware of the request id, too
+    Trade.session = scoped_session(sessionmaker(
+        bind=engine, autoflush=False), scopefunc=get_request_or_thread_id)
     Order.session = Trade.session
     PairLock.session = Trade.session
 
diff --git a/freqtrade/rpc/api_server/deps.py b/freqtrade/rpc/api_server/deps.py
index aed97367b..eb41d728d 100644
--- a/freqtrade/rpc/api_server/deps.py
+++ b/freqtrade/rpc/api_server/deps.py
@@ -1,9 +1,11 @@
 from typing import Any, Dict, Iterator, Optional
+from uuid import uuid4
 
 from fastapi import Depends
 
 from freqtrade.enums import RunMode
 from freqtrade.persistence import Trade
+from freqtrade.persistence.models import _request_id_ctx_var
 from freqtrade.rpc.rpc import RPC, RPCException
 
 from .webserver import ApiServer
@@ -15,12 +17,19 @@ def get_rpc_optional() -> Optional[RPC]:
     return None
 
 
-def get_rpc() -> Optional[Iterator[RPC]]:
+async def get_rpc() -> Optional[Iterator[RPC]]:
+
     _rpc = get_rpc_optional()
     if _rpc:
+        request_id = str(uuid4())
+        ctx_token = _request_id_ctx_var.set(request_id)
         Trade.rollback()
-        yield _rpc
-        Trade.rollback()
+        try:
+            yield _rpc
+        finally:
+            Trade.session.remove()
+            _request_id_ctx_var.reset(ctx_token)
+
     else:
         raise RPCException('Bot is not in the correct state')
 
diff --git a/tests/rpc/test_rpc_telegram.py b/tests/rpc/test_rpc_telegram.py
index b1859f581..521e3b66d 100644
--- a/tests/rpc/test_rpc_telegram.py
+++ b/tests/rpc/test_rpc_telegram.py
@@ -674,8 +674,9 @@ def test_monthly_handle(default_conf_usdt, update, ticker, fee, mocker, time_mac
     assert str('Monthly Profit over the last 6 months</b>:') in msg_mock.call_args_list[0][0][0]
 
 
-def test_profit_handle(default_conf_usdt, update, ticker_usdt, ticker_sell_up, fee,
-                       limit_sell_order_usdt, mocker) -> None:
+def test_telegram_profit_handle(
+        default_conf_usdt, update, ticker_usdt, ticker_sell_up, fee,
+        limit_sell_order_usdt, mocker) -> None:
     mocker.patch('freqtrade.rpc.rpc.CryptoToFiatConverter._find_price', return_value=1.1)
     mocker.patch.multiple(
         EXMS,
@@ -710,6 +711,7 @@ def test_profit_handle(default_conf_usdt, update, ticker_usdt, ticker_sell_up, f
     # Update the ticker with a market going up
     mocker.patch(f'{EXMS}.fetch_ticker', ticker_sell_up)
     # Simulate fulfilled LIMIT_SELL order for trade
+    trade = Trade.session.scalars(select(Trade)).first()
     oobj = Order.parse_from_ccxt_object(
         limit_sell_order_usdt, limit_sell_order_usdt['symbol'], 'sell')
     trade.orders.append(oobj)

From b1f88e88612285c5ccaa219c6d9366a575c30de9 Mon Sep 17 00:00:00 2001
From: hippocritical <gunngirspam@gmail.com>
Date: Sat, 18 Mar 2023 20:02:55 +0100
Subject: [PATCH 058/147] fixed typo from trades to trade

---
 freqtrade/strategy/strategyupdater.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/strategy/strategyupdater.py b/freqtrade/strategy/strategyupdater.py
index bc692b71c..2669dcc4a 100644
--- a/freqtrade/strategy/strategyupdater.py
+++ b/freqtrade/strategy/strategyupdater.py
@@ -181,7 +181,7 @@ class NameUpdater(ast_comments.NodeTransformer):
     def visit_Attribute(self, node):
         if (
                 isinstance(node.value, ast_comments.Name)
-                and node.value.id == 'trades'
+                and node.value.id == 'trade'
                 and node.attr == 'nr_of_successful_buys'
         ):
             node.attr = 'nr_of_successful_entries'

From bf3f2e4de4cdaf52f41e55ef65ab997a5c29e50d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 11:16:54 +0100
Subject: [PATCH 059/147] Fix failing test

---
 tests/test_strategy_updater.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/test_strategy_updater.py b/tests/test_strategy_updater.py
index d3bdd27b5..597d49fda 100644
--- a/tests/test_strategy_updater.py
+++ b/tests/test_strategy_updater.py
@@ -124,11 +124,11 @@ def test_strategy_updater_method_params(default_conf, caplog) -> None:
     instance_strategy_updater = StrategyUpdater()
     modified_code = instance_strategy_updater.update_code("""
 def confirm_trade_exit(sell_reason: str):
-    nr_orders = trades.nr_of_successful_buys
+    nr_orders = trade.nr_of_successful_buys
     pass
     """)
     assert "exit_reason" in modified_code
-    assert "nr_orders = trades.nr_of_successful_entries" in modified_code
+    assert "nr_orders = trade.nr_of_successful_entries" in modified_code
 
 
 def test_strategy_updater_dicts(default_conf, caplog) -> None:

From f5f151fcc54b2255e4dc167276500fd937b54f8c Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 15:06:56 +0100
Subject: [PATCH 060/147] Fix typing error

---
 freqtrade/rpc/api_server/deps.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/freqtrade/rpc/api_server/deps.py b/freqtrade/rpc/api_server/deps.py
index eb41d728d..f5b1bcd74 100644
--- a/freqtrade/rpc/api_server/deps.py
+++ b/freqtrade/rpc/api_server/deps.py
@@ -1,4 +1,4 @@
-from typing import Any, Dict, Iterator, Optional
+from typing import Any, AsyncIterator, Dict, Optional
 from uuid import uuid4
 
 from fastapi import Depends
@@ -17,7 +17,7 @@ def get_rpc_optional() -> Optional[RPC]:
     return None
 
 
-async def get_rpc() -> Optional[Iterator[RPC]]:
+async def get_rpc() -> Optional[AsyncIterator[RPC]]:
 
     _rpc = get_rpc_optional()
     if _rpc:

From 9ccc3e52ec0ae5da850452a6d703d47aa1a4ccba Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 15:30:27 +0100
Subject: [PATCH 061/147] Simplify time in force code structure

---
 freqtrade/exchange/exchange.py | 4 +---
 freqtrade/exchange/gate.py     | 3 +--
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index 489dc1b68..e5f897c2a 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -60,7 +60,6 @@ class Exchange:
     _ft_has_default: Dict = {
         "stoploss_on_exchange": False,
         "order_time_in_force": ["GTC"],
-        "time_in_force_parameter": "timeInForce",
         "ohlcv_params": {},
         "ohlcv_candle_limit": 500,
         "ohlcv_has_history": True,  # Some exchanges (Kraken) don't provide history via ohlcv
@@ -1034,8 +1033,7 @@ class Exchange:
     ) -> Dict:
         params = self._params.copy()
         if time_in_force != 'GTC' and ordertype != 'market':
-            param = self._ft_has.get('time_in_force_parameter', '')
-            params.update({param: time_in_force.upper()})
+            params.update({'timeInForce': time_in_force.upper()})
         if reduceOnly:
             params.update({'reduceOnly': True})
         return params
diff --git a/freqtrade/exchange/gate.py b/freqtrade/exchange/gate.py
index 03b568460..bf6d5b59c 100644
--- a/freqtrade/exchange/gate.py
+++ b/freqtrade/exchange/gate.py
@@ -75,8 +75,7 @@ class Gate(Exchange):
         )
         if ordertype == 'market' and self.trading_mode == TradingMode.FUTURES:
             params['type'] = 'market'
-            param = self._ft_has.get('time_in_force_parameter', '')
-            params.update({param: 'IOC'})
+            params.update({'timeInForce': 'IOC'})
         return params
 
     def get_trades_for_order(self, order_id: str, pair: str, since: datetime,

From 3d91dd8a982df6c2768d63178e4fcd0be590d2ce Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 15:36:35 +0100
Subject: [PATCH 062/147] Support post-only orders for Binance spot

closes #8044
---
 freqtrade/exchange/binance.py   | 24 +++++++++++++++++++++++-
 tests/exchange/test_binance.py  | 13 +++++++++++++
 tests/exchange/test_exchange.py |  2 +-
 3 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/freqtrade/exchange/binance.py b/freqtrade/exchange/binance.py
index 9580bc690..a89c02631 100644
--- a/freqtrade/exchange/binance.py
+++ b/freqtrade/exchange/binance.py
@@ -7,6 +7,7 @@ from typing import Dict, List, Optional, Tuple
 import arrow
 import ccxt
 
+from freqtrade.constants import BuySell
 from freqtrade.enums import CandleType, MarginMode, PriceType, TradingMode
 from freqtrade.exceptions import DDosProtection, OperationalException, TemporaryError
 from freqtrade.exchange import Exchange
@@ -23,7 +24,7 @@ class Binance(Exchange):
     _ft_has: Dict = {
         "stoploss_on_exchange": True,
         "stoploss_order_types": {"limit": "stop_loss_limit"},
-        "order_time_in_force": ['GTC', 'FOK', 'IOC'],
+        "order_time_in_force": ["GTC", "FOK", "IOC", "PO"],
         "ohlcv_candle_limit": 1000,
         "trades_pagination": "id",
         "trades_pagination_arg": "fromId",
@@ -31,6 +32,7 @@ class Binance(Exchange):
     }
     _ft_has_futures: Dict = {
         "stoploss_order_types": {"limit": "stop", "market": "stop_market"},
+        "order_time_in_force": ["GTC", "FOK", "IOC"],
         "tickers_have_price": False,
         "floor_leverage": True,
         "stop_price_type_field": "workingType",
@@ -47,6 +49,26 @@ class Binance(Exchange):
         (TradingMode.FUTURES, MarginMode.ISOLATED)
     ]
 
+    def _get_params(
+        self,
+        side: BuySell,
+        ordertype: str,
+        leverage: float,
+        reduceOnly: bool,
+        time_in_force: str = 'GTC',
+    ) -> Dict:
+        params = super()._get_params(side, ordertype, leverage, reduceOnly, time_in_force)
+        if (
+            time_in_force == 'PO'
+            and ordertype != 'market'
+            and self.trading_mode == TradingMode.SPOT
+            # Only spot can do post only orders
+        ):
+            params.pop('timeInForce')
+            params['postOnly'] = True
+
+        return params
+
     def get_tickers(self, symbols: Optional[List[str]] = None, cached: bool = False) -> Tickers:
         tickers = super().get_tickers(symbols=symbols, cached=cached)
         if self.trading_mode == TradingMode.FUTURES:
diff --git a/tests/exchange/test_binance.py b/tests/exchange/test_binance.py
index 616910682..ba786bb3b 100644
--- a/tests/exchange/test_binance.py
+++ b/tests/exchange/test_binance.py
@@ -11,6 +11,19 @@ from tests.conftest import EXMS, get_mock_coro, get_patched_exchange, log_has_re
 from tests.exchange.test_exchange import ccxt_exceptionhandlers
 
 
+@pytest.mark.parametrize('side,type,time_in_force,expected', [
+    ('buy', 'limit', 'gtc', {'timeInForce': 'GTC'}),
+    ('buy', 'limit', 'IOC', {'timeInForce': 'IOC'}),
+    ('buy', 'market', 'IOC', {}),
+    ('buy', 'limit', 'PO', {'postOnly': True}),
+    ('sell', 'limit', 'PO', {'postOnly': True}),
+    ('sell', 'market', 'PO', {}),
+    ])
+def test__get_params_binance(default_conf, mocker, side, type, time_in_force, expected):
+    exchange = get_patched_exchange(mocker, default_conf, id='binance')
+    assert exchange._get_params(side, type, 1, False, time_in_force) == expected
+
+
 @pytest.mark.parametrize('trademode', [TradingMode.FUTURES, TradingMode.SPOT])
 @pytest.mark.parametrize('limitratio,expected,side', [
     (None, 220 * 0.99, "sell"),
diff --git a/tests/exchange/test_exchange.py b/tests/exchange/test_exchange.py
index d7f6a8b90..7c48f1c9d 100644
--- a/tests/exchange/test_exchange.py
+++ b/tests/exchange/test_exchange.py
@@ -3387,7 +3387,7 @@ def test_merge_ft_has_dict(default_conf, mocker):
     ex = Binance(default_conf)
     assert ex._ft_has != Exchange._ft_has_default
     assert ex.get_option('stoploss_on_exchange')
-    assert ex.get_option('order_time_in_force') == ['GTC', 'FOK', 'IOC']
+    assert ex.get_option('order_time_in_force') == ['GTC', 'FOK', 'IOC', 'PO']
     assert ex.get_option('trades_pagination') == 'id'
     assert ex.get_option('trades_pagination_arg') == 'fromId'
 

From 236499a195d61bb2f3e54917a42b4a37af612ea5 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 15:47:42 +0100
Subject: [PATCH 063/147] Reorder push logic for ghcr

---
 build_helpers/publish_docker_arm64.sh | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/build_helpers/publish_docker_arm64.sh b/build_helpers/publish_docker_arm64.sh
index 696f5bc48..a6ecdbee6 100755
--- a/build_helpers/publish_docker_arm64.sh
+++ b/build_helpers/publish_docker_arm64.sh
@@ -92,10 +92,10 @@ chmod a+rwx .crane
 
 echo "${GHCR_TOKEN}" | crane auth login ghcr.io -u "${GHCR_USERNAME}" --password-stdin
 
-crane copy ${IMAGE_NAME}:${TAG} ${GHCR_IMAGE_NAME}:${TAG}
-crane copy ${IMAGE_NAME}:${TAG_PLOT} ${GHCR_IMAGE_NAME}:${TAG_PLOT}
-crane copy ${IMAGE_NAME}:${TAG_FREQAI} ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
 crane copy ${IMAGE_NAME}:${TAG_FREQAI_RL} ${GHCR_IMAGE_NAME}:${TAG_FREQAI_RL}
+crane copy ${IMAGE_NAME}:${TAG_FREQAI} ${GHCR_IMAGE_NAME}:${TAG_FREQAI}
+crane copy ${IMAGE_NAME}:${TAG_PLOT} ${GHCR_IMAGE_NAME}:${TAG_PLOT}
+crane copy ${IMAGE_NAME}:${TAG} ${GHCR_IMAGE_NAME}:${TAG}
 
 # Tag as latest for develop builds
 if [ "${TAG}" = "develop" ]; then

From 222ecdecd29120e07ae1b8dcebea0e6525206b77 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 17:50:08 +0100
Subject: [PATCH 064/147] Improve code quality

---
 freqtrade/commands/analyze_commands.py  | 4 ++--
 freqtrade/optimize/hyperopt_tools.py    | 3 +--
 freqtrade/rpc/telegram.py               | 4 ++--
 freqtrade/rpc/webhook.py                | 2 +-
 tests/data/test_btanalysis.py           | 2 +-
 tests/data/test_history.py              | 2 +-
 tests/optimize/test_optimize_reports.py | 4 ++--
 tests/rpc/test_rpc_telegram.py          | 8 ++++----
 tests/strategy/test_strategy_loading.py | 2 +-
 9 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/freqtrade/commands/analyze_commands.py b/freqtrade/commands/analyze_commands.py
index 20afa7ffd..e928ccad7 100644
--- a/freqtrade/commands/analyze_commands.py
+++ b/freqtrade/commands/analyze_commands.py
@@ -40,8 +40,8 @@ def setup_analyze_configuration(args: Dict[str, Any], method: RunMode) -> Dict[s
 
         if (not Path(signals_file).exists()):
             raise OperationalException(
-                (f"Cannot find latest backtest signals file: {signals_file}."
-                  "Run backtesting with `--export signals`.")
+                f"Cannot find latest backtest signals file: {signals_file}."
+                "Run backtesting with `--export signals`."
             )
 
     return config
diff --git a/freqtrade/optimize/hyperopt_tools.py b/freqtrade/optimize/hyperopt_tools.py
index cf0650f7d..93efbf644 100644
--- a/freqtrade/optimize/hyperopt_tools.py
+++ b/freqtrade/optimize/hyperopt_tools.py
@@ -1,4 +1,3 @@
-import io
 import logging
 from copy import deepcopy
 from datetime import datetime, timezone
@@ -464,7 +463,7 @@ class HyperoptTools():
             return
 
         try:
-            io.open(csv_file, 'w+').close()
+            Path(csv_file).open('w+').close()
         except IOError:
             logger.error(f"Failed to create CSV file: {csv_file}")
             return
diff --git a/freqtrade/rpc/telegram.py b/freqtrade/rpc/telegram.py
index 0c0b24f00..cb219eef1 100644
--- a/freqtrade/rpc/telegram.py
+++ b/freqtrade/rpc/telegram.py
@@ -1340,7 +1340,7 @@ class Telegram(RPCHandler):
         message = tabulate({k: [v] for k, v in counts.items()},
                            headers=['current', 'max', 'total stake'],
                            tablefmt='simple')
-        message = "<pre>{}</pre>".format(message)
+        message = f"<pre>{message}</pre>"
         logger.debug(message)
         self._send_msg(message, parse_mode=ParseMode.HTML,
                        reload_able=True, callback_path="update_count",
@@ -1642,7 +1642,7 @@ class Telegram(RPCHandler):
             ])
         else:
             reply_markup = InlineKeyboardMarkup([[]])
-        msg += "\nUpdated: {}".format(datetime.now().ctime())
+        msg += f"\nUpdated: {datetime.now().ctime()}"
         if not query.message:
             return
         chat_id = query.message.chat_id
diff --git a/freqtrade/rpc/webhook.py b/freqtrade/rpc/webhook.py
index 0967de70d..118ebed88 100644
--- a/freqtrade/rpc/webhook.py
+++ b/freqtrade/rpc/webhook.py
@@ -113,7 +113,7 @@ class Webhook(RPCHandler):
                     response = post(self._url, data=payload['data'],
                                     headers={'Content-Type': 'text/plain'})
                 else:
-                    raise NotImplementedError('Unknown format: {}'.format(self._format))
+                    raise NotImplementedError(f'Unknown format: {self._format}')
 
                 # Throw a RequestException if the post was not successful
                 response.raise_for_status()
diff --git a/tests/data/test_btanalysis.py b/tests/data/test_btanalysis.py
index 345e3c299..2c5515f7c 100644
--- a/tests/data/test_btanalysis.py
+++ b/tests/data/test_btanalysis.py
@@ -98,7 +98,7 @@ def test_load_backtest_data_new_format(testdatadir):
     assert bt_data.equals(bt_data3)
 
     with pytest.raises(ValueError, match=r"File .* does not exist\."):
-        load_backtest_data(str("filename") + "nofile")
+        load_backtest_data("filename" + "nofile")
 
     with pytest.raises(ValueError, match=r"Unknown dataformat."):
         load_backtest_data(testdatadir / "backtest_results" / LAST_BT_RESULT_FN)
diff --git a/tests/data/test_history.py b/tests/data/test_history.py
index c967f0c89..24ad8bcc9 100644
--- a/tests/data/test_history.py
+++ b/tests/data/test_history.py
@@ -409,7 +409,7 @@ def test_init_with_refresh(default_conf, mocker) -> None:
 
 
 def test_file_dump_json_tofile(testdatadir) -> None:
-    file = testdatadir / 'test_{id}.json'.format(id=str(uuid.uuid4()))
+    file = testdatadir / f'test_{uuid.uuid4()}.json'
     data = {'bar': 'foo'}
 
     # check the file we will create does not exist
diff --git a/tests/optimize/test_optimize_reports.py b/tests/optimize/test_optimize_reports.py
index f71e6c492..0cc32baaf 100644
--- a/tests/optimize/test_optimize_reports.py
+++ b/tests/optimize/test_optimize_reports.py
@@ -236,7 +236,7 @@ def test_store_backtest_candles(testdatadir, mocker):
 
     assert dump_mock.call_count == 1
     assert isinstance(dump_mock.call_args_list[0][0][0], Path)
-    assert str(dump_mock.call_args_list[0][0][0]).endswith(str('_signals.pkl'))
+    assert str(dump_mock.call_args_list[0][0][0]).endswith('_signals.pkl')
 
     dump_mock.reset_mock()
     # mock file exporting
@@ -245,7 +245,7 @@ def test_store_backtest_candles(testdatadir, mocker):
     assert dump_mock.call_count == 1
     assert isinstance(dump_mock.call_args_list[0][0][0], Path)
     # result will be testdatadir / testresult-<timestamp>_signals.pkl
-    assert str(dump_mock.call_args_list[0][0][0]).endswith(str('_signals.pkl'))
+    assert str(dump_mock.call_args_list[0][0][0]).endswith('_signals.pkl')
     dump_mock.reset_mock()
 
 
diff --git a/tests/rpc/test_rpc_telegram.py b/tests/rpc/test_rpc_telegram.py
index b1859f581..7dabe9dfe 100644
--- a/tests/rpc/test_rpc_telegram.py
+++ b/tests/rpc/test_rpc_telegram.py
@@ -652,7 +652,7 @@ def test_monthly_handle(default_conf_usdt, update, ticker, fee, mocker, time_mac
 
     # The one-digit months should contain a zero, Eg: September 2021 = "2021-09"
     # Since we loaded the last 12 months, any month should appear
-    assert str('-09') in msg_mock.call_args_list[0][0][0]
+    assert '-09' in msg_mock.call_args_list[0][0][0]
 
     # Try invalid data
     msg_mock.reset_mock()
@@ -671,7 +671,7 @@ def test_monthly_handle(default_conf_usdt, update, ticker, fee, mocker, time_mac
     context = MagicMock()
     context.args = ["february"]
     telegram._monthly(update=update, context=context)
-    assert str('Monthly Profit over the last 6 months</b>:') in msg_mock.call_args_list[0][0][0]
+    assert 'Monthly Profit over the last 6 months</b>:' in msg_mock.call_args_list[0][0][0]
 
 
 def test_profit_handle(default_conf_usdt, update, ticker_usdt, ticker_sell_up, fee,
@@ -1730,14 +1730,14 @@ def test_version_handle(default_conf, update, mocker) -> None:
 
     telegram._version(update=update, context=MagicMock())
     assert msg_mock.call_count == 1
-    assert '*Version:* `{}`'.format(__version__) in msg_mock.call_args_list[0][0][0]
+    assert f'*Version:* `{__version__}`' in msg_mock.call_args_list[0][0][0]
 
     msg_mock.reset_mock()
     freqtradebot.strategy.version = lambda: '1.1.1'
 
     telegram._version(update=update, context=MagicMock())
     assert msg_mock.call_count == 1
-    assert '*Version:* `{}`'.format(__version__) in msg_mock.call_args_list[0][0][0]
+    assert f'*Version:* `{__version__}`' in msg_mock.call_args_list[0][0][0]
     assert '*Strategy version: * `1.1.1`' in msg_mock.call_args_list[0][0][0]
 
 
diff --git a/tests/strategy/test_strategy_loading.py b/tests/strategy/test_strategy_loading.py
index 98185e152..4cdb35936 100644
--- a/tests/strategy/test_strategy_loading.py
+++ b/tests/strategy/test_strategy_loading.py
@@ -69,7 +69,7 @@ def test_load_strategy(default_conf, dataframe_1m):
 def test_load_strategy_base64(dataframe_1m, caplog, default_conf):
     filepath = Path(__file__).parents[2] / 'freqtrade/templates/sample_strategy.py'
     encoded_string = urlsafe_b64encode(filepath.read_bytes()).decode("utf-8")
-    default_conf.update({'strategy': 'SampleStrategy:{}'.format(encoded_string)})
+    default_conf.update({'strategy': f'SampleStrategy:{encoded_string}'})
 
     strategy = StrategyResolver.load_strategy(default_conf)
     assert 'rsi' in strategy.advise_indicators(dataframe_1m, {'pair': 'ETH/BTC'})

From c92f28bf6f6e04dee47615d7022da3e901332a2b Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 17:57:56 +0100
Subject: [PATCH 065/147] ruff: Activate UP ruleset

---
 freqtrade/configuration/config_validation.py | 5 +----
 freqtrade/freqai/RL/TensorboardCallback.py   | 2 +-
 freqtrade/optimize/hyperopt_tools.py         | 2 +-
 freqtrade/vendor/qtpylib/indicators.py       | 8 --------
 pyproject.toml                               | 8 ++++++--
 5 files changed, 9 insertions(+), 16 deletions(-)

diff --git a/freqtrade/configuration/config_validation.py b/freqtrade/configuration/config_validation.py
index 606f081ef..0ee48cf91 100644
--- a/freqtrade/configuration/config_validation.py
+++ b/freqtrade/configuration/config_validation.py
@@ -27,10 +27,7 @@ def _extend_validator(validator_class):
             if 'default' in subschema:
                 instance.setdefault(prop, subschema['default'])
 
-        for error in validate_properties(
-            validator, properties, instance, schema,
-        ):
-            yield error
+        yield from validate_properties(validator, properties, instance, schema)
 
     return validators.extend(
         validator_class, {'properties': set_defaults}
diff --git a/freqtrade/freqai/RL/TensorboardCallback.py b/freqtrade/freqai/RL/TensorboardCallback.py
index 1828319cd..7f8c76956 100644
--- a/freqtrade/freqai/RL/TensorboardCallback.py
+++ b/freqtrade/freqai/RL/TensorboardCallback.py
@@ -13,7 +13,7 @@ class TensorboardCallback(BaseCallback):
     episodic summary reports.
     """
     def __init__(self, verbose=1, actions: Type[Enum] = BaseActions):
-        super(TensorboardCallback, self).__init__(verbose)
+        super().__init__(verbose)
         self.model: Any = None
         self.logger = None  # type: Any
         self.training_env: BaseEnvironment = None  # type: ignore
diff --git a/freqtrade/optimize/hyperopt_tools.py b/freqtrade/optimize/hyperopt_tools.py
index 93efbf644..e2133a956 100644
--- a/freqtrade/optimize/hyperopt_tools.py
+++ b/freqtrade/optimize/hyperopt_tools.py
@@ -464,7 +464,7 @@ class HyperoptTools():
 
         try:
             Path(csv_file).open('w+').close()
-        except IOError:
+        except OSError:
             logger.error(f"Failed to create CSV file: {csv_file}")
             return
 
diff --git a/freqtrade/vendor/qtpylib/indicators.py b/freqtrade/vendor/qtpylib/indicators.py
index 3da4f038d..63797d462 100644
--- a/freqtrade/vendor/qtpylib/indicators.py
+++ b/freqtrade/vendor/qtpylib/indicators.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-#
 # QTPyLib: Quantitative Trading Python Library
 # https://github.com/ranaroussi/qtpylib
 #
@@ -18,7 +16,6 @@
 # limitations under the License.
 #
 
-import sys
 import warnings
 from datetime import datetime, timedelta
 
@@ -27,11 +24,6 @@ import pandas as pd
 from pandas.core.base import PandasObject
 
 
-# =============================================
-# check min, python version
-if sys.version_info < (3, 4):
-    raise SystemError("QTPyLib requires Python version >= 3.4")
-
 # =============================================
 warnings.simplefilter(action="ignore", category=RuntimeWarning)
 
diff --git a/pyproject.toml b/pyproject.toml
index 71687961d..81ab50d40 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,15 +68,19 @@ target-version = "py38"
 extend-select = [
   "C90",    # mccabe
   # "N",    # pep8-naming
-  # "UP",   # pyupgrade
+  "UP",   # pyupgrade
   "TID",    # flake8-tidy-imports
   # "EXE",  # flake8-executable
   "YTT",    # flake8-2020
+  # "S",    # flake8-bandit
   # "DTZ",  # flake8-datetimez
   # "RSE",  # flake8-raise
   # "TCH",  # flake8-type-checking
-  "PTH",  # flake8-use-pathlib
+  "PTH",    # flake8-use-pathlib
 ]
 
 [tool.ruff.mccabe]
 max-complexity = 12
+
+[tool.ruff.per-file-ignores]
+"tests/*" = ["S"]

From ce3efa8f00aac5fe7c733271cdcf3c27e0ab0d09 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 18:05:08 +0100
Subject: [PATCH 066/147] Remove pointless asserts

---
 freqtrade/optimize/backtesting.py | 4 ----
 pyproject.toml                    | 2 +-
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index 5e1e9b48a..315b3b9db 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -442,10 +442,6 @@ class Backtesting:
                 # Worst case: price ticks tiny bit above open and dives down.
                 stop_rate = row[OPEN_IDX] * (1 - side_1 * abs(
                     (trade.stop_loss_pct or 0.0) / leverage))
-                if is_short:
-                    assert stop_rate > row[LOW_IDX]
-                else:
-                    assert stop_rate < row[HIGH_IDX]
 
             # Limit lower-end to candle low to avoid exits below the low.
             # This still remains "worst case" - but "worst realistic case".
diff --git a/pyproject.toml b/pyproject.toml
index 81ab50d40..c3ca9e1b0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,7 +68,7 @@ target-version = "py38"
 extend-select = [
   "C90",    # mccabe
   # "N",    # pep8-naming
-  "UP",   # pyupgrade
+  "UP",     # pyupgrade
   "TID",    # flake8-tidy-imports
   # "EXE",  # flake8-executable
   "YTT",    # flake8-2020

From a2ce288241b8a77523b9608c1418fb306a8d95c0 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 7 Jun 2022 21:05:15 +0200
Subject: [PATCH 067/147] Add okx stoploss on exchange (non-working for
 futures).

---
 freqtrade/exchange/exchange.py |  1 +
 freqtrade/exchange/okx.py      | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index e5f897c2a..728e997f1 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -1193,6 +1193,7 @@ class Exchange:
         try:
             params = self._get_stop_params(side=side, ordertype=ordertype,
                                            stop_price=stop_price_norm)
+            # TODO: reduceOnly is invalid for OKX stop orders
             if self.trading_mode == TradingMode.FUTURES:
                 params['reduceOnly'] = True
                 if 'stoploss_price_type' in order_types and 'stop_price_type_field' in self._ft_has:
diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index e7d658d24..048d4cad5 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -24,6 +24,8 @@ class Okx(Exchange):
         "ohlcv_candle_limit": 100,  # Warning, special case with data prior to X months
         "mark_ohlcv_timeframe": "4h",
         "funding_fee_timeframe": "8h",
+        "stoploss_order_types": {"limit": "limit"},
+        "stoploss_on_exchange": True,
     }
     _ft_has_futures: Dict = {
         "tickers_have_quoteVolume": False,
@@ -157,3 +159,26 @@ class Okx(Exchange):
 
         pair_tiers = self._leverage_tiers[pair]
         return pair_tiers[-1]['maxNotional'] / leverage
+
+    def _get_stop_params(self, side: BuySell, ordertype: str, stop_price: float) -> Dict:
+
+        params = super()._get_stop_params(side, ordertype, stop_price)
+        if self.trading_mode == TradingMode.FUTURES and self.margin_mode:
+            params['tdMode'] = self.margin_mode.value
+            params['posSide'] = self._get_posSide(side, True)
+        return params
+
+    def fetch_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
+        # TODO: This does not work until the algo-order is actually triggered!
+        return self.fetch_order(
+            order_id=order_id,
+            pair=pair,
+            params={'stop': True}
+        )
+
+    def cancel_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
+        return self.cancel_order(
+            order_id=order_id,
+            pair=pair,
+            params={'stop': True}
+        )

From df20757d2116a52265edfbe4624ed545eddb9a23 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 8 Nov 2022 19:58:39 +0100
Subject: [PATCH 068/147] OKX stop: implement proper stoploss fetching

---
 freqtrade/exchange/okx.py | 26 +++++++++++++++++++-------
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 048d4cad5..8199bd0ea 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -6,7 +6,8 @@ import ccxt
 from freqtrade.constants import BuySell
 from freqtrade.enums import CandleType, MarginMode, TradingMode
 from freqtrade.enums.pricetype import PriceType
-from freqtrade.exceptions import DDosProtection, OperationalException, TemporaryError
+from freqtrade.exceptions import (DDosProtection, OperationalException, RetryableOrderError,
+                                  TemporaryError)
 from freqtrade.exchange import Exchange, date_minus_candles
 from freqtrade.exchange.common import retrier
 
@@ -169,12 +170,23 @@ class Okx(Exchange):
         return params
 
     def fetch_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
-        # TODO: This does not work until the algo-order is actually triggered!
-        return self.fetch_order(
-            order_id=order_id,
-            pair=pair,
-            params={'stop': True}
-        )
+        params1 = {'stop': True, 'ordType': 'trigger'}
+        for method in (self._api.fetch_open_orders, self._api.fetch_closed_orders,
+                       self._api.fetch_canceled_orders):
+            try:
+                orders = method(pair, params=params1)
+                orders_f = [order for order in orders if order['id'] == order_id]
+                if orders_f:
+                    order = orders_f[0]
+                    if (order['status'] == 'closed'
+                            and order.get('info', {}).get('ordId') is not None):
+                        # Once a order triggered, we fetch the regular followup order.
+                        return self.fetch_order(order['info']['ordId'], pair)
+                    return order
+            except ccxt.BaseError:
+                logger.exception()
+        raise RetryableOrderError(
+                f'StoplossOrder not found (pair: {pair} id: {order_id}).')
 
     def cancel_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
         return self.cancel_order(

From 6c5dc7e0a9b8643dca66e0b1df79696a3eb7cd90 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 8 Nov 2022 20:24:26 +0100
Subject: [PATCH 069/147] OKX: improve stop order handling

---
 freqtrade/exchange/okx.py | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 8199bd0ea..4ff7f283b 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -1,5 +1,5 @@
 import logging
-from typing import Dict, List, Optional, Tuple
+from typing import Any, Dict, List, Optional, Tuple
 
 import ccxt
 
@@ -10,6 +10,7 @@ from freqtrade.exceptions import (DDosProtection, OperationalException, Retryabl
                                   TemporaryError)
 from freqtrade.exchange import Exchange, date_minus_candles
 from freqtrade.exchange.common import retrier
+from freqtrade.misc import safe_value_fallback2
 
 
 logger = logging.getLogger(__name__)
@@ -179,15 +180,26 @@ class Okx(Exchange):
                 if orders_f:
                     order = orders_f[0]
                     if (order['status'] == 'closed'
-                            and order.get('info', {}).get('ordId') is not None):
+                            and (real_order_id := order.get('info', {}).get('ordId')) is not None):
                         # Once a order triggered, we fetch the regular followup order.
-                        return self.fetch_order(order['info']['ordId'], pair)
+                        order_reg = self.fetch_order(real_order_id, pair)
+                        self._log_exchange_response('fetch_stoploss_order1', order_reg)
+                        order_reg['id_stop'] = order_reg['id']
+                        order_reg['id'] = order_id
+                        order_reg['type'] = 'stop'
+                        order_reg['status_stop'] = 'triggered'
+                        return order_reg
                     return order
             except ccxt.BaseError:
                 logger.exception()
         raise RetryableOrderError(
                 f'StoplossOrder not found (pair: {pair} id: {order_id}).')
 
+    def get_order_id_conditional(self, order: Dict[str, Any]) -> str:
+        if order['type'] == 'stop':
+            return safe_value_fallback2(order, order, 'id_stop', 'id')
+        return order['id']
+
     def cancel_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
         return self.cancel_order(
             order_id=order_id,

From d84ece7258a0082628f4459c278851fcac7374c9 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 9 Nov 2022 20:17:10 +0100
Subject: [PATCH 070/147] Use conditional orders for stop orders

---
 freqtrade/exchange/okx.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 4ff7f283b..5acf039cb 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -164,14 +164,17 @@ class Okx(Exchange):
 
     def _get_stop_params(self, side: BuySell, ordertype: str, stop_price: float) -> Dict:
 
-        params = super()._get_stop_params(side, ordertype, stop_price)
+        params = self._params.copy()
+        # Verify if stopPrice works for your exchange!
+        params.update({'stopLossPrice': stop_price})
+
         if self.trading_mode == TradingMode.FUTURES and self.margin_mode:
             params['tdMode'] = self.margin_mode.value
             params['posSide'] = self._get_posSide(side, True)
         return params
 
     def fetch_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
-        params1 = {'stop': True, 'ordType': 'trigger'}
+        params1 = {'stop': True, 'ordType': 'conditional'}
         for method in (self._api.fetch_open_orders, self._api.fetch_closed_orders,
                        self._api.fetch_canceled_orders):
             try:
@@ -204,5 +207,5 @@ class Okx(Exchange):
         return self.cancel_order(
             order_id=order_id,
             pair=pair,
-            params={'stop': True}
+            params={'ordType': 'conditional'}
         )

From 224f289ec8fc6d91ee32e2a3d90f4749d4da9ca0 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 12 Mar 2023 15:19:56 +0100
Subject: [PATCH 071/147] OKX Stop: Add some more okx specific logic

---
 freqtrade/exchange/exchange.py |  1 -
 freqtrade/exchange/okx.py      | 31 +++++++++++++++++++++++++++++--
 2 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index 728e997f1..e5f897c2a 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -1193,7 +1193,6 @@ class Exchange:
         try:
             params = self._get_stop_params(side=side, ordertype=ordertype,
                                            stop_price=stop_price_norm)
-            # TODO: reduceOnly is invalid for OKX stop orders
             if self.trading_mode == TradingMode.FUTURES:
                 params['reduceOnly'] = True
                 if 'stoploss_price_type' in order_types and 'stop_price_type_field' in self._ft_has:
diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 5acf039cb..5acfe7fcc 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -173,7 +173,30 @@ class Okx(Exchange):
             params['posSide'] = self._get_posSide(side, True)
         return params
 
+    def stoploss_adjust(self, stop_loss: float, order: Dict, side: str) -> bool:
+        """
+        OKX uses non-default stoploss price naming.
+        """
+        if not self._ft_has.get('stoploss_on_exchange'):
+            raise OperationalException(f"stoploss is not implemented for {self.name}.")
+
+        return (
+            order.get('stopLossPrice', None) is None
+            or ((side == "sell" and stop_loss > float(order['stopLossPrice'])) or
+                (side == "buy" and stop_loss < float(order['stopLossPrice'])))
+        )
+
     def fetch_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
+        if self._config['dry_run']:
+            return self.fetch_dry_run_order(order_id)
+
+        try:
+            params1 = {'stop': True}
+            order_reg = self._api.fetch_order(order_id, pair, params=params1)
+            self._log_exchange_response('fetch_stoploss_order1', order_reg)
+            return order_reg
+        except ccxt.OrderNotFound:
+            pass
         params1 = {'stop': True, 'ordType': 'conditional'}
         for method in (self._api.fetch_open_orders, self._api.fetch_closed_orders,
                        self._api.fetch_canceled_orders):
@@ -192,9 +215,10 @@ class Okx(Exchange):
                         order_reg['type'] = 'stop'
                         order_reg['status_stop'] = 'triggered'
                         return order_reg
+                    order['type'] = 'stoploss'
                     return order
             except ccxt.BaseError:
-                logger.exception()
+                pass
         raise RetryableOrderError(
                 f'StoplossOrder not found (pair: {pair} id: {order_id}).')
 
@@ -204,8 +228,11 @@ class Okx(Exchange):
         return order['id']
 
     def cancel_stoploss_order(self, order_id: str, pair: str, params: Dict = {}) -> Dict:
+        params1 = {'stop': True}
+        # 'ordType': 'conditional'
+        #
         return self.cancel_order(
             order_id=order_id,
             pair=pair,
-            params={'ordType': 'conditional'}
+            params=params1,
         )

From a7c7f720c0791d3ea2cdd5655626a8eab827813c Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 19 Mar 2023 20:03:34 +0100
Subject: [PATCH 072/147] Add test for okx fetch_stop

---
 freqtrade/exchange/okx.py  |  2 +-
 tests/exchange/test_okx.py | 54 +++++++++++++++++++++++++++++++++++++-
 2 files changed, 54 insertions(+), 2 deletions(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 5acfe7fcc..7de110acf 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -212,7 +212,7 @@ class Okx(Exchange):
                         self._log_exchange_response('fetch_stoploss_order1', order_reg)
                         order_reg['id_stop'] = order_reg['id']
                         order_reg['id'] = order_id
-                        order_reg['type'] = 'stop'
+                        order_reg['type'] = 'stoploss'
                         order_reg['status_stop'] = 'triggered'
                         return order_reg
                     order['type'] = 'stoploss'
diff --git a/tests/exchange/test_okx.py b/tests/exchange/test_okx.py
index fce77f4c7..30e23619b 100644
--- a/tests/exchange/test_okx.py
+++ b/tests/exchange/test_okx.py
@@ -2,11 +2,13 @@ from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from unittest.mock import MagicMock, PropertyMock
 
+import ccxt
 import pytest
 
 from freqtrade.enums import CandleType, MarginMode, TradingMode
+from freqtrade.exceptions import RetryableOrderError
 from freqtrade.exchange.exchange import timeframe_to_minutes
-from tests.conftest import get_mock_coro, get_patched_exchange, log_has
+from tests.conftest import EXMS, get_mock_coro, get_patched_exchange, log_has
 from tests.exchange.test_exchange import ccxt_exceptionhandlers
 
 
@@ -476,3 +478,53 @@ def test_load_leverage_tiers_okx(default_conf, mocker, markets, tmpdir, caplog,
     exchange.load_leverage_tiers()
 
     assert log_has(logmsg, caplog)
+
+
+@pytest.mark.usefixtures("init_persistence")
+def test_fetch_stoploss_order_okx(default_conf, mocker):
+    default_conf['dry_run'] = False
+    api_mock = MagicMock()
+    api_mock.fetch_order = MagicMock()
+
+    exchange = get_patched_exchange(mocker, default_conf, api_mock, id='okx')
+
+    exchange.fetch_stoploss_order('1234', 'ETH/BTC')
+    assert api_mock.fetch_order.call_count == 1
+    assert api_mock.fetch_order.call_args_list[0][0][0] == '1234'
+    assert api_mock.fetch_order.call_args_list[0][0][1] == 'ETH/BTC'
+    assert api_mock.fetch_order.call_args_list[0][1]['params'] == {'stop': True}
+
+    api_mock.fetch_order = MagicMock(side_effect=ccxt.OrderNotFound)
+    api_mock.fetch_open_orders = MagicMock(return_value=[])
+    api_mock.fetch_closed_orders = MagicMock(return_value=[])
+    api_mock.fetch_canceled_orders = MagicMock(creturn_value=[])
+
+    with pytest.raises(RetryableOrderError):
+        exchange.fetch_stoploss_order('1234', 'ETH/BTC')
+    assert api_mock.fetch_order.call_count == 1
+    assert api_mock.fetch_open_orders.call_count == 1
+    assert api_mock.fetch_closed_orders.call_count == 1
+    assert api_mock.fetch_canceled_orders.call_count == 1
+
+    api_mock.fetch_order.reset_mock()
+    api_mock.fetch_open_orders.reset_mock()
+    api_mock.fetch_closed_orders.reset_mock()
+    api_mock.fetch_canceled_orders.reset_mock()
+
+    api_mock.fetch_closed_orders = MagicMock(return_value=[
+        {
+            'id': '1234',
+            'status': 'closed',
+            'info': {'ordId': '123455'}
+        }
+    ])
+    mocker.patch(f"{EXMS}.fetch_order", MagicMock(return_value={'id': '123455'}))
+    resp = exchange.fetch_stoploss_order('1234', 'ETH/BTC')
+    assert api_mock.fetch_order.call_count == 1
+    assert api_mock.fetch_open_orders.call_count == 1
+    assert api_mock.fetch_closed_orders.call_count == 1
+    assert api_mock.fetch_canceled_orders.call_count == 0
+
+    assert resp['id'] == '1234'
+    assert resp['id_stop'] == '123455'
+    assert resp['type'] == 'stoploss'

From fb0e824a83fb953b4d6d61a215df72e1cd6b74b9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:56:45 +0000
Subject: [PATCH 073/147] Bump nbconvert from 7.2.9 to 7.2.10

Bumps [nbconvert](https://github.com/jupyter/nbconvert) from 7.2.9 to 7.2.10.
- [Release notes](https://github.com/jupyter/nbconvert/releases)
- [Changelog](https://github.com/jupyter/nbconvert/blob/main/CHANGELOG.md)
- [Commits](https://github.com/jupyter/nbconvert/compare/v7.2.9...v7.2.10)

---
updated-dependencies:
- dependency-name: nbconvert
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 6d076777f..0bdb6702e 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -22,7 +22,7 @@ time-machine==2.9.0
 httpx==0.23.3
 
 # Convert jupyter notebooks to markdown documents
-nbconvert==7.2.9
+nbconvert==7.2.10
 
 # mypy types
 types-cachetools==5.3.0.4

From 5ade5777e8cbef0619c3d5b33041401b082be93a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:56:49 +0000
Subject: [PATCH 074/147] Bump filelock from 3.9.0 to 3.10.0

Bumps [filelock](https://github.com/tox-dev/py-filelock) from 3.9.0 to 3.10.0.
- [Release notes](https://github.com/tox-dev/py-filelock/releases)
- [Changelog](https://github.com/tox-dev/py-filelock/blob/main/docs/changelog.rst)
- [Commits](https://github.com/tox-dev/py-filelock/compare/3.9.0...3.10.0)

---
updated-dependencies:
- dependency-name: filelock
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-hyperopt.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-hyperopt.txt b/requirements-hyperopt.txt
index 904b5d661..4d86da2b6 100644
--- a/requirements-hyperopt.txt
+++ b/requirements-hyperopt.txt
@@ -5,5 +5,5 @@
 scipy==1.10.1
 scikit-learn==1.1.3
 scikit-optimize==0.9.0
-filelock==3.9.0
+filelock==3.10.0
 progressbar2==4.2.0

From 47e84ad106a34e3049a8a5412d2fb7155cff5a44 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:56:54 +0000
Subject: [PATCH 075/147] Bump python-rapidjson from 1.9 to 1.10

Bumps [python-rapidjson](https://github.com/python-rapidjson/python-rapidjson) from 1.9 to 1.10.
- [Release notes](https://github.com/python-rapidjson/python-rapidjson/releases)
- [Changelog](https://github.com/python-rapidjson/python-rapidjson/blob/master/CHANGES.rst)
- [Commits](https://github.com/python-rapidjson/python-rapidjson/compare/v1.9...v1.10)

---
updated-dependencies:
- dependency-name: python-rapidjson
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 9e17424f5..311285217 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ pyarrow==11.0.0; platform_machine != 'armv7l'
 py_find_1st==1.1.5
 
 # Load ticker files 30% faster
-python-rapidjson==1.9
+python-rapidjson==1.10
 # Properly format api responses
 orjson==3.8.7
 

From a43502093dc18897ba4dfd2110cb5b556f1a3482 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:57:07 +0000
Subject: [PATCH 076/147] Bump sqlalchemy from 2.0.5.post1 to 2.0.7

Bumps [sqlalchemy](https://github.com/sqlalchemy/sqlalchemy) from 2.0.5.post1 to 2.0.7.
- [Release notes](https://github.com/sqlalchemy/sqlalchemy/releases)
- [Changelog](https://github.com/sqlalchemy/sqlalchemy/blob/main/CHANGES.rst)
- [Commits](https://github.com/sqlalchemy/sqlalchemy/commits)

---
updated-dependencies:
- dependency-name: sqlalchemy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 9e17424f5..36861d029 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,7 +5,7 @@ pandas-ta==0.3.14b
 ccxt==2.9.12
 cryptography==39.0.2
 aiohttp==3.8.4
-SQLAlchemy==2.0.5.post1
+SQLAlchemy==2.0.7
 python-telegram-bot==13.15
 arrow==1.2.3
 cachetools==4.2.2

From 7d1559f319ae3987fa155e6b85cd1224f11e452c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:57:13 +0000
Subject: [PATCH 077/147] Bump mkdocs-material from 9.1.2 to 9.1.3

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.2 to 9.1.3.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.2...9.1.3)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 docs/requirements-docs.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
index d384a7ec5..110373844 100644
--- a/docs/requirements-docs.txt
+++ b/docs/requirements-docs.txt
@@ -1,6 +1,6 @@
 markdown==3.3.7
 mkdocs==1.4.2
-mkdocs-material==9.1.2
+mkdocs-material==9.1.3
 mdx_truly_sane_lists==1.3
 pymdown-extensions==9.10
 jinja2==3.1.2

From fc7c8cce3cbfea9c905ecc8a503011031f7839c4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:57:28 +0000
Subject: [PATCH 078/147] Bump uvicorn from 0.21.0 to 0.21.1

Bumps [uvicorn](https://github.com/encode/uvicorn) from 0.21.0 to 0.21.1.
- [Release notes](https://github.com/encode/uvicorn/releases)
- [Changelog](https://github.com/encode/uvicorn/blob/master/CHANGELOG.md)
- [Commits](https://github.com/encode/uvicorn/compare/0.21.0...0.21.1)

---
updated-dependencies:
- dependency-name: uvicorn
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 9e17424f5..4eb05db12 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -36,7 +36,7 @@ sdnotify==0.3.2
 # API Server
 fastapi==0.94.0
 pydantic==1.10.6
-uvicorn==0.21.0
+uvicorn==0.21.1
 pyjwt==2.6.0
 aiofiles==23.1.0
 psutil==5.9.4

From 4543a1fe02a31904afca5016035f89571f5ba3da Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:57:33 +0000
Subject: [PATCH 079/147] Bump pre-commit from 3.1.1 to 3.2.0

Bumps [pre-commit](https://github.com/pre-commit/pre-commit) from 3.1.1 to 3.2.0.
- [Release notes](https://github.com/pre-commit/pre-commit/releases)
- [Changelog](https://github.com/pre-commit/pre-commit/blob/main/CHANGELOG.md)
- [Commits](https://github.com/pre-commit/pre-commit/compare/v3.1.1...v3.2.0)

---
updated-dependencies:
- dependency-name: pre-commit
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 6d076777f..c0dc815e2 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -9,7 +9,7 @@
 coveralls==3.3.1
 ruff==0.0.255
 mypy==1.1.1
-pre-commit==3.1.1
+pre-commit==3.2.0
 pytest==7.2.2
 pytest-asyncio==0.20.3
 pytest-cov==4.0.0

From 29b9be9bd0c14199aaf0c36a59207c06a6c3c79c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:57:47 +0000
Subject: [PATCH 080/147] Bump ruff from 0.0.255 to 0.0.257

Bumps [ruff](https://github.com/charliermarsh/ruff) from 0.0.255 to 0.0.257.
- [Release notes](https://github.com/charliermarsh/ruff/releases)
- [Changelog](https://github.com/charliermarsh/ruff/blob/main/BREAKING_CHANGES.md)
- [Commits](https://github.com/charliermarsh/ruff/compare/v0.0.255...v0.0.257)

---
updated-dependencies:
- dependency-name: ruff
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 6d076777f..8780a6d22 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -7,7 +7,7 @@
 -r docs/requirements-docs.txt
 
 coveralls==3.3.1
-ruff==0.0.255
+ruff==0.0.257
 mypy==1.1.1
 pre-commit==3.1.1
 pytest==7.2.2

From c78342b1943cf58bc2e78a94165d5281d9205cfa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 03:58:15 +0000
Subject: [PATCH 081/147] Bump pypa/gh-action-pypi-publish from 1.7.1 to 1.8.1

Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.7.1 to 1.8.1.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.7.1...v1.8.1)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 663cfb1be..904387fb2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -425,7 +425,7 @@ jobs:
         python setup.py sdist bdist_wheel
 
     - name: Publish to PyPI (Test)
-      uses: pypa/gh-action-pypi-publish@v1.7.1
+      uses: pypa/gh-action-pypi-publish@v1.8.1
       if: (github.event_name == 'release')
       with:
         user: __token__
@@ -433,7 +433,7 @@ jobs:
         repository_url: https://test.pypi.org/legacy/
 
     - name: Publish to PyPI
-      uses: pypa/gh-action-pypi-publish@v1.7.1
+      uses: pypa/gh-action-pypi-publish@v1.8.1
       if: (github.event_name == 'release')
       with:
         user: __token__

From dcca51985d89d5b39e0497dd75249b2387639b2a Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 06:27:39 +0100
Subject: [PATCH 082/147] sqlalchemy - pre-commit

---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index bc2e0bc0d..ca3da8e90 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -18,7 +18,7 @@ repos:
           - types-requests==2.28.11.15
           - types-tabulate==0.9.0.1
           - types-python-dateutil==2.8.19.10
-          - SQLAlchemy==2.0.5.post1
+          - SQLAlchemy==2.0.7
         # stages: [push]
 
   - repo: https://github.com/pycqa/isort

From 2de5a59d890e2345eb1a935554b3453ab4047416 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 06:38:42 +0100
Subject: [PATCH 083/147] Add test for dry-run fetching

---
 tests/exchange/test_okx.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/tests/exchange/test_okx.py b/tests/exchange/test_okx.py
index 30e23619b..2f862adda 100644
--- a/tests/exchange/test_okx.py
+++ b/tests/exchange/test_okx.py
@@ -528,3 +528,19 @@ def test_fetch_stoploss_order_okx(default_conf, mocker):
     assert resp['id'] == '1234'
     assert resp['id_stop'] == '123455'
     assert resp['type'] == 'stoploss'
+
+    default_conf['dry_run'] = True
+    exchange = get_patched_exchange(mocker, default_conf, api_mock, id='okx')
+    dro_mock = mocker.patch(f"{EXMS}.fetch_dry_run_order", MagicMock(return_value={'id': '123455'}))
+
+    api_mock.fetch_order.reset_mock()
+    api_mock.fetch_open_orders.reset_mock()
+    api_mock.fetch_closed_orders.reset_mock()
+    api_mock.fetch_canceled_orders.reset_mock()
+    resp = exchange.fetch_stoploss_order('1234', 'ETH/BTC')
+
+    assert api_mock.fetch_order.call_count == 0
+    assert api_mock.fetch_open_orders.call_count == 0
+    assert api_mock.fetch_closed_orders.call_count == 0
+    assert api_mock.fetch_canceled_orders.call_count == 0
+    assert dro_mock.call_count == 1

From 4690244673175e708ed097ca22edcc4e9e432281 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 06:40:57 +0100
Subject: [PATCH 084/147] Enable okx stop-price types

---
 tests/exchange/test_exchange.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/exchange/test_exchange.py b/tests/exchange/test_exchange.py
index 7c48f1c9d..6e15abaf4 100644
--- a/tests/exchange/test_exchange.py
+++ b/tests/exchange/test_exchange.py
@@ -1039,9 +1039,9 @@ def test_validate_ordertypes(default_conf, mocker):
     ('bybit', 'last', True),
     ('bybit', 'mark', True),
     ('bybit', 'index', True),
-    # ('okx', 'last', True),
-    # ('okx', 'mark', True),
-    # ('okx', 'index', True),
+    ('okx', 'last', True),
+    ('okx', 'mark', True),
+    ('okx', 'index', True),
     ('gate', 'last', True),
     ('gate', 'mark', True),
     ('gate', 'index', True),

From 54d8aa7782160d5cf0da4074bf90e134205885fb Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 06:46:00 +0100
Subject: [PATCH 085/147] Test stoploss_adjust okx

---
 tests/exchange/test_okx.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tests/exchange/test_okx.py b/tests/exchange/test_okx.py
index 2f862adda..3b97e03f4 100644
--- a/tests/exchange/test_okx.py
+++ b/tests/exchange/test_okx.py
@@ -544,3 +544,18 @@ def test_fetch_stoploss_order_okx(default_conf, mocker):
     assert api_mock.fetch_closed_orders.call_count == 0
     assert api_mock.fetch_canceled_orders.call_count == 0
     assert dro_mock.call_count == 1
+
+
+@pytest.mark.parametrize('sl1,sl2,sl3,side', [
+    (1501, 1499, 1501, "sell"),
+    (1499, 1501, 1499, "buy")
+])
+def test_stoploss_adjust_okx(mocker, default_conf, sl1, sl2, sl3, side):
+    exchange = get_patched_exchange(mocker, default_conf, id='okx')
+    order = {
+        'type': 'stoploss',
+        'price': 1500,
+        'stopLossPrice': 1500,
+    }
+    assert exchange.stoploss_adjust(sl1, order, side=side)
+    assert not exchange.stoploss_adjust(sl2, order, side=side)

From 8d649988ca4cdb1eb558545c8025bfedd6accb41 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 05:47:47 +0000
Subject: [PATCH 086/147] Bump fastapi from 0.94.0 to 0.95.0

Bumps [fastapi](https://github.com/tiangolo/fastapi) from 0.94.0 to 0.95.0.
- [Release notes](https://github.com/tiangolo/fastapi/releases)
- [Commits](https://github.com/tiangolo/fastapi/compare/0.94.0...0.95.0)

---
updated-dependencies:
- dependency-name: fastapi
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 664d1752e..201c46106 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -34,7 +34,7 @@ orjson==3.8.7
 sdnotify==0.3.2
 
 # API Server
-fastapi==0.94.0
+fastapi==0.95.0
 pydantic==1.10.6
 uvicorn==0.21.1
 pyjwt==2.6.0

From 3175121030b477514eb603a7ec2ebea5e5673e34 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 05:47:55 +0000
Subject: [PATCH 087/147] Bump ast-comments from 1.0.0 to 1.0.1

Bumps [ast-comments](https://github.com/t3rn0/ast-comments) from 1.0.0 to 1.0.1.
- [Release notes](https://github.com/t3rn0/ast-comments/releases)
- [Commits](https://github.com/t3rn0/ast-comments/compare/1.0.0...1.0.1)

---
updated-dependencies:
- dependency-name: ast-comments
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 664d1752e..4251c879a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -56,4 +56,4 @@ schedule==1.1.0
 websockets==10.4
 janus==1.0.0
 
-ast-comments==1.0.0
+ast-comments==1.0.1

From cb1f971d4bb1bd9559529b6c5734acfc55a773a6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 06:39:13 +0000
Subject: [PATCH 088/147] Bump ccxt from 2.9.12 to 3.0.23

Bumps [ccxt](https://github.com/ccxt/ccxt) from 2.9.12 to 3.0.23.
- [Release notes](https://github.com/ccxt/ccxt/releases)
- [Changelog](https://github.com/ccxt/ccxt/blob/master/CHANGELOG.md)
- [Commits](https://github.com/ccxt/ccxt/compare/2.9.12...3.0.23)

---
updated-dependencies:
- dependency-name: ccxt
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index de38d50c3..6f16c71d0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,7 @@ numpy==1.24.2
 pandas==1.5.3
 pandas-ta==0.3.14b
 
-ccxt==2.9.12
+ccxt==3.0.23
 cryptography==39.0.2
 aiohttp==3.8.4
 SQLAlchemy==2.0.7

From a4e4310d400b73c15236ebaab36dfa7876dc9330 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 Mar 2023 07:11:18 +0000
Subject: [PATCH 089/147] Bump pytest-asyncio from 0.20.3 to 0.21.0

Bumps [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) from 0.20.3 to 0.21.0.
- [Release notes](https://github.com/pytest-dev/pytest-asyncio/releases)
- [Commits](https://github.com/pytest-dev/pytest-asyncio/compare/v0.20.3...v0.21.0)

---
updated-dependencies:
- dependency-name: pytest-asyncio
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 25e26f47c..8312e2820 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -11,7 +11,7 @@ ruff==0.0.257
 mypy==1.1.1
 pre-commit==3.2.0
 pytest==7.2.2
-pytest-asyncio==0.20.3
+pytest-asyncio==0.21.0
 pytest-cov==4.0.0
 pytest-mock==3.10.0
 pytest-random-order==1.1.0

From 4f4bfdac4d2491277decca93cdd30aec9ec29a1a Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 09:00:00 +0100
Subject: [PATCH 090/147] Adjustments to okx stoploss

---
 freqtrade/exchange/okx.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 7de110acf..3110d8189 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -32,7 +32,7 @@ class Okx(Exchange):
     _ft_has_futures: Dict = {
         "tickers_have_quoteVolume": False,
         "fee_cost_in_contracts": True,
-        "stop_price_type_field": "tpTriggerPxType",
+        "stop_price_type_field": "slTriggerPxType",
         "stop_price_type_value_mapping": {
             PriceType.LAST: "last",
             PriceType.MARK: "index",
@@ -193,7 +193,7 @@ class Okx(Exchange):
         try:
             params1 = {'stop': True}
             order_reg = self._api.fetch_order(order_id, pair, params=params1)
-            self._log_exchange_response('fetch_stoploss_order1', order_reg)
+            self._log_exchange_response('fetch_stoploss_order', order_reg)
             return order_reg
         except ccxt.OrderNotFound:
             pass

From 639987cbabc8ae969f280639ffa856af99402064 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 18:19:17 +0100
Subject: [PATCH 091/147] Prevent parameter reuse

---
 freqtrade/exchange/okx.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 3110d8189..162630ea5 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -197,11 +197,11 @@ class Okx(Exchange):
             return order_reg
         except ccxt.OrderNotFound:
             pass
-        params1 = {'stop': True, 'ordType': 'conditional'}
+        params2 = {'stop': True, 'ordType': 'conditional'}
         for method in (self._api.fetch_open_orders, self._api.fetch_closed_orders,
                        self._api.fetch_canceled_orders):
             try:
-                orders = method(pair, params=params1)
+                orders = method(pair, params=params2)
                 orders_f = [order for order in orders if order['id'] == order_id]
                 if orders_f:
                     order = orders_f[0]

From 97c420b2df8c2fe49c5c14b264836b1af58111f7 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 20 Mar 2023 19:27:48 +0100
Subject: [PATCH 092/147] Add explicit test for okx lev_prep

---
 freqtrade/exchange/okx.py  |  1 -
 tests/exchange/test_okx.py | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 162630ea5..1b9134be3 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -128,7 +128,6 @@ class Okx(Exchange):
     def _lev_prep(self, pair: str, leverage: float, side: BuySell):
         if self.trading_mode != TradingMode.SPOT and self.margin_mode is not None:
             try:
-                # TODO-lev: Test me properly (check mgnMode passed)
                 res = self._api.set_leverage(
                     leverage=leverage,
                     symbol=pair,
diff --git a/tests/exchange/test_okx.py b/tests/exchange/test_okx.py
index 3b97e03f4..7a3fa22f0 100644
--- a/tests/exchange/test_okx.py
+++ b/tests/exchange/test_okx.py
@@ -480,6 +480,38 @@ def test_load_leverage_tiers_okx(default_conf, mocker, markets, tmpdir, caplog,
     assert log_has(logmsg, caplog)
 
 
+def test__set_leverage_okx(mocker, default_conf):
+
+    api_mock = MagicMock()
+    api_mock.set_leverage = MagicMock()
+    type(api_mock).has = PropertyMock(return_value={'setLeverage': True})
+    default_conf['dry_run'] = False
+    default_conf['trading_mode'] = TradingMode.FUTURES
+    default_conf['margin_mode'] = MarginMode.ISOLATED
+
+    exchange = get_patched_exchange(mocker, default_conf, api_mock, id="okx")
+    exchange._lev_prep('BTC/USDT:USDT', 3.2, 'buy')
+    assert api_mock.set_leverage.call_count == 1
+    # Leverage is rounded to 3.
+    assert api_mock.set_leverage.call_args_list[0][1]['leverage'] == 3.2
+    assert api_mock.set_leverage.call_args_list[0][1]['symbol'] == 'BTC/USDT:USDT'
+    assert api_mock.set_leverage.call_args_list[0][1]['params'] == {
+        'mgnMode': 'isolated',
+        'posSide': 'net'}
+
+    ccxt_exceptionhandlers(
+        mocker,
+        default_conf,
+        api_mock,
+        "okx",
+        "_lev_prep",
+        "set_leverage",
+        pair="XRP/USDT:USDT",
+        leverage=5.0,
+        side='buy'
+    )
+
+
 @pytest.mark.usefixtures("init_persistence")
 def test_fetch_stoploss_order_okx(default_conf, mocker):
     default_conf['dry_run'] = False

From e16db814fad1b55c168965027185b68a6f94b083 Mon Sep 17 00:00:00 2001
From: Joe Schr <8218910+TheJoeSchr@users.noreply.github.com>
Date: Tue, 21 Mar 2023 17:52:14 +0100
Subject: [PATCH 093/147] featherdatahandler: implement
 trades_store/_trades_load

---
 freqtrade/data/history/featherdatahandler.py |  26 ++---
 tests/data/test_datahandler.py               | 108 +++++++++++++++----
 tests/testdata/XRP_ETH-trades.feather        | Bin 0 -> 374570 bytes
 3 files changed, 102 insertions(+), 32 deletions(-)
 create mode 100644 tests/testdata/XRP_ETH-trades.feather

diff --git a/freqtrade/data/history/featherdatahandler.py b/freqtrade/data/history/featherdatahandler.py
index 22a6805e7..87c1d0886 100644
--- a/freqtrade/data/history/featherdatahandler.py
+++ b/freqtrade/data/history/featherdatahandler.py
@@ -4,8 +4,9 @@ from typing import Optional
 from pandas import DataFrame, read_feather, to_datetime
 
 from freqtrade.configuration import TimeRange
-from freqtrade.constants import DEFAULT_DATAFRAME_COLUMNS, TradeList
+from freqtrade.constants import DEFAULT_DATAFRAME_COLUMNS, TradeList, DEFAULT_TRADES_COLUMNS
 from freqtrade.enums import CandleType
+from freqtrade.data.converter import trades_dict_to_list
 
 from .idatahandler import IDataHandler
 
@@ -29,7 +30,8 @@ class FeatherDataHandler(IDataHandler):
         :param candle_type: Any of the enum CandleType (must match trading mode!)
         :return: None
         """
-        filename = self._pair_data_filename(self._datadir, pair, timeframe, candle_type)
+        filename = self._pair_data_filename(
+            self._datadir, pair, timeframe, candle_type)
         self.create_dir_if_needed(filename)
 
         data.reset_index(drop=True).loc[:, self._columns].to_feather(
@@ -92,12 +94,11 @@ class FeatherDataHandler(IDataHandler):
         :param data: List of Lists containing trade data,
                      column sequence as in DEFAULT_TRADES_COLUMNS
         """
-        # filename = self._pair_trades_filename(self._datadir, pair)
+        filename = self._pair_trades_filename(self._datadir, pair)
+        self.create_dir_if_needed(filename)
 
-        raise NotImplementedError()
-        # array = pa.array(data)
-        # array
-        # feather.write_feather(data, filename)
+        tradesdata = DataFrame(data, columns=DEFAULT_TRADES_COLUMNS)
+        tradesdata.to_feather(filename, compression_level=9, compression='lz4')
 
     def trades_append(self, pair: str, data: TradeList):
         """
@@ -116,14 +117,13 @@ class FeatherDataHandler(IDataHandler):
         :param timerange: Timerange to load trades for - currently not implemented
         :return: List of trades
         """
-        raise NotImplementedError()
-        # filename = self._pair_trades_filename(self._datadir, pair)
-        # tradesdata = misc.file_load_json(filename)
+        filename = self._pair_trades_filename(self._datadir, pair)
+        if not filename.exists():
+            return []
 
-        # if not tradesdata:
-        #     return []
+        tradesdata = read_feather(filename)
 
-        # return tradesdata
+        return tradesdata.values.tolist()
 
     @classmethod
     def _get_file_extension(cls):
diff --git a/tests/data/test_datahandler.py b/tests/data/test_datahandler.py
index f673ede6e..2c5241367 100644
--- a/tests/data/test_datahandler.py
+++ b/tests/data/test_datahandler.py
@@ -20,25 +20,31 @@ from tests.conftest import log_has, log_has_re
 
 
 def test_datahandler_ohlcv_get_pairs(testdatadir):
-    pairs = JsonDataHandler.ohlcv_get_pairs(testdatadir, '5m', candle_type=CandleType.SPOT)
+    pairs = JsonDataHandler.ohlcv_get_pairs(
+        testdatadir, '5m', candle_type=CandleType.SPOT)
     # Convert to set to avoid failures due to sorting
     assert set(pairs) == {'UNITTEST/BTC', 'XLM/BTC', 'ETH/BTC', 'TRX/BTC', 'LTC/BTC',
                           'XMR/BTC', 'ZEC/BTC', 'ADA/BTC', 'ETC/BTC', 'NXT/BTC',
                           'DASH/BTC', 'XRP/ETH'}
 
-    pairs = JsonGzDataHandler.ohlcv_get_pairs(testdatadir, '8m', candle_type=CandleType.SPOT)
+    pairs = JsonGzDataHandler.ohlcv_get_pairs(
+        testdatadir, '8m', candle_type=CandleType.SPOT)
     assert set(pairs) == {'UNITTEST/BTC'}
 
-    pairs = HDF5DataHandler.ohlcv_get_pairs(testdatadir, '5m', candle_type=CandleType.SPOT)
+    pairs = HDF5DataHandler.ohlcv_get_pairs(
+        testdatadir, '5m', candle_type=CandleType.SPOT)
     assert set(pairs) == {'UNITTEST/BTC'}
 
-    pairs = JsonDataHandler.ohlcv_get_pairs(testdatadir, '1h', candle_type=CandleType.MARK)
+    pairs = JsonDataHandler.ohlcv_get_pairs(
+        testdatadir, '1h', candle_type=CandleType.MARK)
     assert set(pairs) == {'UNITTEST/USDT:USDT', 'XRP/USDT:USDT'}
 
-    pairs = JsonGzDataHandler.ohlcv_get_pairs(testdatadir, '1h', candle_type=CandleType.FUTURES)
+    pairs = JsonGzDataHandler.ohlcv_get_pairs(
+        testdatadir, '1h', candle_type=CandleType.FUTURES)
     assert set(pairs) == {'XRP/USDT:USDT'}
 
-    pairs = HDF5DataHandler.ohlcv_get_pairs(testdatadir, '1h', candle_type=CandleType.MARK)
+    pairs = HDF5DataHandler.ohlcv_get_pairs(
+        testdatadir, '1h', candle_type=CandleType.MARK)
     assert set(pairs) == {'UNITTEST/USDT:USDT'}
 
 
@@ -79,7 +85,8 @@ def test_rebuild_pair_from_filename(input, expected):
 
 
 def test_datahandler_ohlcv_get_available_data(testdatadir):
-    paircombs = JsonDataHandler.ohlcv_get_available_data(testdatadir, TradingMode.SPOT)
+    paircombs = JsonDataHandler.ohlcv_get_available_data(
+        testdatadir, TradingMode.SPOT)
     # Convert to set to avoid failures due to sorting
     assert set(paircombs) == {
         ('UNITTEST/BTC', '5m', CandleType.SPOT),
@@ -101,7 +108,8 @@ def test_datahandler_ohlcv_get_available_data(testdatadir):
         ('NOPAIR/XXX', '4m', CandleType.SPOT),
     }
 
-    paircombs = JsonDataHandler.ohlcv_get_available_data(testdatadir, TradingMode.FUTURES)
+    paircombs = JsonDataHandler.ohlcv_get_available_data(
+        testdatadir, TradingMode.FUTURES)
     # Convert to set to avoid failures due to sorting
     assert set(paircombs) == {
         ('UNITTEST/USDT:USDT', '1h', 'mark'),
@@ -112,9 +120,11 @@ def test_datahandler_ohlcv_get_available_data(testdatadir):
         ('XRP/USDT:USDT', '8h', 'funding_rate'),
     }
 
-    paircombs = JsonGzDataHandler.ohlcv_get_available_data(testdatadir, TradingMode.SPOT)
+    paircombs = JsonGzDataHandler.ohlcv_get_available_data(
+        testdatadir, TradingMode.SPOT)
     assert set(paircombs) == {('UNITTEST/BTC', '8m', CandleType.SPOT)}
-    paircombs = HDF5DataHandler.ohlcv_get_available_data(testdatadir, TradingMode.SPOT)
+    paircombs = HDF5DataHandler.ohlcv_get_available_data(
+        testdatadir, TradingMode.SPOT)
     assert set(paircombs) == {('UNITTEST/BTC', '5m', CandleType.SPOT)}
 
 
@@ -252,7 +262,7 @@ def test_datahandler__check_empty_df(testdatadir, caplog):
     assert log_has_re(expected_text, caplog)
 
 
-@pytest.mark.parametrize('datahandler', ['feather', 'parquet'])
+@pytest.mark.parametrize('datahandler', ['parquet'])
 def test_datahandler_trades_not_supported(datahandler, testdatadir, ):
     dh = get_datahandler(testdatadir, datahandler)
     with pytest.raises(NotImplementedError):
@@ -406,18 +416,21 @@ def test_hdf5datahandler_ohlcv_load_and_resave(
 
     assert not ohlcv[ohlcv['date'] < startdt].empty
 
-    timerange = TimeRange.parse_timerange(f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
+    timerange = TimeRange.parse_timerange(
+        f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
 
     # Call private function to ensure timerange is filtered in hdf5
     ohlcv = dh._ohlcv_load(pair, timeframe, timerange, candle_type=candle_type)
-    ohlcv1 = dh1._ohlcv_load('UNITTEST/NEW', timeframe, timerange, candle_type=candle_type)
+    ohlcv1 = dh1._ohlcv_load('UNITTEST/NEW', timeframe,
+                             timerange, candle_type=candle_type)
     assert len(ohlcv) == len(ohlcv1)
     assert ohlcv.equals(ohlcv1)
     assert ohlcv[ohlcv['date'] < startdt].empty
     assert ohlcv[ohlcv['date'] > enddt].empty
 
     # Try loading inexisting file
-    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe, candle_type=candle_type)
+    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe,
+                          candle_type=candle_type)
     assert ohlcv.empty
 
 
@@ -452,7 +465,8 @@ def test_generic_datahandler_ohlcv_load_and_resave(
     # Get data to test
     dh = get_datahandler(testdatadir, datahandler)
 
-    file = tmpdir2 / f"UNITTEST_NEW-{timeframe}{candle_append}.{dh._get_file_extension()}"
+    file = tmpdir2 / \
+        f"UNITTEST_NEW-{timeframe}{candle_append}.{dh._get_file_extension()}"
     assert not file.is_file()
 
     dh1 = get_datahandler(tmpdir1, datahandler)
@@ -461,11 +475,14 @@ def test_generic_datahandler_ohlcv_load_and_resave(
 
     assert not ohlcv[ohlcv['date'] < startdt].empty
 
-    timerange = TimeRange.parse_timerange(f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
+    timerange = TimeRange.parse_timerange(
+        f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
 
-    ohlcv = dhbase.ohlcv_load(pair, timeframe, timerange=timerange, candle_type=candle_type)
+    ohlcv = dhbase.ohlcv_load(
+        pair, timeframe, timerange=timerange, candle_type=candle_type)
     if datahandler == 'hdf5':
-        ohlcv1 = dh1._ohlcv_load('UNITTEST/NEW', timeframe, timerange, candle_type=candle_type)
+        ohlcv1 = dh1._ohlcv_load(
+            'UNITTEST/NEW', timeframe, timerange, candle_type=candle_type)
         if candle_type == 'mark':
             ohlcv1['volume'] = 0.0
     else:
@@ -478,7 +495,8 @@ def test_generic_datahandler_ohlcv_load_and_resave(
     assert ohlcv[ohlcv['date'] > enddt].empty
 
     # Try loading inexisting file
-    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe, candle_type=candle_type)
+    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe,
+                          candle_type=candle_type)
     assert ohlcv.empty
 
 
@@ -496,6 +514,58 @@ def test_hdf5datahandler_ohlcv_purge(mocker, testdatadir):
     assert unlinkmock.call_count == 2
 
 
+def test_featherdatahandler_trades_load(testdatadir):
+    dh = get_datahandler(testdatadir, 'feather')
+    trades = dh.trades_load('XRP/ETH')
+    assert isinstance(trades, list)
+    assert trades[0][0] == 1570752011620
+    assert trades[-1][-1] == 0.1986231
+
+    trades1 = dh.trades_load('UNITTEST/NONEXIST')
+    assert trades1 == []
+
+
+def test_featherdatahandler_trades_store(testdatadir, tmpdir):
+    tmpdir1 = Path(tmpdir)
+    dh = get_datahandler(testdatadir, 'feather')
+    trades = dh.trades_load('XRP/ETH')
+
+    dh1 = get_datahandler(tmpdir1, 'feather')
+    dh1.trades_store('XRP/NEW', trades)
+    file = tmpdir1 / 'XRP_NEW-trades.feather'
+    assert file.is_file()
+    # Load trades back
+    trades_new = dh1.trades_load('XRP/NEW')
+
+    assert len(trades_new) == len(trades)
+    assert trades[0][0] == trades_new[0][0]
+    assert trades[0][1] == trades_new[0][1]
+    # assert trades[0][2] == trades_new[0][2]  # This is nan - so comparison does not make sense
+    assert trades[0][3] == trades_new[0][3]
+    assert trades[0][4] == trades_new[0][4]
+    assert trades[0][5] == trades_new[0][5]
+    assert trades[0][6] == trades_new[0][6]
+    assert trades[-1][0] == trades_new[-1][0]
+    assert trades[-1][1] == trades_new[-1][1]
+    # assert trades[-1][2] == trades_new[-1][2]  # This is nan - so comparison does not make sense
+    assert trades[-1][3] == trades_new[-1][3]
+    assert trades[-1][4] == trades_new[-1][4]
+    assert trades[-1][5] == trades_new[-1][5]
+    assert trades[-1][6] == trades_new[-1][6]
+
+
+def test_featherdatahandler_trades_purge(mocker, testdatadir):
+    mocker.patch.object(Path, "exists", MagicMock(return_value=False))
+    unlinkmock = mocker.patch.object(Path, "unlink", MagicMock())
+    dh = get_datahandler(testdatadir, 'feather')
+    assert not dh.trades_purge('UNITTEST/NONEXIST')
+    assert unlinkmock.call_count == 0
+
+    mocker.patch.object(Path, "exists", MagicMock(return_value=True))
+    assert dh.trades_purge('UNITTEST/NONEXIST')
+    assert unlinkmock.call_count == 1
+
+
 def test_gethandlerclass():
     cl = get_datahandlerclass('json')
     assert cl == JsonDataHandler
diff --git a/tests/testdata/XRP_ETH-trades.feather b/tests/testdata/XRP_ETH-trades.feather
new file mode 100644
index 0000000000000000000000000000000000000000..68e1c8467193123cc540f7b794d14aa151a2168f
GIT binary patch
literal 374570
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

literal 0
HcmV?d00001


From 0128b63c1c44a339ac8b92ccac7322c6a1e885c9 Mon Sep 17 00:00:00 2001
From: Joe Schr <8218910+TheJoeSchr@users.noreply.github.com>
Date: Tue, 21 Mar 2023 19:12:25 +0100
Subject: [PATCH 094/147] add 'feather' to AVAILABLE_DATAHANDLERS_TRADES

---
 freqtrade/constants.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/freqtrade/constants.py b/freqtrade/constants.py
index 46e9b5cd4..ebb946221 100644
--- a/freqtrade/constants.py
+++ b/freqtrade/constants.py
@@ -36,9 +36,10 @@ AVAILABLE_PAIRLISTS = ['StaticPairList', 'VolumePairList', 'ProducerPairList', '
                        'AgeFilter', 'OffsetFilter', 'PerformanceFilter',
                        'PrecisionFilter', 'PriceFilter', 'RangeStabilityFilter',
                        'ShuffleFilter', 'SpreadFilter', 'VolatilityFilter']
-AVAILABLE_PROTECTIONS = ['CooldownPeriod', 'LowProfitPairs', 'MaxDrawdown', 'StoplossGuard']
-AVAILABLE_DATAHANDLERS_TRADES = ['json', 'jsongz', 'hdf5']
-AVAILABLE_DATAHANDLERS = AVAILABLE_DATAHANDLERS_TRADES + ['feather', 'parquet']
+AVAILABLE_PROTECTIONS = ['CooldownPeriod',
+                         'LowProfitPairs', 'MaxDrawdown', 'StoplossGuard']
+AVAILABLE_DATAHANDLERS_TRADES = ['json', 'jsongz', 'hdf5', 'feather']
+AVAILABLE_DATAHANDLERS = AVAILABLE_DATAHANDLERS_TRADES + ['parquet']
 BACKTEST_BREAKDOWNS = ['day', 'week', 'month']
 BACKTEST_CACHE_AGE = ['none', 'day', 'week', 'month']
 BACKTEST_CACHE_DEFAULT = 'day'

From 36c45fd14f8daa25240b585757af38cfc3663564 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 21 Mar 2023 19:14:09 +0100
Subject: [PATCH 095/147] Remove unused argument from set_leverage

---
 freqtrade/exchange/exchange.py  |  1 -
 freqtrade/exchange/kraken.py    |  1 -
 tests/exchange/test_binance.py  |  1 -
 tests/exchange/test_exchange.py | 23 -----------------------
 4 files changed, 26 deletions(-)

diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index e5f897c2a..f620b5bc1 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -2527,7 +2527,6 @@ class Exchange:
         self,
         leverage: float,
         pair: Optional[str] = None,
-        trading_mode: Optional[TradingMode] = None,
         accept_fail: bool = False,
     ):
         """
diff --git a/freqtrade/exchange/kraken.py b/freqtrade/exchange/kraken.py
index 8a4f7f7e0..b1a19fa69 100644
--- a/freqtrade/exchange/kraken.py
+++ b/freqtrade/exchange/kraken.py
@@ -158,7 +158,6 @@ class Kraken(Exchange):
         self,
         leverage: float,
         pair: Optional[str] = None,
-        trading_mode: Optional[TradingMode] = None,
         accept_fail: bool = False,
     ):
         """
diff --git a/tests/exchange/test_binance.py b/tests/exchange/test_binance.py
index ba786bb3b..8ada089bd 100644
--- a/tests/exchange/test_binance.py
+++ b/tests/exchange/test_binance.py
@@ -555,7 +555,6 @@ def test__set_leverage_binance(mocker, default_conf):
         "set_leverage",
         pair="XRP/USDT",
         leverage=5.0,
-        trading_mode=TradingMode.FUTURES
     )
 
 
diff --git a/tests/exchange/test_exchange.py b/tests/exchange/test_exchange.py
index 6e15abaf4..586f023b4 100644
--- a/tests/exchange/test_exchange.py
+++ b/tests/exchange/test_exchange.py
@@ -3868,29 +3868,6 @@ def test_get_stake_amount_considering_leverage(
         stake_amount, leverage) == min_stake_with_lev
 
 
-@pytest.mark.parametrize("exchange_name,trading_mode", [
-    ("binance", TradingMode.FUTURES),
-])
-def test__set_leverage(mocker, default_conf, exchange_name, trading_mode):
-
-    api_mock = MagicMock()
-    api_mock.set_leverage = MagicMock()
-    type(api_mock).has = PropertyMock(return_value={'setLeverage': True})
-    default_conf['dry_run'] = False
-
-    ccxt_exceptionhandlers(
-        mocker,
-        default_conf,
-        api_mock,
-        exchange_name,
-        "_set_leverage",
-        "set_leverage",
-        pair="XRP/USDT",
-        leverage=5.0,
-        trading_mode=trading_mode
-    )
-
-
 @pytest.mark.parametrize("margin_mode", [
     (MarginMode.CROSS),
     (MarginMode.ISOLATED)

From ebebcb886c0a3f6ac98460fbf073052c96a9f25e Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 21 Mar 2023 19:28:26 +0100
Subject: [PATCH 096/147] Move build-system to the top of pyproject.toml

---
 pyproject.toml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index c3ca9e1b0..baf707c68 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,3 +1,7 @@
+[build-system]
+requires = ["setuptools >= 46.4.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
 [tool.black]
 line-length = 100
 exclude = '''
@@ -48,10 +52,6 @@ ignore_errors = true
 module = "telegram.*"
 implicit_optional = true
 
-[build-system]
-requires = ["setuptools >= 46.4.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
 [tool.pyright]
 include = ["freqtrade"]
 exclude = [

From 8cf3e9f91b50fd7d615822e87a51aa997548dd59 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 21 Mar 2023 19:29:27 +0100
Subject: [PATCH 097/147] Accept "insufficient funds" error on set_leverage
 from stop calls

closes #8341
---
 freqtrade/exchange/bybit.py    |  2 +-
 freqtrade/exchange/exchange.py | 10 +++++-----
 freqtrade/exchange/okx.py      |  2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/freqtrade/exchange/bybit.py b/freqtrade/exchange/bybit.py
index 6f841b608..a4b070741 100644
--- a/freqtrade/exchange/bybit.py
+++ b/freqtrade/exchange/bybit.py
@@ -114,7 +114,7 @@ class Bybit(Exchange):
         data = [[x['timestamp'], x['fundingRate'], 0, 0, 0, 0] for x in data]
         return data
 
-    def _lev_prep(self, pair: str, leverage: float, side: BuySell):
+    def _lev_prep(self, pair: str, leverage: float, side: BuySell, accept_fail: bool = False):
         if self.trading_mode != TradingMode.SPOT:
             params = {'leverage': leverage}
             self.set_margin_mode(pair, self.margin_mode, accept_fail=True, params=params)
diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index f620b5bc1..99551b054 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -1018,10 +1018,10 @@ class Exchange:
 
     # Order handling
 
-    def _lev_prep(self, pair: str, leverage: float, side: BuySell):
+    def _lev_prep(self, pair: str, leverage: float, side: BuySell, accept_fail: bool = False):
         if self.trading_mode != TradingMode.SPOT:
-            self.set_margin_mode(pair, self.margin_mode)
-            self._set_leverage(leverage, pair)
+            self.set_margin_mode(pair, self.margin_mode, accept_fail)
+            self._set_leverage(leverage, pair, accept_fail)
 
     def _get_params(
         self,
@@ -1202,7 +1202,7 @@ class Exchange:
 
             amount = self.amount_to_precision(pair, self._amount_to_contracts(pair, amount))
 
-            self._lev_prep(pair, leverage, side)
+            self._lev_prep(pair, leverage, side, accept_fail=True)
             order = self._api.create_order(symbol=pair, type=ordertype, side=side,
                                            amount=amount, price=limit_rate, params=params)
             self._log_exchange_response('create_stoploss_order', order)
@@ -2544,7 +2544,7 @@ class Exchange:
             self._log_exchange_response('set_leverage', res)
         except ccxt.DDoSProtection as e:
             raise DDosProtection(e) from e
-        except ccxt.BadRequest as e:
+        except (ccxt.BadRequest, ccxt.InsufficientFunds) as e:
             if not accept_fail:
                 raise TemporaryError(
                     f'Could not set leverage due to {e.__class__.__name__}. Message: {e}') from e
diff --git a/freqtrade/exchange/okx.py b/freqtrade/exchange/okx.py
index 1b9134be3..a4fcaeca0 100644
--- a/freqtrade/exchange/okx.py
+++ b/freqtrade/exchange/okx.py
@@ -125,7 +125,7 @@ class Okx(Exchange):
         return params
 
     @retrier
-    def _lev_prep(self, pair: str, leverage: float, side: BuySell):
+    def _lev_prep(self, pair: str, leverage: float, side: BuySell, accept_fail: bool = False):
         if self.trading_mode != TradingMode.SPOT and self.margin_mode is not None:
             try:
                 res = self._api.set_leverage(

From bdf19f1d6622272c4f607080eea347854e13ac02 Mon Sep 17 00:00:00 2001
From: Robert Caulk <rob.caulk@gmail.com>
Date: Tue, 21 Mar 2023 22:44:56 +0100
Subject: [PATCH 098/147] Update freqai_interface.py

---
 freqtrade/freqai/freqai_interface.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/freqtrade/freqai/freqai_interface.py b/freqtrade/freqai/freqai_interface.py
index 07c357de3..8e842b8f2 100644
--- a/freqtrade/freqai/freqai_interface.py
+++ b/freqtrade/freqai/freqai_interface.py
@@ -105,6 +105,10 @@ class IFreqaiModel(ABC):
         self.max_system_threads = max(int(psutil.cpu_count() * 2 - 2), 1)
         self.can_short = True  # overridden in start() with strategy.can_short
         self.model: Any = None
+        if self.ft_params.get('principal_component_analysis', False) and self.continual_learning:
+            self.ft_params.update({'principal_component_analysis': False})
+            logger.warning('User tried to use PCA with continual learning. Deactivating PCA.')
+
 
         record_params(config, self.full_path)
 
@@ -154,8 +158,7 @@ class IFreqaiModel(ABC):
                 dk = self.start_backtesting(dataframe, metadata, self.dk, strategy)
                 dataframe = dk.remove_features_from_df(dk.return_dataframe)
             else:
-                logger.info(
-                    "Backtesting using historic predictions (live models)")
+                logger.info("Backtesting using historic predictions (live models)")
                 dk = self.start_backtesting_from_historic_predictions(
                     dataframe, metadata, self.dk)
                 dataframe = dk.return_dataframe

From 150c5510c74390641fd723f6a70b5f67f53ec9cf Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Wed, 22 Mar 2023 19:46:07 +0100
Subject: [PATCH 099/147] Don''t fully fail bot when invalid price value is
 reached

closes #8300
---
 freqtrade/exchange/exchange.py |  6 +++++-
 freqtrade/freqtradebot.py      | 14 +++++++++-----
 tests/exchange/test_binance.py |  4 ++--
 tests/exchange/test_huobi.py   |  6 +++---
 tests/exchange/test_kucoin.py  |  6 +++---
 5 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index 99551b054..104eaa221 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -1135,7 +1135,11 @@ class Exchange:
                           "sell" else (stop_price >= limit_rate))
         # Ensure rate is less than stop price
         if bad_stop_price:
-            raise OperationalException(
+            # This can for example happen if the stop / liquidation price is set to 0
+            # Which is possible if a market-order closes right away.
+            # The InvalidOrderException will bubble up to exit_positions, where it will be
+            # handled gracefully.
+            raise InvalidOrderException(
                 "In stoploss limit order, stop price should be more than limit price. "
                 f"Stop price: {stop_price}, Limit price: {limit_rate}, "
                 f"Limit Price pct: {limit_price_pct}"
diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 06c8831f5..00bfc1ee2 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -1021,12 +1021,16 @@ class FreqtradeBot(LoggingMixin):
         trades_closed = 0
         for trade in trades:
             try:
+                try:
+                    if (self.strategy.order_types.get('stoploss_on_exchange') and
+                            self.handle_stoploss_on_exchange(trade)):
+                        trades_closed += 1
+                        Trade.commit()
+                        continue
 
-                if (self.strategy.order_types.get('stoploss_on_exchange') and
-                        self.handle_stoploss_on_exchange(trade)):
-                    trades_closed += 1
-                    Trade.commit()
-                    continue
+                except InvalidOrderException as exception:
+                    logger.warning(
+                        f'Unable to handle stoploss on exchange for {trade.pair}: {exception}')
                 # Check if we can sell our current pair
                 if trade.open_order_id is None and trade.is_open and self.handle_trade(trade):
                     trades_closed += 1
diff --git a/tests/exchange/test_binance.py b/tests/exchange/test_binance.py
index 8ada089bd..273860e15 100644
--- a/tests/exchange/test_binance.py
+++ b/tests/exchange/test_binance.py
@@ -52,7 +52,7 @@ def test_create_stoploss_order_binance(default_conf, mocker, limitratio, expecte
 
     exchange = get_patched_exchange(mocker, default_conf, api_mock, 'binance')
 
-    with pytest.raises(OperationalException):
+    with pytest.raises(InvalidOrderException):
         order = exchange.create_stoploss(
             pair='ETH/BTC',
             amount=1,
@@ -131,7 +131,7 @@ def test_create_stoploss_order_dry_run_binance(default_conf, mocker):
 
     exchange = get_patched_exchange(mocker, default_conf, api_mock, 'binance')
 
-    with pytest.raises(OperationalException):
+    with pytest.raises(InvalidOrderException):
         order = exchange.create_stoploss(
             pair='ETH/BTC',
             amount=1,
diff --git a/tests/exchange/test_huobi.py b/tests/exchange/test_huobi.py
index 5e4fd7316..85d2ced9d 100644
--- a/tests/exchange/test_huobi.py
+++ b/tests/exchange/test_huobi.py
@@ -4,7 +4,7 @@ from unittest.mock import MagicMock
 import ccxt
 import pytest
 
-from freqtrade.exceptions import DependencyException, InvalidOrderException, OperationalException
+from freqtrade.exceptions import DependencyException, InvalidOrderException
 from tests.conftest import EXMS, get_patched_exchange
 from tests.exchange.test_exchange import ccxt_exceptionhandlers
 
@@ -31,7 +31,7 @@ def test_create_stoploss_order_huobi(default_conf, mocker, limitratio, expected,
 
     exchange = get_patched_exchange(mocker, default_conf, api_mock, 'huobi')
 
-    with pytest.raises(OperationalException):
+    with pytest.raises(InvalidOrderException):
         order = exchange.create_stoploss(pair='ETH/BTC', amount=1, stop_price=190,
                                          order_types={'stoploss_on_exchange_limit_ratio': 1.05},
                                          side=side,
@@ -84,7 +84,7 @@ def test_create_stoploss_order_dry_run_huobi(default_conf, mocker):
 
     exchange = get_patched_exchange(mocker, default_conf, api_mock, 'huobi')
 
-    with pytest.raises(OperationalException):
+    with pytest.raises(InvalidOrderException):
         order = exchange.create_stoploss(pair='ETH/BTC', amount=1, stop_price=190,
                                          order_types={'stoploss_on_exchange_limit_ratio': 1.05},
                                          side='sell', leverage=1.0)
diff --git a/tests/exchange/test_kucoin.py b/tests/exchange/test_kucoin.py
index e0bb32b7c..07f3fb6a3 100644
--- a/tests/exchange/test_kucoin.py
+++ b/tests/exchange/test_kucoin.py
@@ -4,7 +4,7 @@ from unittest.mock import MagicMock
 import ccxt
 import pytest
 
-from freqtrade.exceptions import DependencyException, InvalidOrderException, OperationalException
+from freqtrade.exceptions import DependencyException, InvalidOrderException
 from tests.conftest import EXMS, get_patched_exchange
 from tests.exchange.test_exchange import ccxt_exceptionhandlers
 
@@ -31,7 +31,7 @@ def test_create_stoploss_order_kucoin(default_conf, mocker, limitratio, expected
 
     exchange = get_patched_exchange(mocker, default_conf, api_mock, 'kucoin')
     if order_type == 'limit':
-        with pytest.raises(OperationalException):
+        with pytest.raises(InvalidOrderException):
             order = exchange.create_stoploss(pair='ETH/BTC', amount=1, stop_price=190,
                                              order_types={
                                                  'stoploss': order_type,
@@ -92,7 +92,7 @@ def test_stoploss_order_dry_run_kucoin(default_conf, mocker):
 
     exchange = get_patched_exchange(mocker, default_conf, api_mock, 'kucoin')
 
-    with pytest.raises(OperationalException):
+    with pytest.raises(InvalidOrderException):
         order = exchange.create_stoploss(pair='ETH/BTC', amount=1, stop_price=190,
                                          order_types={'stoploss': 'limit',
                                                       'stoploss_on_exchange_limit_ratio': 1.05},

From 469166636c9794afb309875d87be66e76518430e Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 07:27:45 +0100
Subject: [PATCH 100/147] Set initial stoploss when creating the order

This ensures that a trade never has "None" as stoploss
---
 freqtrade/freqtradebot.py |  3 +++
 tests/rpc/test_rpc.py     | 11 -----------
 tests/test_integration.py | 18 +++++++++---------
 3 files changed, 12 insertions(+), 20 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 00bfc1ee2..9d402b6a6 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -810,6 +810,9 @@ class FreqtradeBot(LoggingMixin):
                 precision_mode=self.exchange.precisionMode,
                 contract_size=self.exchange.get_contract_size(pair),
             )
+            stoploss = self.strategy.stoploss if not self.edge else self.edge.get_stoploss(pair)
+            trade.adjust_stop_loss(trade.open_rate, stoploss, initial=True)
+
         else:
             # This is additional buy, we reset fee_open_currency so timeout checking can work
             trade.is_open = True
diff --git a/tests/rpc/test_rpc.py b/tests/rpc/test_rpc.py
index 7d829bdb6..4e2dc94ae 100644
--- a/tests/rpc/test_rpc.py
+++ b/tests/rpc/test_rpc.py
@@ -125,17 +125,6 @@ def test_rpc_trade_status(default_conf, ticker, fee, mocker) -> None:
         'profit_pct': 0.0,
         'profit_abs': 0.0,
         'total_profit_abs': 0.0,
-        'stop_loss_abs': 0.0,
-        'stop_loss_pct': None,
-        'stop_loss_ratio': None,
-        'stoploss_current_dist': -1.099e-05,
-        'stoploss_current_dist_ratio': -1.0,
-        'stoploss_current_dist_pct': pytest.approx(-100.0),
-        'stoploss_entry_dist': -0.0010025,
-        'stoploss_entry_dist_ratio': -1.0,
-        'initial_stop_loss_abs': 0.0,
-        'initial_stop_loss_pct': None,
-        'initial_stop_loss_ratio': None,
         'open_order': '(limit buy rem=91.07468123)',
     })
     response_unfilled['orders'][0].update({
diff --git a/tests/test_integration.py b/tests/test_integration.py
index 922285309..5cbedd818 100644
--- a/tests/test_integration.py
+++ b/tests/test_integration.py
@@ -386,12 +386,12 @@ def test_dca_order_adjust(default_conf_usdt, ticker_usdt, leverage, fee, mocker)
     assert trade.open_order_id is not None
     assert pytest.approx(trade.stake_amount) == 60
     assert trade.open_rate == 1.96
-    assert trade.stop_loss_pct is None
-    assert trade.stop_loss == 0.0
+    assert trade.stop_loss_pct == -0.1
+    assert pytest.approx(trade.stop_loss) == trade.open_rate * (1 - 0.1 / leverage)
+    assert pytest.approx(trade.initial_stop_loss) == trade.open_rate * (1 - 0.1 / leverage)
+    assert trade.initial_stop_loss_pct == -0.1
     assert trade.leverage == leverage
     assert trade.stake_amount == 60
-    assert trade.initial_stop_loss == 0.0
-    assert trade.initial_stop_loss_pct is None
     # No adjustment
     freqtrade.process()
     trade = Trade.get_trades().first()
@@ -407,11 +407,11 @@ def test_dca_order_adjust(default_conf_usdt, ticker_usdt, leverage, fee, mocker)
     assert trade.open_order_id is not None
     # Open rate is not adjusted yet
     assert trade.open_rate == 1.96
-    assert trade.stop_loss_pct is None
-    assert trade.stop_loss == 0.0
+    assert trade.stop_loss_pct == -0.1
+    assert pytest.approx(trade.stop_loss) == trade.open_rate * (1 - 0.1 / leverage)
+    assert pytest.approx(trade.initial_stop_loss) == trade.open_rate * (1 - 0.1 / leverage)
     assert trade.stake_amount == 60
-    assert trade.initial_stop_loss == 0.0
-    assert trade.initial_stop_loss_pct is None
+    assert trade.initial_stop_loss_pct == -0.1
 
     # Fill order
     mocker.patch(f'{EXMS}._dry_is_price_crossed', return_value=True)
@@ -424,7 +424,7 @@ def test_dca_order_adjust(default_conf_usdt, ticker_usdt, leverage, fee, mocker)
     assert pytest.approx(trade.stake_amount) == 60
     assert trade.stop_loss_pct == -0.1
     assert pytest.approx(trade.stop_loss) == 1.99 * (1 - 0.1 / leverage)
-    assert pytest.approx(trade.initial_stop_loss) == 1.99 * (1 - 0.1 / leverage)
+    assert pytest.approx(trade.initial_stop_loss) == 1.96 * (1 - 0.1 / leverage)
     assert trade.initial_stop_loss_pct == -0.1
 
     # 2nd order - not filling

From b317524ed70883a5d440827aeb52434b57a1602e Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 20:27:45 +0100
Subject: [PATCH 101/147] protect adjust_trade_position from crashing in case
 of unsafe code

---
 freqtrade/freqtradebot.py         | 2 +-
 freqtrade/optimize/backtesting.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 9d402b6a6..623d39c09 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -594,7 +594,7 @@ class FreqtradeBot(LoggingMixin):
         stake_available = self.wallets.get_available_stake_amount()
         logger.debug(f"Calling adjust_trade_position for pair {trade.pair}")
         stake_amount = strategy_safe_wrapper(self.strategy.adjust_trade_position,
-                                             default_retval=None)(
+                                             default_retval=None, supress_error=True)(
             trade=trade,
             current_time=datetime.now(timezone.utc), current_rate=current_entry_rate,
             current_profit=current_entry_profit, min_stake=min_entry_stake,
diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index 315b3b9db..fe6667ad9 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -522,7 +522,7 @@ class Backtesting:
         max_stake = self.exchange.get_max_pair_stake_amount(trade.pair, current_rate)
         stake_available = self.wallets.get_available_stake_amount()
         stake_amount = strategy_safe_wrapper(self.strategy.adjust_trade_position,
-                                             default_retval=None)(
+                                             default_retval=None, supress_error=True)(
             trade=trade,  # type: ignore[arg-type]
             current_time=current_date, current_rate=current_rate,
             current_profit=current_profit, min_stake=min_stake,

From 0ece73578c67c64bf83147bc87f9e36e6f502aae Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Tue, 20 Sep 2022 19:51:42 +0200
Subject: [PATCH 102/147] Add typedDict for RPC messages

Currently not fully functional.
---
 freqtrade/freqtradebot.py             | 10 ++--
 freqtrade/rpc/api_server/webserver.py |  5 +-
 freqtrade/rpc/rpc.py                  |  3 +-
 freqtrade/rpc/rpc_manager.py          |  5 +-
 freqtrade/rpc/rpc_types.py            | 82 +++++++++++++++++++++++++++
 freqtrade/rpc/telegram.py             |  3 +-
 freqtrade/rpc/webhook.py              |  5 +-
 7 files changed, 101 insertions(+), 12 deletions(-)
 create mode 100644 freqtrade/rpc/rpc_types.py

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 623d39c09..28dd1fae5 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -30,6 +30,7 @@ from freqtrade.plugins.protectionmanager import ProtectionManager
 from freqtrade.resolvers import ExchangeResolver, StrategyResolver
 from freqtrade.rpc import RPCManager
 from freqtrade.rpc.external_message_consumer import ExternalMessageConsumer
+from freqtrade.rpc.rpc_types import RPCBuyMsg, RPCCancelMsg, RPCSellCancelMsg, RPCSellMsg
 from freqtrade.strategy.interface import IStrategy
 from freqtrade.strategy.strategy_wrapper import strategy_safe_wrapper
 from freqtrade.util import FtPrecise
@@ -957,7 +958,7 @@ class FreqtradeBot(LoggingMixin):
             current_rate = self.exchange.get_rate(
                 trade.pair, side='entry', is_short=trade.is_short, refresh=False)
 
-        msg = {
+        msg: RPCBuyMsg = {
             'trade_id': trade.id,
             'type': msg_type,
             'buy_tag': trade.enter_tag,
@@ -989,7 +990,7 @@ class FreqtradeBot(LoggingMixin):
         current_rate = self.exchange.get_rate(
             trade.pair, side='entry', is_short=trade.is_short, refresh=False)
 
-        msg = {
+        msg: RPCCancelMsg = {
             'trade_id': trade.id,
             'type': RPCMessageType.ENTRY_CANCEL,
             'buy_tag': trade.enter_tag,
@@ -1001,6 +1002,7 @@ class FreqtradeBot(LoggingMixin):
             'limit': trade.open_rate,
             'order_type': order_type,
             'stake_amount': trade.stake_amount,
+            'open_rate': trade.open_rate,
             'stake_currency': self.config['stake_currency'],
             'fiat_currency': self.config.get('fiat_display_currency', None),
             'amount': trade.amount,
@@ -1666,7 +1668,7 @@ class FreqtradeBot(LoggingMixin):
             amount = trade.amount
         gain = "profit" if profit_ratio > 0 else "loss"
 
-        msg = {
+        msg: RPCSellMsg = {
             'type': (RPCMessageType.EXIT_FILL if fill
                      else RPCMessageType.EXIT),
             'trade_id': trade.id,
@@ -1722,7 +1724,7 @@ class FreqtradeBot(LoggingMixin):
         profit_ratio = trade.calc_profit_ratio(profit_rate)
         gain = "profit" if profit_ratio > 0 else "loss"
 
-        msg = {
+        msg: RPCSellCancelMsg = {
             'type': RPCMessageType.EXIT_CANCEL,
             'trade_id': trade.id,
             'exchange': trade.exchange.capitalize(),
diff --git a/freqtrade/rpc/api_server/webserver.py b/freqtrade/rpc/api_server/webserver.py
index b53662451..2413e5264 100644
--- a/freqtrade/rpc/api_server/webserver.py
+++ b/freqtrade/rpc/api_server/webserver.py
@@ -1,6 +1,6 @@
 import logging
 from ipaddress import IPv4Address
-from typing import Any, Dict, Optional
+from typing import Any, Optional
 
 import orjson
 import uvicorn
@@ -13,6 +13,7 @@ from freqtrade.exceptions import OperationalException
 from freqtrade.rpc.api_server.uvicorn_threaded import UvicornServer
 from freqtrade.rpc.api_server.ws.message_stream import MessageStream
 from freqtrade.rpc.rpc import RPC, RPCException, RPCHandler
+from freqtrade.rpc.rpc_types import RPCSendMsg
 
 
 logger = logging.getLogger(__name__)
@@ -108,7 +109,7 @@ class ApiServer(RPCHandler):
         cls._has_rpc = False
         cls._rpc = None
 
-    def send_msg(self, msg: Dict[str, Any]) -> None:
+    def send_msg(self, msg: RPCSendMsg) -> None:
         """
         Publish the message to the message stream
         """
diff --git a/freqtrade/rpc/rpc.py b/freqtrade/rpc/rpc.py
index c6a6f5cae..2b5eb107c 100644
--- a/freqtrade/rpc/rpc.py
+++ b/freqtrade/rpc/rpc.py
@@ -30,6 +30,7 @@ from freqtrade.persistence import Order, PairLocks, Trade
 from freqtrade.persistence.models import PairLock
 from freqtrade.plugins.pairlist.pairlist_helpers import expand_pairlist
 from freqtrade.rpc.fiat_convert import CryptoToFiatConverter
+from freqtrade.rpc.rpc_types import RPCSendMsg
 from freqtrade.wallets import PositionWallet, Wallet
 
 
@@ -79,7 +80,7 @@ class RPCHandler:
         """ Cleanup pending module resources """
 
     @abstractmethod
-    def send_msg(self, msg: Dict[str, str]) -> None:
+    def send_msg(self, msg: RPCSendMsg) -> None:
         """ Sends a message to all registered rpc modules """
 
 
diff --git a/freqtrade/rpc/rpc_manager.py b/freqtrade/rpc/rpc_manager.py
index c4d4fa2dd..e4c925995 100644
--- a/freqtrade/rpc/rpc_manager.py
+++ b/freqtrade/rpc/rpc_manager.py
@@ -3,11 +3,12 @@ This module contains class to manage RPC communications (Telegram, API, ...)
 """
 import logging
 from collections import deque
-from typing import Any, Dict, List
+from typing import List
 
 from freqtrade.constants import Config
 from freqtrade.enums import NO_ECHO_MESSAGES, RPCMessageType
 from freqtrade.rpc import RPC, RPCHandler
+from freqtrade.rpc.rpc_types import RPCSendMsg
 
 
 logger = logging.getLogger(__name__)
@@ -58,7 +59,7 @@ class RPCManager:
             mod.cleanup()
             del mod
 
-    def send_msg(self, msg: Dict[str, Any]) -> None:
+    def send_msg(self, msg: RPCSendMsg) -> None:
         """
         Send given message to all registered rpc modules.
         A message consists of one or more key value pairs of strings.
diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
new file mode 100644
index 000000000..0fb5a6bfa
--- /dev/null
+++ b/freqtrade/rpc/rpc_types.py
@@ -0,0 +1,82 @@
+from datetime import datetime
+from typing import Optional, TypedDict, Union
+
+from freqtrade.enums import RPCMessageType
+
+
+class RPCSendMsgBase(TypedDict):
+    type: RPCMessageType
+
+
+class RPCStatusMsg(RPCSendMsgBase):
+    """Used for Status, Startup and Warning messages"""
+    status: str
+
+
+class RPCProtectionMsg(RPCSendMsgBase):
+    id: int
+    pair: str
+    base_currency: Optional[str]
+    lock_time: str
+    lock_timestamp: int
+    lock_end_time: str
+    lock_end_timestamp: int
+    reason: str
+    side: str
+    active: bool
+
+
+class RPCBuyMsg(RPCSendMsgBase):
+    trade_id: str
+    buy_tag: str
+    enter_tag: str
+    exchange: str
+    pair: str
+    leverage: float
+    direction: str
+    limit: float
+    open_rate: float
+    order_type: Optional[str]  # TODO: why optional??
+    stake_amount: float
+    stake_currency: str
+    fiat_currency: Optional[str]
+    amount: float
+    open_date: datetime
+    current_rate: float
+    sub_trade: bool
+
+
+class RPCCancelMsg(RPCBuyMsg):
+    reason: str
+
+
+class RPCSellMsg(RPCBuyMsg):
+    cumulative_profit: float
+    gain: str  # Literal["profit", "loss"]
+    close_rate: float
+    profit_amount: float
+    profit_ratio: float
+    sell_reason: str
+    exit_reason: str
+    close_date: datetime
+    current_rate: Optional[float]
+
+
+class RPCSellCancelMsg(RPCBuyMsg):
+    reason: str
+    gain: str  # Literal["profit", "loss"]
+    profit_amount: float
+    profit_ratio: float
+    sell_reason: str
+    exit_reason: str
+    close_date: datetime
+
+
+RPCSendMsg = Union[
+    RPCStatusMsg,
+    RPCProtectionMsg,
+    RPCBuyMsg,
+    RPCCancelMsg,
+    RPCSellMsg,
+    RPCSellCancelMsg
+    ]
diff --git a/freqtrade/rpc/telegram.py b/freqtrade/rpc/telegram.py
index 962c5e058..c1365702d 100644
--- a/freqtrade/rpc/telegram.py
+++ b/freqtrade/rpc/telegram.py
@@ -30,6 +30,7 @@ from freqtrade.exceptions import OperationalException
 from freqtrade.misc import chunks, plural, round_coin_value
 from freqtrade.persistence import Trade
 from freqtrade.rpc import RPC, RPCException, RPCHandler
+from freqtrade.rpc.rpc_types import RPCSendMsg
 
 
 logger = logging.getLogger(__name__)
@@ -429,7 +430,7 @@ class Telegram(RPCHandler):
             return None
         return message
 
-    def send_msg(self, msg: Dict[str, Any]) -> None:
+    def send_msg(self, msg: RPCSendMsg) -> None:
         """ Send a message to telegram channel """
 
         default_noti = 'on'
diff --git a/freqtrade/rpc/webhook.py b/freqtrade/rpc/webhook.py
index 118ebed88..14b881126 100644
--- a/freqtrade/rpc/webhook.py
+++ b/freqtrade/rpc/webhook.py
@@ -10,6 +10,7 @@ from requests import RequestException, post
 from freqtrade.constants import Config
 from freqtrade.enums import RPCMessageType
 from freqtrade.rpc import RPC, RPCHandler
+from freqtrade.rpc.rpc_types import RPCSendMsg
 
 
 logger = logging.getLogger(__name__)
@@ -41,7 +42,7 @@ class Webhook(RPCHandler):
         """
         pass
 
-    def _get_value_dict(self, msg: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+    def _get_value_dict(self, msg: RPCSendMsg) -> Optional[Dict[str, Any]]:
         whconfig = self._config['webhook']
         # Deprecated 2022.10 - only keep generic method.
         if msg['type'] in [RPCMessageType.ENTRY]:
@@ -75,7 +76,7 @@ class Webhook(RPCHandler):
             return None
         return valuedict
 
-    def send_msg(self, msg: Dict[str, Any]) -> None:
+    def send_msg(self, msg: RPCSendMsg) -> None:
         """ Send a message to telegram channel """
         try:
 

From 70ad7b42b1b0492fe79f28ffc4ce855d318c8adc Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 6 Mar 2023 19:23:05 +0100
Subject: [PATCH 103/147] Improve msg typing

---
 freqtrade/rpc/api_server/webserver.py |  2 +-
 freqtrade/rpc/rpc_types.py            | 21 +++++++++++----------
 2 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/freqtrade/rpc/api_server/webserver.py b/freqtrade/rpc/api_server/webserver.py
index 2413e5264..8030e303b 100644
--- a/freqtrade/rpc/api_server/webserver.py
+++ b/freqtrade/rpc/api_server/webserver.py
@@ -1,6 +1,6 @@
 import logging
 from ipaddress import IPv4Address
-from typing import Any, Optional
+from typing import Any, Dict, Optional
 
 import orjson
 import uvicorn
diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index 0fb5a6bfa..bde985548 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -27,12 +27,12 @@ class RPCProtectionMsg(RPCSendMsgBase):
 
 
 class RPCBuyMsg(RPCSendMsgBase):
-    trade_id: str
-    buy_tag: str
-    enter_tag: str
+    trade_id: int
+    buy_tag: Optional[str]
+    enter_tag: Optional[str]
     exchange: str
     pair: str
-    leverage: float
+    leverage: Optional[float]
     direction: str
     limit: float
     open_rate: float
@@ -42,7 +42,7 @@ class RPCBuyMsg(RPCSendMsgBase):
     fiat_currency: Optional[str]
     amount: float
     open_date: datetime
-    current_rate: float
+    current_rate: Optional[float]
     sub_trade: bool
 
 
@@ -56,10 +56,11 @@ class RPCSellMsg(RPCBuyMsg):
     close_rate: float
     profit_amount: float
     profit_ratio: float
-    sell_reason: str
-    exit_reason: str
+    sell_reason: Optional[str]
+    exit_reason: Optional[str]
     close_date: datetime
-    current_rate: Optional[float]
+    # current_rate: Optional[float]
+    order_rate: Optional[float]
 
 
 class RPCSellCancelMsg(RPCBuyMsg):
@@ -67,8 +68,8 @@ class RPCSellCancelMsg(RPCBuyMsg):
     gain: str  # Literal["profit", "loss"]
     profit_amount: float
     profit_ratio: float
-    sell_reason: str
-    exit_reason: str
+    sell_reason: Optional[str]
+    exit_reason: Optional[str]
     close_date: datetime
 
 

From 245ae99273dcc7ff591c37d830b1b8462b1efde6 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 6 Mar 2023 19:44:23 +0100
Subject: [PATCH 104/147] Further typing ...

---
 freqtrade/freqtradebot.py  | 15 ++++++++++-----
 freqtrade/rpc/rpc_types.py | 17 +++++++++++++++--
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 28dd1fae5..7db9c1e30 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -30,7 +30,8 @@ from freqtrade.plugins.protectionmanager import ProtectionManager
 from freqtrade.resolvers import ExchangeResolver, StrategyResolver
 from freqtrade.rpc import RPCManager
 from freqtrade.rpc.external_message_consumer import ExternalMessageConsumer
-from freqtrade.rpc.rpc_types import RPCBuyMsg, RPCCancelMsg, RPCSellCancelMsg, RPCSellMsg
+from freqtrade.rpc.rpc_types import (RPCBuyMsg, RPCCancelMsg, RPCProtectionMsg, RPCSellCancelMsg,
+                                     RPCSellMsg)
 from freqtrade.strategy.interface import IStrategy
 from freqtrade.strategy.strategy_wrapper import strategy_safe_wrapper
 from freqtrade.util import FtPrecise
@@ -1853,14 +1854,18 @@ class FreqtradeBot(LoggingMixin):
         self.strategy.lock_pair(pair, datetime.now(timezone.utc), reason='Auto lock')
         prot_trig = self.protections.stop_per_pair(pair, side=side)
         if prot_trig:
-            msg = {'type': RPCMessageType.PROTECTION_TRIGGER, }
-            msg.update(prot_trig.to_json())
+            msg: RPCProtectionMsg = {
+                'type': RPCMessageType.PROTECTION_TRIGGER,
+                **prot_trig.to_json()
+            }
             self.rpc.send_msg(msg)
 
         prot_trig_glb = self.protections.global_stop(side=side)
         if prot_trig_glb:
-            msg = {'type': RPCMessageType.PROTECTION_TRIGGER_GLOBAL, }
-            msg.update(prot_trig_glb.to_json())
+            msg = {
+                'type': RPCMessageType.PROTECTION_TRIGGER_GLOBAL,
+                **prot_trig_glb.to_json()
+            }
             self.rpc.send_msg(msg)
 
     def apply_fee_conditional(self, trade: Trade, trade_base_currency: str,
diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index bde985548..b81591954 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -1,19 +1,22 @@
 from datetime import datetime
-from typing import Optional, TypedDict, Union
+from typing import List, Literal, Optional, TypedDict, Union
 
 from freqtrade.enums import RPCMessageType
 
 
 class RPCSendMsgBase(TypedDict):
-    type: RPCMessageType
+    pass
+    # ty1pe: Literal[RPCMessageType]
 
 
 class RPCStatusMsg(RPCSendMsgBase):
     """Used for Status, Startup and Warning messages"""
+    type: Literal[RPCMessageType.STATUS]
     status: str
 
 
 class RPCProtectionMsg(RPCSendMsgBase):
+    type: Literal[RPCMessageType.PROTECTION_TRIGGER, RPCMessageType.PROTECTION_TRIGGER_GLOBAL]
     id: int
     pair: str
     base_currency: Optional[str]
@@ -26,7 +29,13 @@ class RPCProtectionMsg(RPCSendMsgBase):
     active: bool
 
 
+class RPCWhitelistMsg(RPCSendMsgBase):
+    type: Literal[RPCMessageType.WHITELIST]
+    data: List[str]
+
+
 class RPCBuyMsg(RPCSendMsgBase):
+    type: Literal[RPCMessageType.ENTRY, RPCMessageType.ENTRY_FILL]
     trade_id: int
     buy_tag: Optional[str]
     enter_tag: Optional[str]
@@ -47,10 +56,12 @@ class RPCBuyMsg(RPCSendMsgBase):
 
 
 class RPCCancelMsg(RPCBuyMsg):
+    type: Literal[RPCMessageType.ENTRY_CANCEL]
     reason: str
 
 
 class RPCSellMsg(RPCBuyMsg):
+    type: Literal[RPCMessageType.EXIT, RPCMessageType.EXIT_FILL]
     cumulative_profit: float
     gain: str  # Literal["profit", "loss"]
     close_rate: float
@@ -64,6 +75,7 @@ class RPCSellMsg(RPCBuyMsg):
 
 
 class RPCSellCancelMsg(RPCBuyMsg):
+    type: Literal[RPCMessageType.EXIT_CANCEL]
     reason: str
     gain: str  # Literal["profit", "loss"]
     profit_amount: float
@@ -76,6 +88,7 @@ class RPCSellCancelMsg(RPCBuyMsg):
 RPCSendMsg = Union[
     RPCStatusMsg,
     RPCProtectionMsg,
+    RPCWhitelistMsg,
     RPCBuyMsg,
     RPCCancelMsg,
     RPCSellMsg,

From 76d289f0cecb504c18e678cf06c93cbefab5ca0d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 20:35:01 +0100
Subject: [PATCH 105/147] Don't overwrite types

---
 freqtrade/rpc/rpc_types.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index b81591954..a43cfd34e 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -34,8 +34,7 @@ class RPCWhitelistMsg(RPCSendMsgBase):
     data: List[str]
 
 
-class RPCBuyMsg(RPCSendMsgBase):
-    type: Literal[RPCMessageType.ENTRY, RPCMessageType.ENTRY_FILL]
+class __RPCBuyMsgBase(RPCSendMsgBase):
     trade_id: int
     buy_tag: Optional[str]
     enter_tag: Optional[str]
@@ -55,12 +54,16 @@ class RPCBuyMsg(RPCSendMsgBase):
     sub_trade: bool
 
 
-class RPCCancelMsg(RPCBuyMsg):
+class RPCBuyMsg(__RPCBuyMsgBase):
+    type: Literal[RPCMessageType.ENTRY, RPCMessageType.ENTRY_FILL]
+
+
+class RPCCancelMsg(__RPCBuyMsgBase):
     type: Literal[RPCMessageType.ENTRY_CANCEL]
     reason: str
 
 
-class RPCSellMsg(RPCBuyMsg):
+class RPCSellMsg(__RPCBuyMsgBase):
     type: Literal[RPCMessageType.EXIT, RPCMessageType.EXIT_FILL]
     cumulative_profit: float
     gain: str  # Literal["profit", "loss"]
@@ -74,7 +77,7 @@ class RPCSellMsg(RPCBuyMsg):
     order_rate: Optional[float]
 
 
-class RPCSellCancelMsg(RPCBuyMsg):
+class RPCSellCancelMsg(__RPCBuyMsgBase):
     type: Literal[RPCMessageType.EXIT_CANCEL]
     reason: str
     gain: str  # Literal["profit", "loss"]

From e8cffeeffd9972f97769406ffce6498875b089ba Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 20:36:29 +0100
Subject: [PATCH 106/147] Update RPCStatusMessage type

---
 freqtrade/rpc/rpc_types.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index a43cfd34e..5ddaa0c17 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -11,7 +11,7 @@ class RPCSendMsgBase(TypedDict):
 
 class RPCStatusMsg(RPCSendMsgBase):
     """Used for Status, Startup and Warning messages"""
-    type: Literal[RPCMessageType.STATUS]
+    type: Literal[RPCMessageType.STATUS, RPCMessageType.STARTUP, RPCMessageType.WARNING]
     status: str
 
 

From 8928d3616a81a45d8c7084150f67beded55337a7 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 20:47:17 +0100
Subject: [PATCH 107/147] Improve msgtypes

---
 freqtrade/freqtradebot.py  | 4 ++++
 freqtrade/rpc/rpc_types.py | 8 ++++++++
 freqtrade/rpc/telegram.py  | 2 +-
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 7db9c1e30..3aa1075d8 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -973,6 +973,7 @@ class FreqtradeBot(LoggingMixin):
             'order_type': order_type,
             'stake_amount': trade.stake_amount,
             'stake_currency': self.config['stake_currency'],
+            'base_currency': self.exchange.get_pair_base_currency(trade.pair),
             'fiat_currency': self.config.get('fiat_display_currency', None),
             'amount': order.safe_amount_after_fee if fill else (order.amount or trade.amount),
             'open_date': trade.open_date or datetime.utcnow(),
@@ -1005,6 +1006,7 @@ class FreqtradeBot(LoggingMixin):
             'stake_amount': trade.stake_amount,
             'open_rate': trade.open_rate,
             'stake_currency': self.config['stake_currency'],
+            'base_currency': self.exchange.get_pair_base_currency(trade.pair),
             'fiat_currency': self.config.get('fiat_display_currency', None),
             'amount': trade.amount,
             'open_date': trade.open_date,
@@ -1695,6 +1697,7 @@ class FreqtradeBot(LoggingMixin):
             'close_date': trade.close_date or datetime.utcnow(),
             'stake_amount': trade.stake_amount,
             'stake_currency': self.config['stake_currency'],
+            'base_currency': self.exchange.get_pair_base_currency(trade.pair),
             'fiat_currency': self.config.get('fiat_display_currency'),
             'sub_trade': sub_trade,
             'cumulative_profit': trade.realized_profit,
@@ -1747,6 +1750,7 @@ class FreqtradeBot(LoggingMixin):
             'open_date': trade.open_date,
             'close_date': trade.close_date or datetime.now(timezone.utc),
             'stake_currency': self.config['stake_currency'],
+            'base_currency': self.exchange.get_pair_base_currency(trade.pair),
             'fiat_currency': self.config.get('fiat_display_currency', None),
             'reason': reason,
             'sub_trade': sub_trade,
diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index 5ddaa0c17..5a3549aa7 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -15,6 +15,12 @@ class RPCStatusMsg(RPCSendMsgBase):
     status: str
 
 
+class RPCStrategyMsg(RPCSendMsgBase):
+    """Used for Status, Startup and Warning messages"""
+    type: Literal[RPCMessageType.STRATEGY_MSG]
+    msg: str
+
+
 class RPCProtectionMsg(RPCSendMsgBase):
     type: Literal[RPCMessageType.PROTECTION_TRIGGER, RPCMessageType.PROTECTION_TRIGGER_GLOBAL]
     id: int
@@ -40,6 +46,7 @@ class __RPCBuyMsgBase(RPCSendMsgBase):
     enter_tag: Optional[str]
     exchange: str
     pair: str
+    base_currency: str
     leverage: Optional[float]
     direction: str
     limit: float
@@ -90,6 +97,7 @@ class RPCSellCancelMsg(__RPCBuyMsgBase):
 
 RPCSendMsg = Union[
     RPCStatusMsg,
+    RPCStrategyMsg,
     RPCProtectionMsg,
     RPCWhitelistMsg,
     RPCBuyMsg,
diff --git a/freqtrade/rpc/telegram.py b/freqtrade/rpc/telegram.py
index c1365702d..6f34b7325 100644
--- a/freqtrade/rpc/telegram.py
+++ b/freqtrade/rpc/telegram.py
@@ -437,7 +437,7 @@ class Telegram(RPCHandler):
 
         msg_type = msg['type']
         noti = ''
-        if msg_type == RPCMessageType.EXIT:
+        if msg['type'] == RPCMessageType.EXIT:
             sell_noti = self._config['telegram'] \
                 .get('notification_settings', {}).get(str(msg_type), {})
             # For backward compatibility sell still can be string

From ad58bac810bf5cfd2fbcd9556a192f0b1dc0d429 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 20:54:28 +0100
Subject: [PATCH 108/147] Type WS messagetypes

---
 freqtrade/data/dataprovider.py |  6 +++---
 freqtrade/rpc/rpc_types.py     | 25 +++++++++++++++++++++++--
 2 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/freqtrade/data/dataprovider.py b/freqtrade/data/dataprovider.py
index 3991432a4..d05ee5db7 100644
--- a/freqtrade/data/dataprovider.py
+++ b/freqtrade/data/dataprovider.py
@@ -21,6 +21,7 @@ from freqtrade.exchange import Exchange, timeframe_to_seconds
 from freqtrade.exchange.types import OrderBook
 from freqtrade.misc import append_candles_to_dataframe
 from freqtrade.rpc import RPCManager
+from freqtrade.rpc.rpc_types import RPCAnalyzedDFMsg
 from freqtrade.util import PeriodicCache
 
 
@@ -118,8 +119,7 @@ class DataProvider:
         :param new_candle: This is a new candle
         """
         if self.__rpc:
-            self.__rpc.send_msg(
-                {
+            msg: RPCAnalyzedDFMsg = {
                     'type': RPCMessageType.ANALYZED_DF,
                     'data': {
                         'key': pair_key,
@@ -127,7 +127,7 @@ class DataProvider:
                         'la': datetime.now(timezone.utc)
                     }
                 }
-            )
+            self.__rpc.send_msg(msg)
             if new_candle:
                 self.__rpc.send_msg({
                         'type': RPCMessageType.NEW_CANDLE,
diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index 5a3549aa7..a290ee78c 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -1,6 +1,7 @@
 from datetime import datetime
-from typing import List, Literal, Optional, TypedDict, Union
+from typing import Any, List, Literal, Optional, TypedDict, Union
 
+from freqtrade.constants import PairWithTimeframe
 from freqtrade.enums import RPCMessageType
 
 
@@ -95,6 +96,24 @@ class RPCSellCancelMsg(__RPCBuyMsgBase):
     close_date: datetime
 
 
+class __AnalyzedDFData(TypedDict):
+    key: PairWithTimeframe
+    df: Any
+    la: datetime
+
+
+class RPCAnalyzedDFMsg(RPCSendMsgBase):
+    """New Analyzed dataframe message"""
+    type: Literal[RPCMessageType.ANALYZED_DF]
+    data: __AnalyzedDFData
+
+
+class RPCNewCandleMsg(RPCSendMsgBase):
+    """New candle ping message, issued once per new candle/pair"""
+    type: Literal[RPCMessageType.NEW_CANDLE]
+    data: PairWithTimeframe
+
+
 RPCSendMsg = Union[
     RPCStatusMsg,
     RPCStrategyMsg,
@@ -103,5 +122,7 @@ RPCSendMsg = Union[
     RPCBuyMsg,
     RPCCancelMsg,
     RPCSellMsg,
-    RPCSellCancelMsg
+    RPCSellCancelMsg,
+    RPCAnalyzedDFMsg,
+    RPCNewCandleMsg
     ]

From 281dd7785ebf190460bdf483f0839799bcf55d58 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 20:56:18 +0100
Subject: [PATCH 109/147] Fix some remaining type errors

---
 freqtrade/freqtradebot.py | 7 +++----
 freqtrade/rpc/telegram.py | 2 +-
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 3aa1075d8..1f7b4493c 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -948,7 +948,6 @@ class FreqtradeBot(LoggingMixin):
         """
         Sends rpc notification when a entry order occurred.
         """
-        msg_type = RPCMessageType.ENTRY_FILL if fill else RPCMessageType.ENTRY
         open_rate = order.safe_price
 
         if open_rate is None:
@@ -961,7 +960,7 @@ class FreqtradeBot(LoggingMixin):
 
         msg: RPCBuyMsg = {
             'trade_id': trade.id,
-            'type': msg_type,
+            'type': RPCMessageType.ENTRY_FILL if fill else RPCMessageType.ENTRY,
             'buy_tag': trade.enter_tag,
             'enter_tag': trade.enter_tag,
             'exchange': trade.exchange.capitalize(),
@@ -1860,7 +1859,7 @@ class FreqtradeBot(LoggingMixin):
         if prot_trig:
             msg: RPCProtectionMsg = {
                 'type': RPCMessageType.PROTECTION_TRIGGER,
-                **prot_trig.to_json()
+                **prot_trig.to_json()  # type: ignore
             }
             self.rpc.send_msg(msg)
 
@@ -1868,7 +1867,7 @@ class FreqtradeBot(LoggingMixin):
         if prot_trig_glb:
             msg = {
                 'type': RPCMessageType.PROTECTION_TRIGGER_GLOBAL,
-                **prot_trig_glb.to_json()
+                **prot_trig_glb.to_json()  # type: ignore
             }
             self.rpc.send_msg(msg)
 
diff --git a/freqtrade/rpc/telegram.py b/freqtrade/rpc/telegram.py
index 6f34b7325..d79d8ea76 100644
--- a/freqtrade/rpc/telegram.py
+++ b/freqtrade/rpc/telegram.py
@@ -454,7 +454,7 @@ class Telegram(RPCHandler):
             # Notification disabled
             return
 
-        message = self.compose_message(deepcopy(msg), msg_type)
+        message = self.compose_message(deepcopy(msg), msg_type)  # type: ignore
         if message:
             self._send_msg(message, disable_notification=(noti == 'silent'))
 

From cbdd86d7775ac767b45c0ce4673cb192eeb30fad Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Fri, 24 Mar 2023 21:05:10 +0100
Subject: [PATCH 110/147] Fix test failures due to additional field

---
 freqtrade/rpc/rpc_types.py | 4 ++--
 tests/test_freqtradebot.py | 5 +++++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/freqtrade/rpc/rpc_types.py b/freqtrade/rpc/rpc_types.py
index a290ee78c..3277a2d6e 100644
--- a/freqtrade/rpc/rpc_types.py
+++ b/freqtrade/rpc/rpc_types.py
@@ -96,7 +96,7 @@ class RPCSellCancelMsg(__RPCBuyMsgBase):
     close_date: datetime
 
 
-class __AnalyzedDFData(TypedDict):
+class _AnalyzedDFData(TypedDict):
     key: PairWithTimeframe
     df: Any
     la: datetime
@@ -105,7 +105,7 @@ class __AnalyzedDFData(TypedDict):
 class RPCAnalyzedDFMsg(RPCSendMsgBase):
     """New Analyzed dataframe message"""
     type: Literal[RPCMessageType.ANALYZED_DF]
-    data: __AnalyzedDFData
+    data: _AnalyzedDFData
 
 
 class RPCNewCandleMsg(RPCSendMsgBase):
diff --git a/tests/test_freqtradebot.py b/tests/test_freqtradebot.py
index cea70ec48..da98fed94 100644
--- a/tests/test_freqtradebot.py
+++ b/tests/test_freqtradebot.py
@@ -3326,6 +3326,7 @@ def test_execute_trade_exit_up(default_conf_usdt, ticker_usdt, fee, ticker_usdt_
         'profit_ratio': 0.00493809 if is_short else 0.09451372,
         'stake_currency': 'USDT',
         'fiat_currency': 'USD',
+        'base_currency': 'ETH',
         'sell_reason': ExitType.ROI.value,
         'exit_reason': ExitType.ROI.value,
         'open_date': ANY,
@@ -3389,6 +3390,7 @@ def test_execute_trade_exit_down(default_conf_usdt, ticker_usdt, fee, ticker_usd
         'profit_amount': -5.65990099 if is_short else -0.00075,
         'profit_ratio': -0.0945681 if is_short else -1.247e-05,
         'stake_currency': 'USDT',
+        'base_currency': 'ETH',
         'fiat_currency': 'USD',
         'sell_reason': ExitType.STOP_LOSS.value,
         'exit_reason': ExitType.STOP_LOSS.value,
@@ -3474,6 +3476,7 @@ def test_execute_trade_exit_custom_exit_price(
         'profit_amount': pytest.approx(profit_amount),
         'profit_ratio': profit_ratio,
         'stake_currency': 'USDT',
+        'base_currency': 'ETH',
         'fiat_currency': 'USD',
         'sell_reason': 'foo',
         'exit_reason': 'foo',
@@ -3547,6 +3550,7 @@ def test_execute_trade_exit_down_stoploss_on_exchange_dry_run(
         'profit_ratio': -0.00501253 if is_short else -0.01493766,
         'stake_currency': 'USDT',
         'fiat_currency': 'USD',
+        'base_currency': 'ETH',
         'sell_reason': ExitType.STOP_LOSS.value,
         'exit_reason': ExitType.STOP_LOSS.value,
         'open_date': ANY,
@@ -3811,6 +3815,7 @@ def test_execute_trade_exit_market_order(
         'profit_amount': pytest.approx(profit_amount),
         'profit_ratio': profit_ratio,
         'stake_currency': 'USDT',
+        'base_currency': 'ETH',
         'fiat_currency': 'USD',
         'sell_reason': ExitType.ROI.value,
         'exit_reason': ExitType.ROI.value,

From c0a57d352f7f8058cb20c4b60b4b5779ca9b1a45 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 08:16:07 +0100
Subject: [PATCH 111/147] send base_currency with messages that need it.

---
 freqtrade/freqtradebot.py    | 2 ++
 freqtrade/rpc/rpc_manager.py | 4 ----
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 1f7b4493c..1f072571d 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -1859,6 +1859,7 @@ class FreqtradeBot(LoggingMixin):
         if prot_trig:
             msg: RPCProtectionMsg = {
                 'type': RPCMessageType.PROTECTION_TRIGGER,
+                'base_currency': self.exchange.get_pair_base_currency(prot_trig.pair),
                 **prot_trig.to_json()  # type: ignore
             }
             self.rpc.send_msg(msg)
@@ -1867,6 +1868,7 @@ class FreqtradeBot(LoggingMixin):
         if prot_trig_glb:
             msg = {
                 'type': RPCMessageType.PROTECTION_TRIGGER_GLOBAL,
+                'base_currency': self.exchange.get_pair_base_currency(prot_trig_glb.pair),
                 **prot_trig_glb.to_json()  # type: ignore
             }
             self.rpc.send_msg(msg)
diff --git a/freqtrade/rpc/rpc_manager.py b/freqtrade/rpc/rpc_manager.py
index e4c925995..1972ad6e5 100644
--- a/freqtrade/rpc/rpc_manager.py
+++ b/freqtrade/rpc/rpc_manager.py
@@ -70,10 +70,6 @@ class RPCManager:
         """
         if msg.get('type') not in NO_ECHO_MESSAGES:
             logger.info('Sending rpc message: %s', msg)
-        if 'pair' in msg:
-            msg.update({
-                'base_currency': self._rpc._freqtrade.exchange.get_pair_base_currency(msg['pair'])
-                })
         for mod in self.registered_modules:
             logger.debug('Forwarding message to rpc.%s', mod.name)
             try:

From 79a2de7a64a7a737bf6bdc593a187dd422453bb2 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 08:31:35 +0100
Subject: [PATCH 112/147] Reduce impact of short outages

---
 tests/exchange/test_ccxt_compat.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/tests/exchange/test_ccxt_compat.py b/tests/exchange/test_ccxt_compat.py
index 872cf5059..4a65b16d7 100644
--- a/tests/exchange/test_ccxt_compat.py
+++ b/tests/exchange/test_ccxt_compat.py
@@ -37,7 +37,7 @@ EXCHANGES = {
         'stake_currency': 'USDT',
         'use_ci_proxy': True,
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'futures': True,
         'futures_pair': 'BTC/USDT:USDT',
         'hasQuoteVolumeFutures': True,
@@ -66,7 +66,7 @@ EXCHANGES = {
         'pair': 'BTC/USDT',
         'stake_currency': 'USDT',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'futures': False,
         'sample_order': [{
             "symbol": "SOLUSDT",
@@ -91,7 +91,7 @@ EXCHANGES = {
         'pair': 'BTC/USDT',
         'stake_currency': 'USDT',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'leverage_tiers_public': False,
         'leverage_in_spot_market': True,
     },
@@ -99,7 +99,7 @@ EXCHANGES = {
         'pair': 'XRP/USDT',
         'stake_currency': 'USDT',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'leverage_tiers_public': False,
         'leverage_in_spot_market': True,
         'sample_order': [
@@ -141,7 +141,7 @@ EXCHANGES = {
         'pair': 'BTC/USDT',
         'stake_currency': 'USDT',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'futures': True,
         'futures_pair': 'BTC/USDT:USDT',
         'hasQuoteVolumeFutures': True,
@@ -215,7 +215,7 @@ EXCHANGES = {
         'pair': 'BTC/USDT',
         'stake_currency': 'USDT',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'futures': True,
         'futures_pair': 'BTC/USDT:USDT',
         'hasQuoteVolumeFutures': False,
@@ -226,7 +226,7 @@ EXCHANGES = {
         'pair': 'BTC/USDT',
         'stake_currency': 'USDT',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'futures_pair': 'BTC/USDT:USDT',
         'futures': True,
         'leverage_tiers_public': True,
@@ -253,14 +253,14 @@ EXCHANGES = {
         'pair': 'ETH/BTC',
         'stake_currency': 'BTC',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'futures': False,
     },
     'bitvavo': {
         'pair': 'BTC/EUR',
         'stake_currency': 'EUR',
         'hasQuoteVolume': True,
-        'timeframe': '5m',
+        'timeframe': '1h',
         'leverage_tiers_public': False,
         'leverage_in_spot_market': False,
     },

From 56170dba19b5d46fc5884e17d786b0f17fb0feda Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 08:44:35 +0100
Subject: [PATCH 113/147] use github to download guess instead of gnu.org

gnu.org seems down rn (dns does no longer resolve),
and doesn't have good uptime history
---
 build_helpers/install_ta-lib.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/build_helpers/install_ta-lib.sh b/build_helpers/install_ta-lib.sh
index 079d578b4..005d9abca 100755
--- a/build_helpers/install_ta-lib.sh
+++ b/build_helpers/install_ta-lib.sh
@@ -8,8 +8,8 @@ if [ -n "$2" ] || [ ! -f "${INSTALL_LOC}/lib/libta_lib.a" ]; then
   tar zxvf ta-lib-0.4.0-src.tar.gz
   cd ta-lib \
   && sed -i.bak "s|0.00000001|0.000000000000000001 |g" src/ta_func/ta_utility.h \
-  && curl 'http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD' -o config.guess \
-  && curl 'http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.sub;hb=HEAD' -o config.sub \
+  && curl 'https://raw.githubusercontent.com/gcc-mirror/gcc/master/config.guess' -o config.guess \
+  && curl 'https://raw.githubusercontent.com/gcc-mirror/gcc/master/config.sub' -o config.sub \
   && ./configure --prefix=${INSTALL_LOC}/ \
   && make
   if [ $? -ne 0 ]; then

From cdd44a40058bd8bce80519d8f79007ff1034fb3a Mon Sep 17 00:00:00 2001
From: linquanisaac <linquanisaac@aliyun.com>
Date: Sat, 25 Mar 2023 17:19:58 +0800
Subject: [PATCH 114/147] docs(protections): fix typo

---
 docs/includes/protections.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/includes/protections.md b/docs/includes/protections.md
index e0ad8189f..12af081c0 100644
--- a/docs/includes/protections.md
+++ b/docs/includes/protections.md
@@ -149,7 +149,7 @@ The below example assumes a timeframe of 1 hour:
 * Locks each pair after selling for an additional 5 candles (`CooldownPeriod`), giving other pairs a chance to get filled.
 * Stops trading for 4 hours (`4 * 1h candles`) if the last 2 days (`48 * 1h candles`) had 20 trades, which caused a max-drawdown of more than 20%. (`MaxDrawdown`).
 * Stops trading if more than 4 stoploss occur for all pairs within a 1 day (`24 * 1h candles`) limit (`StoplossGuard`).
-* Locks all pairs that had 4 Trades within the last 6 hours (`6 * 1h candles`) with a combined profit ratio of below 0.02 (<2%) (`LowProfitPairs`).
+* Locks all pairs that had 2 Trades within the last 6 hours (`6 * 1h candles`) with a combined profit ratio of below 0.02 (<2%) (`LowProfitPairs`).
 * Locks all pairs for 2 candles that had a profit of below 0.01 (<1%) within the last 24h (`24 * 1h candles`), a minimum of 4 trades.
 
 ``` python

From 9c6a49436bd17752a8c0921c801c642116658c95 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 11:42:19 +0100
Subject: [PATCH 115/147] Export amount/price precisions per trade

---
 freqtrade/persistence/trade_model.py  |   3 +
 tests/persistence/test_persistence.py | 256 ++++++++++++++------------
 tests/rpc/test_rpc.py                 |   3 +
 3 files changed, 141 insertions(+), 121 deletions(-)

diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 27be0d726..54ff1313b 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -560,6 +560,9 @@ class LocalTrade():
             'trading_mode': self.trading_mode,
             'funding_fees': self.funding_fees,
             'open_order_id': self.open_order_id,
+            'amount_precision': self.amount_precision,
+            'price_precision': self.price_precision,
+            'precision_mode': self.precision_mode,
             'orders': orders,
         }
 
diff --git a/tests/persistence/test_persistence.py b/tests/persistence/test_persistence.py
index db882d56d..23ec6d4fb 100644
--- a/tests/persistence/test_persistence.py
+++ b/tests/persistence/test_persistence.py
@@ -1330,71 +1330,78 @@ def test_to_json(fee):
         open_rate=0.123,
         exchange='binance',
         enter_tag=None,
-        open_order_id='dry_run_buy_12345'
+        open_order_id='dry_run_buy_12345',
+        precision_mode=1,
+        amount_precision=8.0,
+        price_precision=7.0,
     )
     result = trade.to_json()
     assert isinstance(result, dict)
 
-    assert result == {'trade_id': None,
-                      'pair': 'ADA/USDT',
-                      'base_currency': 'ADA',
-                      'quote_currency': 'USDT',
-                      'is_open': None,
-                      'open_date': trade.open_date.strftime(DATETIME_PRINT_FORMAT),
-                      'open_timestamp': int(trade.open_date.timestamp() * 1000),
-                      'open_order_id': 'dry_run_buy_12345',
-                      'close_date': None,
-                      'close_timestamp': None,
-                      'open_rate': 0.123,
-                      'open_rate_requested': None,
-                      'open_trade_value': 15.1668225,
-                      'fee_close': 0.0025,
-                      'fee_close_cost': None,
-                      'fee_close_currency': None,
-                      'fee_open': 0.0025,
-                      'fee_open_cost': None,
-                      'fee_open_currency': None,
-                      'close_rate': None,
-                      'close_rate_requested': None,
-                      'amount': 123.0,
-                      'amount_requested': 123.0,
-                      'stake_amount': 0.001,
-                      'max_stake_amount': None,
-                      'trade_duration': None,
-                      'trade_duration_s': None,
-                      'realized_profit': 0.0,
-                      'realized_profit_ratio': None,
-                      'close_profit': None,
-                      'close_profit_pct': None,
-                      'close_profit_abs': None,
-                      'profit_ratio': None,
-                      'profit_pct': None,
-                      'profit_abs': None,
-                      'exit_reason': None,
-                      'exit_order_status': None,
-                      'stop_loss_abs': None,
-                      'stop_loss_ratio': None,
-                      'stop_loss_pct': None,
-                      'stoploss_order_id': None,
-                      'stoploss_last_update': None,
-                      'stoploss_last_update_timestamp': None,
-                      'initial_stop_loss_abs': None,
-                      'initial_stop_loss_pct': None,
-                      'initial_stop_loss_ratio': None,
-                      'min_rate': None,
-                      'max_rate': None,
-                      'strategy': None,
-                      'enter_tag': None,
-                      'timeframe': None,
-                      'exchange': 'binance',
-                      'leverage': None,
-                      'interest_rate': None,
-                      'liquidation_price': None,
-                      'is_short': None,
-                      'trading_mode': None,
-                      'funding_fees': None,
-                      'orders': [],
-                      }
+    assert result == {
+        'trade_id': None,
+        'pair': 'ADA/USDT',
+        'base_currency': 'ADA',
+        'quote_currency': 'USDT',
+        'is_open': None,
+        'open_date': trade.open_date.strftime(DATETIME_PRINT_FORMAT),
+        'open_timestamp': int(trade.open_date.timestamp() * 1000),
+        'open_order_id': 'dry_run_buy_12345',
+        'close_date': None,
+        'close_timestamp': None,
+        'open_rate': 0.123,
+        'open_rate_requested': None,
+        'open_trade_value': 15.1668225,
+        'fee_close': 0.0025,
+        'fee_close_cost': None,
+        'fee_close_currency': None,
+        'fee_open': 0.0025,
+        'fee_open_cost': None,
+        'fee_open_currency': None,
+        'close_rate': None,
+        'close_rate_requested': None,
+        'amount': 123.0,
+        'amount_requested': 123.0,
+        'stake_amount': 0.001,
+        'max_stake_amount': None,
+        'trade_duration': None,
+        'trade_duration_s': None,
+        'realized_profit': 0.0,
+        'realized_profit_ratio': None,
+        'close_profit': None,
+        'close_profit_pct': None,
+        'close_profit_abs': None,
+        'profit_ratio': None,
+        'profit_pct': None,
+        'profit_abs': None,
+        'exit_reason': None,
+        'exit_order_status': None,
+        'stop_loss_abs': None,
+        'stop_loss_ratio': None,
+        'stop_loss_pct': None,
+        'stoploss_order_id': None,
+        'stoploss_last_update': None,
+        'stoploss_last_update_timestamp': None,
+        'initial_stop_loss_abs': None,
+        'initial_stop_loss_pct': None,
+        'initial_stop_loss_ratio': None,
+        'min_rate': None,
+        'max_rate': None,
+        'strategy': None,
+        'enter_tag': None,
+        'timeframe': None,
+        'exchange': 'binance',
+        'leverage': None,
+        'interest_rate': None,
+        'liquidation_price': None,
+        'is_short': None,
+        'trading_mode': None,
+        'funding_fees': None,
+        'amount_precision': 8.0,
+        'price_precision': 7.0,
+        'precision_mode': 1,
+        'orders': [],
+    }
 
     # Simulate dry_run entries
     trade = Trade(
@@ -1410,70 +1417,77 @@ def test_to_json(fee):
         close_rate=0.125,
         enter_tag='buys_signal_001',
         exchange='binance',
+        precision_mode=2,
+        amount_precision=7.0,
+        price_precision=8.0,
     )
     result = trade.to_json()
     assert isinstance(result, dict)
 
-    assert result == {'trade_id': None,
-                      'pair': 'XRP/BTC',
-                      'base_currency': 'XRP',
-                      'quote_currency': 'BTC',
-                      'open_date': trade.open_date.strftime(DATETIME_PRINT_FORMAT),
-                      'open_timestamp': int(trade.open_date.timestamp() * 1000),
-                      'close_date': trade.close_date.strftime(DATETIME_PRINT_FORMAT),
-                      'close_timestamp': int(trade.close_date.timestamp() * 1000),
-                      'open_rate': 0.123,
-                      'close_rate': 0.125,
-                      'amount': 100.0,
-                      'amount_requested': 101.0,
-                      'stake_amount': 0.001,
-                      'max_stake_amount': None,
-                      'trade_duration': 60,
-                      'trade_duration_s': 3600,
-                      'stop_loss_abs': None,
-                      'stop_loss_pct': None,
-                      'stop_loss_ratio': None,
-                      'stoploss_order_id': None,
-                      'stoploss_last_update': None,
-                      'stoploss_last_update_timestamp': None,
-                      'initial_stop_loss_abs': None,
-                      'initial_stop_loss_pct': None,
-                      'initial_stop_loss_ratio': None,
-                      'realized_profit': 0.0,
-                      'realized_profit_ratio': None,
-                      'close_profit': None,
-                      'close_profit_pct': None,
-                      'close_profit_abs': None,
-                      'profit_ratio': None,
-                      'profit_pct': None,
-                      'profit_abs': None,
-                      'close_rate_requested': None,
-                      'fee_close': 0.0025,
-                      'fee_close_cost': None,
-                      'fee_close_currency': None,
-                      'fee_open': 0.0025,
-                      'fee_open_cost': None,
-                      'fee_open_currency': None,
-                      'is_open': None,
-                      'max_rate': None,
-                      'min_rate': None,
-                      'open_order_id': None,
-                      'open_rate_requested': None,
-                      'open_trade_value': 12.33075,
-                      'exit_reason': None,
-                      'exit_order_status': None,
-                      'strategy': None,
-                      'enter_tag': 'buys_signal_001',
-                      'timeframe': None,
-                      'exchange': 'binance',
-                      'leverage': None,
-                      'interest_rate': None,
-                      'liquidation_price': None,
-                      'is_short': None,
-                      'trading_mode': None,
-                      'funding_fees': None,
-                      'orders': [],
-                      }
+    assert result == {
+        'trade_id': None,
+        'pair': 'XRP/BTC',
+        'base_currency': 'XRP',
+        'quote_currency': 'BTC',
+        'open_date': trade.open_date.strftime(DATETIME_PRINT_FORMAT),
+        'open_timestamp': int(trade.open_date.timestamp() * 1000),
+        'close_date': trade.close_date.strftime(DATETIME_PRINT_FORMAT),
+        'close_timestamp': int(trade.close_date.timestamp() * 1000),
+        'open_rate': 0.123,
+        'close_rate': 0.125,
+        'amount': 100.0,
+        'amount_requested': 101.0,
+        'stake_amount': 0.001,
+        'max_stake_amount': None,
+        'trade_duration': 60,
+        'trade_duration_s': 3600,
+        'stop_loss_abs': None,
+        'stop_loss_pct': None,
+        'stop_loss_ratio': None,
+        'stoploss_order_id': None,
+        'stoploss_last_update': None,
+        'stoploss_last_update_timestamp': None,
+        'initial_stop_loss_abs': None,
+        'initial_stop_loss_pct': None,
+        'initial_stop_loss_ratio': None,
+        'realized_profit': 0.0,
+        'realized_profit_ratio': None,
+        'close_profit': None,
+        'close_profit_pct': None,
+        'close_profit_abs': None,
+        'profit_ratio': None,
+        'profit_pct': None,
+        'profit_abs': None,
+        'close_rate_requested': None,
+        'fee_close': 0.0025,
+        'fee_close_cost': None,
+        'fee_close_currency': None,
+        'fee_open': 0.0025,
+        'fee_open_cost': None,
+        'fee_open_currency': None,
+        'is_open': None,
+        'max_rate': None,
+        'min_rate': None,
+        'open_order_id': None,
+        'open_rate_requested': None,
+        'open_trade_value': 12.33075,
+        'exit_reason': None,
+        'exit_order_status': None,
+        'strategy': None,
+        'enter_tag': 'buys_signal_001',
+        'timeframe': None,
+        'exchange': 'binance',
+        'leverage': None,
+        'interest_rate': None,
+        'liquidation_price': None,
+        'is_short': None,
+        'trading_mode': None,
+        'funding_fees': None,
+        'amount_precision': 7.0,
+        'price_precision': 8.0,
+        'precision_mode': 2,
+        'orders': [],
+    }
 
 
 def test_stoploss_reinitialization(default_conf, fee):
diff --git a/tests/rpc/test_rpc.py b/tests/rpc/test_rpc.py
index 4e2dc94ae..ff08a0564 100644
--- a/tests/rpc/test_rpc.py
+++ b/tests/rpc/test_rpc.py
@@ -88,6 +88,9 @@ def test_rpc_trade_status(default_conf, ticker, fee, mocker) -> None:
         'is_short': False,
         'funding_fees': 0.0,
         'trading_mode': TradingMode.SPOT,
+        'amount_precision': 8.0,
+        'price_precision': 8.0,
+        'precision_mode': 2,
         'orders': [{
             'amount': 91.07468123, 'average': 1.098e-05, 'safe_price': 1.098e-05,
             'cost': 0.0009999999999054, 'filled': 91.07468123, 'ft_order_side': 'buy',

From f7c1ee6d3e1aa9f40ba5329d70cbe3e291c77581 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 11:55:47 +0100
Subject: [PATCH 116/147] add precision values to api schema

---
 freqtrade/rpc/api_server/api_schemas.py | 4 ++++
 tests/rpc/test_rpc_apiserver.py         | 6 ++++++
 2 files changed, 10 insertions(+)

diff --git a/freqtrade/rpc/api_server/api_schemas.py b/freqtrade/rpc/api_server/api_schemas.py
index 18621ccbd..7497b27f1 100644
--- a/freqtrade/rpc/api_server/api_schemas.py
+++ b/freqtrade/rpc/api_server/api_schemas.py
@@ -276,6 +276,10 @@ class TradeSchema(BaseModel):
     funding_fees: Optional[float]
     trading_mode: Optional[TradingMode]
 
+    amount_precision: Optional[float]
+    price_precision: Optional[float]
+    precision_mode: Optional[int]
+
 
 class OpenTradeSchema(TradeSchema):
     stoploss_current_dist: Optional[float]
diff --git a/tests/rpc/test_rpc_apiserver.py b/tests/rpc/test_rpc_apiserver.py
index 97319b78b..bf9d6cc3b 100644
--- a/tests/rpc/test_rpc_apiserver.py
+++ b/tests/rpc/test_rpc_apiserver.py
@@ -1066,6 +1066,9 @@ def test_api_status(botclient, mocker, ticker, fee, markets, is_short,
         'liquidation_price': None,
         'funding_fees': None,
         'trading_mode': ANY,
+        'amount_precision': None,
+        'price_precision': None,
+        'precision_mode': None,
         'orders': [ANY],
     }
 
@@ -1271,6 +1274,9 @@ def test_api_force_entry(botclient, mocker, fee, endpoint):
         'liquidation_price': None,
         'funding_fees': None,
         'trading_mode': 'spot',
+        'amount_precision': None,
+        'price_precision': None,
+        'precision_mode': None,
         'orders': [],
     }
 

From 68154a1f52c002944132242a089de29f27b0196e Mon Sep 17 00:00:00 2001
From: robcaulk <rob.caulk@gmail.com>
Date: Sat, 25 Mar 2023 11:57:52 +0100
Subject: [PATCH 117/147] document why users cant arbitrarily change parameter
 spaces...

---
 docs/freqai-running.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/freqai-running.md b/docs/freqai-running.md
index 1eaee1bf2..f3ccc546f 100644
--- a/docs/freqai-running.md
+++ b/docs/freqai-running.md
@@ -128,6 +128,9 @@ The FreqAI specific parameter `label_period_candles` defines the offset (number
 
 You can choose to adopt a continual learning scheme by setting `"continual_learning": true` in the config. By enabling `continual_learning`, after training an initial model from scratch, subsequent trainings will start from the final model state of the preceding training. This gives the new model a "memory" of the previous state. By default, this is set to `False` which means that all new models are trained from scratch, without input from previous models.
 
+???+ danger "Continual learning enforces a constant parameter space"
+    Since `continual_learning` means that the model parameter space *cannot* change between trainings, `principal_component_analysis` is automatically disabled when `continual_learning` is enabled. Hint: PCA changes the parameter space and the number of features, learn more about PCA [here](freqai-feature-engineering.md#data-dimensionality-reduction-with-principal-component-analysis).
+
 ## Hyperopt
 
 You can hyperopt using the same command as for [typical Freqtrade hyperopt](hyperopt.md):

From d9c8b322ce45c88abeb23ffc63ad815e10c72e74 Mon Sep 17 00:00:00 2001
From: Robert Caulk <rob.caulk@gmail.com>
Date: Sat, 25 Mar 2023 13:37:07 +0100
Subject: [PATCH 118/147] Update freqai_interface.py

---
 freqtrade/freqai/freqai_interface.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/freqtrade/freqai/freqai_interface.py b/freqtrade/freqai/freqai_interface.py
index 8e842b8f2..b657bd811 100644
--- a/freqtrade/freqai/freqai_interface.py
+++ b/freqtrade/freqai/freqai_interface.py
@@ -109,7 +109,6 @@ class IFreqaiModel(ABC):
             self.ft_params.update({'principal_component_analysis': False})
             logger.warning('User tried to use PCA with continual learning. Deactivating PCA.')
 
-
         record_params(config, self.full_path)
 
     def __getstate__(self):

From 486d8a48a05befc9dee60da922f319b51aebc651 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 19:36:28 +0100
Subject: [PATCH 119/147] Fix docs (buffer_train_data_candles is an integer,
 not a boolean)

closes #8384
---
 docs/freqai-parameter-table.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/freqai-parameter-table.md b/docs/freqai-parameter-table.md
index f67ea8541..9822a895a 100644
--- a/docs/freqai-parameter-table.md
+++ b/docs/freqai-parameter-table.md
@@ -46,7 +46,7 @@ Mandatory parameters are marked as **Required** and have to be set in one of the
 | `outlier_protection_percentage` | Enable to prevent outlier detection methods from discarding too much data. If more than `outlier_protection_percentage` % of points are detected as outliers by the SVM or DBSCAN, FreqAI will log a warning message and ignore outlier detection, i.e., the original dataset will be kept intact. If the outlier protection is triggered, no predictions will be made based on the training dataset. <br> **Datatype:** Float. <br> Default: `30`.
 | `reverse_train_test_order` | Split the feature dataset (see below) and use the latest data split for training and test on historical split of the data. This allows the model to be trained up to the most recent data point, while avoiding overfitting. However, you should be careful to understand the unorthodox nature of this parameter before employing it. <br> **Datatype:** Boolean. <br> Default: `False` (no reversal).
 | `shuffle_after_split` | Split the data into train and test sets, and then shuffle both sets individually. <br> **Datatype:** Boolean. <br> Default: `False`.
-| `buffer_train_data_candles` | Cut `buffer_train_data_candles` off the beginning and end of the training data *after* the indicators were populated. The main example use is when predicting maxima and minima, the argrelextrema function  cannot know the maxima/minima at the edges of the timerange. To improve model accuracy, it is best to compute argrelextrema on the full timerange and then use this function to cut off the edges (buffer) by the kernel. In another case, if the targets are set to a shifted price movement, this buffer is unnecessary because the shifted candles at the end of the timerange will be NaN and FreqAI will automatically cut those off of the training dataset.<br> **Datatype:** Boolean. <br> Default: `False`.
+| `buffer_train_data_candles` | Cut `buffer_train_data_candles` off the beginning and end of the training data *after* the indicators were populated. The main example use is when predicting maxima and minima, the argrelextrema function  cannot know the maxima/minima at the edges of the timerange. To improve model accuracy, it is best to compute argrelextrema on the full timerange and then use this function to cut off the edges (buffer) by the kernel. In another case, if the targets are set to a shifted price movement, this buffer is unnecessary because the shifted candles at the end of the timerange will be NaN and FreqAI will automatically cut those off of the training dataset.<br> **Datatype:** Integer. <br> Default: `0`.
 
 ### Data split parameters
 

From 298f5685ee3f3c902243efe0e953fb83076bffa6 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 20:06:21 +0100
Subject: [PATCH 120/147] Reuse existing "cancel_stoploss" call

---
 freqtrade/freqtradebot.py  | 12 ++++--------
 tests/test_freqtradebot.py | 16 +++++++++-------
 2 files changed, 13 insertions(+), 15 deletions(-)

diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index 623d39c09..4482f37bf 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -854,7 +854,8 @@ class FreqtradeBot(LoggingMixin):
                 # Reset stoploss order id.
                 trade.stoploss_order_id = None
             except InvalidOrderException:
-                logger.exception(f"Could not cancel stoploss order {trade.stoploss_order_id}")
+                logger.exception(f"Could not cancel stoploss order {trade.stoploss_order_id} "
+                                 f"for pair {trade.pair}")
         return trade
 
     def get_valid_enter_price_and_stake(
@@ -1239,13 +1240,8 @@ class FreqtradeBot(LoggingMixin):
                 # cancelling the current stoploss on exchange first
                 logger.info(f"Cancelling current stoploss on exchange for pair {trade.pair} "
                             f"(orderid:{order['id']}) in order to add another one ...")
-                try:
-                    co = self.exchange.cancel_stoploss_order_with_result(order['id'], trade.pair,
-                                                                         trade.amount)
-                    trade.update_order(co)
-                except InvalidOrderException:
-                    logger.exception(f"Could not cancel stoploss order {order['id']} "
-                                     f"for pair {trade.pair}")
+
+                self.cancel_stoploss_on_exchange(trade)
 
                 # Create new stoploss order
                 if not self.create_stoploss_order(trade=trade, stop_price=stoploss_norm):
diff --git a/tests/test_freqtradebot.py b/tests/test_freqtradebot.py
index cea70ec48..ff10cd2f0 100644
--- a/tests/test_freqtradebot.py
+++ b/tests/test_freqtradebot.py
@@ -1440,11 +1440,11 @@ def test_handle_stoploss_on_exchange_trailing(
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
-    trade.stoploss_order_id = 100
+    trade.stoploss_order_id = '100'
     trade.stoploss_last_update = arrow.utcnow().shift(minutes=-20).datetime
 
     stoploss_order_hanging = MagicMock(return_value={
-        'id': 100,
+        'id': '100',
         'status': 'open',
         'type': 'stop_loss_limit',
         'price': hang_price,
@@ -1483,13 +1483,14 @@ def test_handle_stoploss_on_exchange_trailing(
 
     assert freqtrade.handle_trade(trade) is False
     assert trade.stop_loss == stop_price[1]
+    trade.stoploss_order_id = '100'
 
     # setting stoploss_on_exchange_interval to 0 seconds
     freqtrade.strategy.order_types['stoploss_on_exchange_interval'] = 0
 
     assert freqtrade.handle_stoploss_on_exchange(trade) is False
 
-    cancel_order_mock.assert_called_once_with(100, 'ETH/USDT')
+    cancel_order_mock.assert_called_once_with('100', 'ETH/USDT')
     stoploss_order_mock.assert_called_once_with(
         amount=pytest.approx(amt),
         pair='ETH/USDT',
@@ -1673,11 +1674,11 @@ def test_handle_stoploss_on_exchange_custom_stop(
     trade.is_short = is_short
     trade.is_open = True
     trade.open_order_id = None
-    trade.stoploss_order_id = 100
+    trade.stoploss_order_id = '100'
     trade.stoploss_last_update = arrow.utcnow().shift(minutes=-601).datetime
 
     stoploss_order_hanging = MagicMock(return_value={
-        'id': 100,
+        'id': '100',
         'status': 'open',
         'type': 'stop_loss_limit',
         'price': 3,
@@ -1706,6 +1707,7 @@ def test_handle_stoploss_on_exchange_custom_stop(
     stoploss_order_mock = MagicMock(return_value={'id': 'so1'})
     mocker.patch(f'{EXMS}.cancel_stoploss_order', cancel_order_mock)
     mocker.patch(f'{EXMS}.create_stoploss', stoploss_order_mock)
+    trade.stoploss_order_id = '100'
 
     # stoploss should not be updated as the interval is 60 seconds
     assert freqtrade.handle_trade(trade) is False
@@ -1722,7 +1724,7 @@ def test_handle_stoploss_on_exchange_custom_stop(
 
     assert freqtrade.handle_stoploss_on_exchange(trade) is False
 
-    cancel_order_mock.assert_called_once_with(100, 'ETH/USDT')
+    cancel_order_mock.assert_called_once_with('100', 'ETH/USDT')
     # Long uses modified ask - offset, short modified bid + offset
     stoploss_order_mock.assert_called_once_with(
         amount=pytest.approx(trade.amount),
@@ -3588,7 +3590,7 @@ def test_execute_trade_exit_sloe_cancel_exception(
     freqtrade.execute_trade_exit(trade=trade, limit=1234,
                                  exit_check=ExitCheckTuple(exit_type=ExitType.STOP_LOSS))
     assert create_order_mock.call_count == 2
-    assert log_has('Could not cancel stoploss order abcd', caplog)
+    assert log_has('Could not cancel stoploss order abcd for pair ETH/USDT', caplog)
 
 
 @pytest.mark.parametrize("is_short", [False, True])

From ee205ddc862ee0105e570deed47b728272d21521 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sat, 25 Mar 2023 20:26:56 +0100
Subject: [PATCH 121/147] Improve trade.from_json when stops are used

---
 freqtrade/persistence/trade_model.py     | 6 ++++--
 tests/persistence/test_trade_fromjson.py | 4 ++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/freqtrade/persistence/trade_model.py b/freqtrade/persistence/trade_model.py
index 54ff1313b..17117d436 100644
--- a/freqtrade/persistence/trade_model.py
+++ b/freqtrade/persistence/trade_model.py
@@ -1663,8 +1663,10 @@ class Trade(ModelBase, LocalTrade):
             stop_loss=data["stop_loss_abs"],
             stop_loss_pct=data["stop_loss_ratio"],
             stoploss_order_id=data["stoploss_order_id"],
-            stoploss_last_update=(datetime.fromtimestamp(data["stoploss_last_update"] // 1000,
-                                  tz=timezone.utc) if data["stoploss_last_update"] else None),
+            stoploss_last_update=(
+                datetime.fromtimestamp(data["stoploss_last_update_timestamp"] // 1000,
+                                       tz=timezone.utc)
+                if data["stoploss_last_update_timestamp"] else None),
             initial_stop_loss=data["initial_stop_loss_abs"],
             initial_stop_loss_pct=data["initial_stop_loss_ratio"],
             min_rate=data["min_rate"],
diff --git a/tests/persistence/test_trade_fromjson.py b/tests/persistence/test_trade_fromjson.py
index 529008e02..22053463d 100644
--- a/tests/persistence/test_trade_fromjson.py
+++ b/tests/persistence/test_trade_fromjson.py
@@ -50,8 +50,8 @@ def test_trade_fromjson():
         "stop_loss_ratio": -0.216,
         "stop_loss_pct": -21.6,
         "stoploss_order_id": null,
-        "stoploss_last_update": null,
-        "stoploss_last_update_timestamp": null,
+        "stoploss_last_update": "2022-10-18 09:13:42",
+        "stoploss_last_update_timestamp": 1666077222000,
         "initial_stop_loss_abs": 0.1981,
         "initial_stop_loss_ratio": -0.216,
         "initial_stop_loss_pct": -21.6,

From 86aef7cf9da6eec4c4bdb621bba33c7a38d7eeb5 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 11:21:18 +0200
Subject: [PATCH 122/147] Add current_time to bot_loop_start callbak

---
 docs/strategy-callbacks.md                                     | 3 ++-
 freqtrade/freqtradebot.py                                      | 3 ++-
 freqtrade/optimize/backtesting.py                              | 3 ++-
 freqtrade/plot/plotting.py                                     | 3 ++-
 freqtrade/strategy/interface.py                                | 3 ++-
 .../strategy_subtemplates/strategy_methods_advanced.j2         | 3 ++-
 6 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/docs/strategy-callbacks.md b/docs/strategy-callbacks.md
index 64b6bd551..bdc809a22 100644
--- a/docs/strategy-callbacks.md
+++ b/docs/strategy-callbacks.md
@@ -62,11 +62,12 @@ class AwesomeStrategy(IStrategy):
 
     # ... populate_* methods
 
-    def bot_loop_start(self, **kwargs) -> None:
+    def bot_loop_start(self, current_time: datetime, **kwargs) -> None:
         """
         Called at the start of the bot iteration (one loop).
         Might be used to perform pair-independent tasks
         (e.g. gather some remote resource for comparison)
+        :param current_time: datetime object, containing the current datetime
         :param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
         """
         if self.config['runmode'].value in ('live', 'dry_run'):
diff --git a/freqtrade/freqtradebot.py b/freqtrade/freqtradebot.py
index cec7176f6..21d23e49b 100644
--- a/freqtrade/freqtradebot.py
+++ b/freqtrade/freqtradebot.py
@@ -212,7 +212,8 @@ class FreqtradeBot(LoggingMixin):
         self.dataprovider.refresh(self.pairlists.create_pair_list(self.active_pair_whitelist),
                                   self.strategy.gather_informative_pairs())
 
-        strategy_safe_wrapper(self.strategy.bot_loop_start, supress_error=True)()
+        strategy_safe_wrapper(self.strategy.bot_loop_start, supress_error=True)(
+            current_time=datetime.now(timezone.utc))
 
         self.strategy.analyze(self.active_pair_whitelist)
 
diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index ccb027317..699e3c3cb 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -1158,7 +1158,8 @@ class Backtesting:
         while current_time <= end_date:
             open_trade_count_start = LocalTrade.bt_open_open_trade_count
             self.check_abort()
-            strategy_safe_wrapper(self.strategy.bot_loop_start, supress_error=True)()
+            strategy_safe_wrapper(self.strategy.bot_loop_start, supress_error=True)(
+                current_time=current_time)
             for i, pair in enumerate(data):
                 row_index = indexes[pair]
                 row = self.validate_row(data, pair, row_index, current_time)
diff --git a/freqtrade/plot/plotting.py b/freqtrade/plot/plotting.py
index 1b2ee44da..e415c4911 100644
--- a/freqtrade/plot/plotting.py
+++ b/freqtrade/plot/plotting.py
@@ -1,4 +1,5 @@
 import logging
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Dict, List, Optional
 
@@ -635,7 +636,7 @@ def load_and_plot_trades(config: Config):
     exchange = ExchangeResolver.load_exchange(config['exchange']['name'], config)
     IStrategy.dp = DataProvider(config, exchange)
     strategy.ft_bot_start()
-    strategy.bot_loop_start()
+    strategy.bot_loop_start(datetime.now(timezone.utc))
     plot_elements = init_plotscript(config, list(exchange.markets), strategy.startup_candle_count)
     timerange = plot_elements['timerange']
     trades = plot_elements['trades']
diff --git a/freqtrade/strategy/interface.py b/freqtrade/strategy/interface.py
index 96b2ac8ce..6d4a3036f 100644
--- a/freqtrade/strategy/interface.py
+++ b/freqtrade/strategy/interface.py
@@ -251,11 +251,12 @@ class IStrategy(ABC, HyperStrategyMixin):
         """
         pass
 
-    def bot_loop_start(self, **kwargs) -> None:
+    def bot_loop_start(self, current_time: datetime, **kwargs) -> None:
         """
         Called at the start of the bot iteration (one loop).
         Might be used to perform pair-independent tasks
         (e.g. gather some remote resource for comparison)
+        :param current_time: datetime object, containing the current datetime
         :param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
         """
         pass
diff --git a/freqtrade/templates/strategy_subtemplates/strategy_methods_advanced.j2 b/freqtrade/templates/strategy_subtemplates/strategy_methods_advanced.j2
index 488ca2fd7..bfbb20ec1 100644
--- a/freqtrade/templates/strategy_subtemplates/strategy_methods_advanced.j2
+++ b/freqtrade/templates/strategy_subtemplates/strategy_methods_advanced.j2
@@ -1,5 +1,5 @@
 
-def bot_loop_start(self, **kwargs) -> None:
+def bot_loop_start(self, current_time: datetime, **kwargs) -> None:
     """
     Called at the start of the bot iteration (one loop).
     Might be used to perform pair-independent tasks
@@ -8,6 +8,7 @@ def bot_loop_start(self, **kwargs) -> None:
     For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
 
     When not implemented by a strategy, this simply does nothing.
+    :param current_time: datetime object, containing the current datetime
     :param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
     """
     pass

From 7cdcd97c266662be3e0be79e9e8f39b4e8e81d7f Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 11:30:44 +0200
Subject: [PATCH 123/147] Update tests for new logic.

---
 tests/optimize/test_backtesting.py             | 6 ++++--
 tests/optimize/test_hyperopt.py                | 9 ++++++---
 tests/strategy/strats/hyperoptable_strategy.py | 2 ++
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/tests/optimize/test_backtesting.py b/tests/optimize/test_backtesting.py
index 8dee45b6d..9dbda51b0 100644
--- a/tests/optimize/test_backtesting.py
+++ b/tests/optimize/test_backtesting.py
@@ -344,7 +344,7 @@ def test_backtest_abort(default_conf, mocker, testdatadir) -> None:
     assert backtesting.progress.progress == 0
 
 
-def test_backtesting_start(default_conf, mocker, testdatadir, caplog) -> None:
+def test_backtesting_start(default_conf, mocker, caplog) -> None:
     def get_timerange(input1):
         return Arrow(2017, 11, 14, 21, 17), Arrow(2017, 11, 14, 22, 59)
 
@@ -367,6 +367,7 @@ def test_backtesting_start(default_conf, mocker, testdatadir, caplog) -> None:
     backtesting = Backtesting(default_conf)
     backtesting._set_strategy(backtesting.strategylist[0])
     backtesting.strategy.bot_loop_start = MagicMock()
+    backtesting.strategy.bot_start = MagicMock()
     backtesting.start()
     # check the logs, that will contain the backtest result
     exists = [
@@ -376,7 +377,8 @@ def test_backtesting_start(default_conf, mocker, testdatadir, caplog) -> None:
     for line in exists:
         assert log_has(line, caplog)
     assert backtesting.strategy.dp._pairlists is not None
-    assert backtesting.strategy.bot_loop_start.call_count == 1
+    assert backtesting.strategy.bot_start.call_count == 1
+    assert backtesting.strategy.bot_loop_start.call_count == 0
     assert sbs.call_count == 1
     assert sbc.call_count == 1
 
diff --git a/tests/optimize/test_hyperopt.py b/tests/optimize/test_hyperopt.py
index 998798580..786720030 100644
--- a/tests/optimize/test_hyperopt.py
+++ b/tests/optimize/test_hyperopt.py
@@ -872,7 +872,8 @@ def test_in_strategy_auto_hyperopt(mocker, hyperopt_conf, tmpdir, fee) -> None:
     hyperopt.backtesting.exchange.get_max_leverage = MagicMock(return_value=1.0)
     assert isinstance(hyperopt.custom_hyperopt, HyperOptAuto)
     assert isinstance(hyperopt.backtesting.strategy.buy_rsi, IntParameter)
-    assert hyperopt.backtesting.strategy.bot_loop_started is True
+    assert hyperopt.backtesting.strategy.bot_started is True
+    assert hyperopt.backtesting.strategy.bot_loop_started is False
 
     assert hyperopt.backtesting.strategy.buy_rsi.in_space is True
     assert hyperopt.backtesting.strategy.buy_rsi.value == 35
@@ -922,7 +923,8 @@ def test_in_strategy_auto_hyperopt_with_parallel(mocker, hyperopt_conf, tmpdir,
 
     assert isinstance(hyperopt.custom_hyperopt, HyperOptAuto)
     assert isinstance(hyperopt.backtesting.strategy.buy_rsi, IntParameter)
-    assert hyperopt.backtesting.strategy.bot_loop_started is True
+    assert hyperopt.backtesting.strategy.bot_started is True
+    assert hyperopt.backtesting.strategy.bot_loop_started is False
 
     assert hyperopt.backtesting.strategy.buy_rsi.in_space is True
     assert hyperopt.backtesting.strategy.buy_rsi.value == 35
@@ -959,7 +961,8 @@ def test_in_strategy_auto_hyperopt_per_epoch(mocker, hyperopt_conf, tmpdir, fee)
     hyperopt.backtesting.exchange.get_max_leverage = MagicMock(return_value=1.0)
     assert isinstance(hyperopt.custom_hyperopt, HyperOptAuto)
     assert isinstance(hyperopt.backtesting.strategy.buy_rsi, IntParameter)
-    assert hyperopt.backtesting.strategy.bot_loop_started is True
+    assert hyperopt.backtesting.strategy.bot_loop_started is False
+    assert hyperopt.backtesting.strategy.bot_started is True
 
     assert hyperopt.backtesting.strategy.buy_rsi.in_space is True
     assert hyperopt.backtesting.strategy.buy_rsi.value == 35
diff --git a/tests/strategy/strats/hyperoptable_strategy.py b/tests/strategy/strats/hyperoptable_strategy.py
index eadbc533f..d05e8ead2 100644
--- a/tests/strategy/strats/hyperoptable_strategy.py
+++ b/tests/strategy/strats/hyperoptable_strategy.py
@@ -50,6 +50,7 @@ class HyperoptableStrategy(StrategyTestV3):
         return prot
 
     bot_loop_started = False
+    bot_started = False
 
     def bot_loop_start(self):
         self.bot_loop_started = True
@@ -58,6 +59,7 @@ class HyperoptableStrategy(StrategyTestV3):
         """
         Parameters can also be defined here ...
         """
+        self.bot_started = True
         self.buy_rsi = IntParameter([0, 50], default=30, space='buy')
 
     def informative_pairs(self):

From 16057da6cc5f7c418df8c521a7d6dc11f1271267 Mon Sep 17 00:00:00 2001
From: escanoro <128816061+escanoro@users.noreply.github.com>
Date: Sun, 26 Mar 2023 14:09:41 +0200
Subject: [PATCH 124/147] typo:  above should be below

---
 docs/freqai-reinforcement-learning.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/freqai-reinforcement-learning.md b/docs/freqai-reinforcement-learning.md
index ed6a41825..f5679a4ba 100644
--- a/docs/freqai-reinforcement-learning.md
+++ b/docs/freqai-reinforcement-learning.md
@@ -55,7 +55,7 @@ where `ReinforcementLearner` will use the templated `ReinforcementLearner` from
         dataframe["&-action"] = 0
 ```
 
-Most of the function remains the same as for typical Regressors, however, the function above shows how the strategy must pass the raw price data to the agent so that it has access to raw OHLCV in the training environment:
+Most of the function remains the same as for typical Regressors, however, the function below shows how the strategy must pass the raw price data to the agent so that it has access to raw OHLCV in the training environment:
 
 ```python
     def feature_engineering_standard(self, dataframe, **kwargs):

From 444d18aa39cd7d143a152fa7d17ac79be3726a19 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 14:30:29 +0200
Subject: [PATCH 125/147] Revert binance PO fix, since ccxt has fixed this bug.

---
 freqtrade/exchange/binance.py  | 21 ---------------------
 tests/exchange/test_binance.py |  4 ++--
 2 files changed, 2 insertions(+), 23 deletions(-)

diff --git a/freqtrade/exchange/binance.py b/freqtrade/exchange/binance.py
index a89c02631..7ac496f62 100644
--- a/freqtrade/exchange/binance.py
+++ b/freqtrade/exchange/binance.py
@@ -7,7 +7,6 @@ from typing import Dict, List, Optional, Tuple
 import arrow
 import ccxt
 
-from freqtrade.constants import BuySell
 from freqtrade.enums import CandleType, MarginMode, PriceType, TradingMode
 from freqtrade.exceptions import DDosProtection, OperationalException, TemporaryError
 from freqtrade.exchange import Exchange
@@ -49,26 +48,6 @@ class Binance(Exchange):
         (TradingMode.FUTURES, MarginMode.ISOLATED)
     ]
 
-    def _get_params(
-        self,
-        side: BuySell,
-        ordertype: str,
-        leverage: float,
-        reduceOnly: bool,
-        time_in_force: str = 'GTC',
-    ) -> Dict:
-        params = super()._get_params(side, ordertype, leverage, reduceOnly, time_in_force)
-        if (
-            time_in_force == 'PO'
-            and ordertype != 'market'
-            and self.trading_mode == TradingMode.SPOT
-            # Only spot can do post only orders
-        ):
-            params.pop('timeInForce')
-            params['postOnly'] = True
-
-        return params
-
     def get_tickers(self, symbols: Optional[List[str]] = None, cached: bool = False) -> Tickers:
         tickers = super().get_tickers(symbols=symbols, cached=cached)
         if self.trading_mode == TradingMode.FUTURES:
diff --git a/tests/exchange/test_binance.py b/tests/exchange/test_binance.py
index 273860e15..fda33b859 100644
--- a/tests/exchange/test_binance.py
+++ b/tests/exchange/test_binance.py
@@ -15,8 +15,8 @@ from tests.exchange.test_exchange import ccxt_exceptionhandlers
     ('buy', 'limit', 'gtc', {'timeInForce': 'GTC'}),
     ('buy', 'limit', 'IOC', {'timeInForce': 'IOC'}),
     ('buy', 'market', 'IOC', {}),
-    ('buy', 'limit', 'PO', {'postOnly': True}),
-    ('sell', 'limit', 'PO', {'postOnly': True}),
+    ('buy', 'limit', 'PO', {'timeInForce': 'PO'}),
+    ('sell', 'limit', 'PO', {'timeInForce': 'PO'}),
     ('sell', 'market', 'PO', {}),
     ])
 def test__get_params_binance(default_conf, mocker, side, type, time_in_force, expected):

From fb1541bdf632c5c9b6f8e96907fbd1986ff0bff7 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 15:46:20 +0200
Subject: [PATCH 126/147] Explicitly close loop in async tests

---
 freqtrade/exchange/exchange.py  |  2 ++
 tests/exchange/test_exchange.py | 21 +++++++++++++--------
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/freqtrade/exchange/exchange.py b/freqtrade/exchange/exchange.py
index 104eaa221..92eb4b58a 100644
--- a/freqtrade/exchange/exchange.py
+++ b/freqtrade/exchange/exchange.py
@@ -205,6 +205,8 @@ class Exchange:
                 and self._api_async.session):
             logger.debug("Closing async ccxt session.")
             self.loop.run_until_complete(self._api_async.close())
+        if self.loop and not self.loop.is_closed():
+            self.loop.close()
 
     def validate_config(self, config):
         # Check if timeframe is available
diff --git a/tests/exchange/test_exchange.py b/tests/exchange/test_exchange.py
index 586f023b4..5350f4e3e 100644
--- a/tests/exchange/test_exchange.py
+++ b/tests/exchange/test_exchange.py
@@ -113,18 +113,21 @@ async def async_ccxt_exception(mocker, default_conf, api_mock, fun, mock_ccxt_fu
             exchange = get_patched_exchange(mocker, default_conf, api_mock)
             await getattr(exchange, fun)(**kwargs)
         assert api_mock.__dict__[mock_ccxt_fun].call_count == retries
+    exchange.close()
 
     with pytest.raises(TemporaryError):
         api_mock.__dict__[mock_ccxt_fun] = MagicMock(side_effect=ccxt.NetworkError("DeadBeef"))
         exchange = get_patched_exchange(mocker, default_conf, api_mock)
         await getattr(exchange, fun)(**kwargs)
     assert api_mock.__dict__[mock_ccxt_fun].call_count == retries
+    exchange.close()
 
     with pytest.raises(OperationalException):
         api_mock.__dict__[mock_ccxt_fun] = MagicMock(side_effect=ccxt.BaseError("DeadBeef"))
         exchange = get_patched_exchange(mocker, default_conf, api_mock)
         await getattr(exchange, fun)(**kwargs)
     assert api_mock.__dict__[mock_ccxt_fun].call_count == 1
+    exchange.close()
 
 
 def test_init(default_conf, mocker, caplog):
@@ -2248,7 +2251,6 @@ def test_refresh_latest_ohlcv_cache(mocker, default_conf, candle_type, time_mach
     assert res[pair2].at[0, 'open']
 
 
-@pytest.mark.asyncio
 @pytest.mark.parametrize("exchange_name", EXCHANGES)
 async def test__async_get_candle_history(default_conf, mocker, caplog, exchange_name):
     ohlcv = [
@@ -2277,7 +2279,7 @@ async def test__async_get_candle_history(default_conf, mocker, caplog, exchange_
     assert res[3] == ohlcv
     assert exchange._api_async.fetch_ohlcv.call_count == 1
     assert not log_has(f"Using cached candle (OHLCV) data for {pair} ...", caplog)
-
+    exchange.close()
     # exchange = Exchange(default_conf)
     await async_ccxt_exception(mocker, default_conf, MagicMock(),
                                "_async_get_candle_history", "fetch_ohlcv",
@@ -2292,15 +2294,17 @@ async def test__async_get_candle_history(default_conf, mocker, caplog, exchange_
         await exchange._async_get_candle_history(pair, "5m", CandleType.SPOT,
                                                  (arrow.utcnow().int_timestamp - 2000) * 1000)
 
+    exchange.close()
+
     with pytest.raises(OperationalException, match=r'Exchange.* does not support fetching '
                                                    r'historical candle \(OHLCV\) data\..*'):
         api_mock.fetch_ohlcv = MagicMock(side_effect=ccxt.NotSupported("Not supported"))
         exchange = get_patched_exchange(mocker, default_conf, api_mock, id=exchange_name)
         await exchange._async_get_candle_history(pair, "5m", CandleType.SPOT,
                                                  (arrow.utcnow().int_timestamp - 2000) * 1000)
+    exchange.close()
 
 
-@pytest.mark.asyncio
 async def test__async_kucoin_get_candle_history(default_conf, mocker, caplog):
     from freqtrade.exchange.common import _reset_logging_mixin
     _reset_logging_mixin()
@@ -2341,9 +2345,9 @@ async def test__async_kucoin_get_candle_history(default_conf, mocker, caplog):
         # Expect the "returned exception" message 12 times (4 retries * 3 (loop))
         assert num_log_has_re(msg, caplog) == 12
         assert num_log_has_re(msg2, caplog) == 9
+    exchange.close()
 
 
-@pytest.mark.asyncio
 async def test__async_get_candle_history_empty(default_conf, mocker, caplog):
     """ Test empty exchange result """
     ohlcv = []
@@ -2363,6 +2367,7 @@ async def test__async_get_candle_history_empty(default_conf, mocker, caplog):
     assert res[2] == CandleType.SPOT
     assert res[3] == ohlcv
     assert exchange._api_async.fetch_ohlcv.call_count == 1
+    exchange.close()
 
 
 def test_refresh_latest_ohlcv_inv_result(default_conf, mocker, caplog):
@@ -2757,7 +2762,6 @@ async def test___async_get_candle_history_sort(default_conf, mocker, exchange_na
     assert res_ohlcv[9][5] == 2.31452783
 
 
-@pytest.mark.asyncio
 @pytest.mark.parametrize("exchange_name", EXCHANGES)
 async def test__async_fetch_trades(default_conf, mocker, caplog, exchange_name,
                                    fetch_trades_result):
@@ -2785,8 +2789,8 @@ async def test__async_fetch_trades(default_conf, mocker, caplog, exchange_name,
     assert exchange._api_async.fetch_trades.call_args[1]['limit'] == 1000
     assert exchange._api_async.fetch_trades.call_args[1]['params'] == {'from': '123'}
     assert log_has_re(f"Fetching trades for pair {pair}, params: .*", caplog)
+    exchange.close()
 
-    exchange = Exchange(default_conf)
     await async_ccxt_exception(mocker, default_conf, MagicMock(),
                                "_async_fetch_trades", "fetch_trades",
                                pair='ABCD/BTC', since=None)
@@ -2796,15 +2800,16 @@ async def test__async_fetch_trades(default_conf, mocker, caplog, exchange_name,
         api_mock.fetch_trades = MagicMock(side_effect=ccxt.BaseError("Unknown error"))
         exchange = get_patched_exchange(mocker, default_conf, api_mock, id=exchange_name)
         await exchange._async_fetch_trades(pair, since=(arrow.utcnow().int_timestamp - 2000) * 1000)
+    exchange.close()
 
     with pytest.raises(OperationalException, match=r'Exchange.* does not support fetching '
                                                    r'historical trade data\..*'):
         api_mock.fetch_trades = MagicMock(side_effect=ccxt.NotSupported("Not supported"))
         exchange = get_patched_exchange(mocker, default_conf, api_mock, id=exchange_name)
         await exchange._async_fetch_trades(pair, since=(arrow.utcnow().int_timestamp - 2000) * 1000)
+    exchange.close()
 
 
-@pytest.mark.asyncio
 @pytest.mark.parametrize("exchange_name", EXCHANGES)
 async def test__async_fetch_trades_contract_size(default_conf, mocker, caplog, exchange_name,
                                                  fetch_trades_result):
@@ -2839,6 +2844,7 @@ async def test__async_fetch_trades_contract_size(default_conf, mocker, caplog, e
     pair = 'ETH/USDT:USDT'
     res = await exchange._async_fetch_trades(pair, since=None, params=None)
     assert res[0][5] == 300
+    exchange.close()
 
 
 @pytest.mark.asyncio
@@ -4807,7 +4813,6 @@ def test_load_leverage_tiers(mocker, default_conf, leverage_tiers, exchange_name
     )
 
 
-@pytest.mark.asyncio
 @pytest.mark.parametrize('exchange_name', EXCHANGES)
 async def test_get_market_leverage_tiers(mocker, default_conf, exchange_name):
     default_conf['exchange']['name'] = exchange_name

From b09fb5826f9404bd60963736307b6efa3649461f Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 16:17:10 +0200
Subject: [PATCH 127/147] don't use "can_short" in backtesting to determine
 application of leverage

---
 freqtrade/optimize/backtesting.py                  | 2 +-
 tests/optimize/test_backtest_detail.py             | 4 +++-
 tests/optimize/test_backtesting_adjust_position.py | 5 +++--
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index 702b4fb85..cd77c75a5 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -739,7 +739,7 @@ class Backtesting:
                 proposed_leverage=1.0,
                 max_leverage=max_leverage,
                 side=direction, entry_tag=entry_tag,
-            ) if self._can_short else 1.0
+            ) if self.trading_mode != TradingMode.SPOT else 1.0
             # Cap leverage between 1.0 and max_leverage.
             leverage = min(max(leverage, 1.0), max_leverage)
 
diff --git a/tests/optimize/test_backtest_detail.py b/tests/optimize/test_backtest_detail.py
index 2cb42c003..dd9e42971 100644
--- a/tests/optimize/test_backtest_detail.py
+++ b/tests/optimize/test_backtest_detail.py
@@ -5,7 +5,7 @@ from unittest.mock import MagicMock
 import pytest
 
 from freqtrade.data.history import get_timerange
-from freqtrade.enums import ExitType
+from freqtrade.enums import ExitType, TradingMode
 from freqtrade.optimize.backtesting import Backtesting
 from freqtrade.persistence.trade_model import LocalTrade
 from tests.conftest import EXMS, patch_exchange
@@ -925,11 +925,13 @@ def test_backtest_results(default_conf, fee, mocker, caplog, data: BTContainer)
     mocker.patch(f"{EXMS}.get_min_pair_stake_amount", return_value=0.00001)
     mocker.patch(f"{EXMS}.get_max_pair_stake_amount", return_value=float('inf'))
     mocker.patch(f"{EXMS}.get_max_leverage", return_value=100)
+    mocker.patch(f"{EXMS}.calculate_funding_fees", return_value=0)
     patch_exchange(mocker)
     frame = _build_backtest_dataframe(data.data)
     backtesting = Backtesting(default_conf)
     # TODO: Should we initialize this properly??
     backtesting._can_short = True
+    backtesting.trading_mode = TradingMode.MARGIN
     backtesting._set_strategy(backtesting.strategylist[0])
     backtesting.required_startup = 0
     backtesting.strategy.advise_entry = lambda a, m: frame
diff --git a/tests/optimize/test_backtesting_adjust_position.py b/tests/optimize/test_backtesting_adjust_position.py
index 9fc726bd1..0d57ff89a 100644
--- a/tests/optimize/test_backtesting_adjust_position.py
+++ b/tests/optimize/test_backtesting_adjust_position.py
@@ -10,7 +10,7 @@ from arrow import Arrow
 from freqtrade.configuration import TimeRange
 from freqtrade.data import history
 from freqtrade.data.history import get_timerange
-from freqtrade.enums import ExitType
+from freqtrade.enums import ExitType, TradingMode
 from freqtrade.optimize.backtesting import Backtesting
 from tests.conftest import EXMS, patch_exchange
 
@@ -108,9 +108,10 @@ def test_backtest_position_adjustment_detailed(default_conf, fee, mocker, levera
     default_conf.update({
         "stake_amount": 100.0,
         "dry_run_wallet": 1000.0,
-        "strategy": "StrategyTestV3"
+        "strategy": "StrategyTestV3",
     })
     backtesting = Backtesting(default_conf)
+    backtesting.trading_mode = TradingMode.FUTURES
     backtesting._can_short = True
     backtesting._set_strategy(backtesting.strategylist[0])
     pair = 'XRP/USDT'

From c14ac8a205e53bf8f6ecbb16292efae96101331b Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 16:46:41 +0200
Subject: [PATCH 128/147] Properly handle non-replaced first entry orders

---
 freqtrade/optimize/backtesting.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index cd77c75a5..31e133515 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -1029,6 +1029,9 @@ class Backtesting:
                                   requested_stake=(
                                     order.safe_remaining * order.ft_price / trade.leverage),
                                   direction='short' if trade.is_short else 'long')
+                # Delete trade if no successful entries happened (if placing the new order failed)
+                if trade.open_order_id is None and trade.nr_of_successful_entries == 0 :
+                    return True
                 self.replaced_entry_orders += 1
             else:
                 # assumption: there can't be multiple open entry orders at any given time

From 1c9abd9e3579097bb6c3c323e2d765afe551f351 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 17:27:52 +0200
Subject: [PATCH 129/147] Properly respect can_short flag in backtesting

closes  #8387
---
 freqtrade/optimize/backtesting.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index 31e133515..a701b04e4 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -203,6 +203,8 @@ class Backtesting:
         # since a "perfect" stoploss-exit is assumed anyway
         # And the regular "stoploss" function would not apply to that case
         self.strategy.order_types['stoploss_on_exchange'] = False
+        # Update can_short flag
+        self._can_short = self.trading_mode != TradingMode.SPOT and strategy.can_short
 
         self.strategy.ft_bot_start()
 

From 80a27bc0db800d336b036411cccda7df97000a84 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 18:18:52 +0200
Subject: [PATCH 130/147] Fix random uvicorn error

---
 freqtrade/optimize/backtesting.py |  2 +-
 tests/rpc/test_rpc_apiserver.py   | 14 ++------------
 2 files changed, 3 insertions(+), 13 deletions(-)

diff --git a/freqtrade/optimize/backtesting.py b/freqtrade/optimize/backtesting.py
index a701b04e4..c7b2a0d3c 100644
--- a/freqtrade/optimize/backtesting.py
+++ b/freqtrade/optimize/backtesting.py
@@ -1032,7 +1032,7 @@ class Backtesting:
                                     order.safe_remaining * order.ft_price / trade.leverage),
                                   direction='short' if trade.is_short else 'long')
                 # Delete trade if no successful entries happened (if placing the new order failed)
-                if trade.open_order_id is None and trade.nr_of_successful_entries == 0 :
+                if trade.open_order_id is None and trade.nr_of_successful_entries == 0:
                     return True
                 self.replaced_entry_orders += 1
             else:
diff --git a/tests/rpc/test_rpc_apiserver.py b/tests/rpc/test_rpc_apiserver.py
index bf9d6cc3b..31075e514 100644
--- a/tests/rpc/test_rpc_apiserver.py
+++ b/tests/rpc/test_rpc_apiserver.py
@@ -1,6 +1,7 @@
 """
 Unit test file for rpc/api_server.py
 """
+import asyncio
 import logging
 import time
 from datetime import datetime, timedelta, timezone
@@ -299,10 +300,6 @@ def test_api_UvicornServer(mocker):
     s = UvicornServer(uvicorn.Config(MagicMock(), port=8080, host='127.0.0.1'))
     assert thread_mock.call_count == 0
 
-    s.install_signal_handlers()
-    # Original implementation starts a thread - make sure that's not the case
-    assert thread_mock.call_count == 0
-
     # Fake started to avoid sleeping forever
     s.started = True
     s.run_in_thread()
@@ -318,10 +315,6 @@ def test_api_UvicornServer_run(mocker):
     s = UvicornServer(uvicorn.Config(MagicMock(), port=8080, host='127.0.0.1'))
     assert serve_mock.call_count == 0
 
-    s.install_signal_handlers()
-    # Original implementation starts a thread - make sure that's not the case
-    assert serve_mock.call_count == 0
-
     # Fake started to avoid sleeping forever
     s.started = True
     s.run()
@@ -331,13 +324,10 @@ def test_api_UvicornServer_run(mocker):
 def test_api_UvicornServer_run_no_uvloop(mocker, import_fails):
     serve_mock = mocker.patch('freqtrade.rpc.api_server.uvicorn_threaded.UvicornServer.serve',
                               get_mock_coro(None))
+    asyncio.set_event_loop(asyncio.new_event_loop())
     s = UvicornServer(uvicorn.Config(MagicMock(), port=8080, host='127.0.0.1'))
     assert serve_mock.call_count == 0
 
-    s.install_signal_handlers()
-    # Original implementation starts a thread - make sure that's not the case
-    assert serve_mock.call_count == 0
-
     # Fake started to avoid sleeping forever
     s.started = True
     s.run()

From 72284317c2cfefe6b22558b169a328016c426e17 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Sun, 26 Mar 2023 18:21:21 +0200
Subject: [PATCH 131/147] Fix failing backtest test

---
 tests/optimize/test_backtest_detail.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/optimize/test_backtest_detail.py b/tests/optimize/test_backtest_detail.py
index dd9e42971..158dd04dc 100644
--- a/tests/optimize/test_backtest_detail.py
+++ b/tests/optimize/test_backtest_detail.py
@@ -930,9 +930,9 @@ def test_backtest_results(default_conf, fee, mocker, caplog, data: BTContainer)
     frame = _build_backtest_dataframe(data.data)
     backtesting = Backtesting(default_conf)
     # TODO: Should we initialize this properly??
-    backtesting._can_short = True
     backtesting.trading_mode = TradingMode.MARGIN
     backtesting._set_strategy(backtesting.strategylist[0])
+    backtesting._can_short = True
     backtesting.required_startup = 0
     backtesting.strategy.advise_entry = lambda a, m: frame
     backtesting.strategy.advise_exit = lambda a, m: frame

From 2f8f60373e6331c6ad0519e70816b1af3ad8f057 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:56:49 +0000
Subject: [PATCH 132/147] Bump ccxt from 3.0.23 to 3.0.36

Bumps [ccxt](https://github.com/ccxt/ccxt) from 3.0.23 to 3.0.36.
- [Release notes](https://github.com/ccxt/ccxt/releases)
- [Changelog](https://github.com/ccxt/ccxt/blob/master/CHANGELOG.md)
- [Commits](https://github.com/ccxt/ccxt/compare/3.0.23...3.0.36)

---
updated-dependencies:
- dependency-name: ccxt
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index ad34883ae..7e7463d9f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,7 @@ numpy==1.24.2
 pandas==1.5.3
 pandas-ta==0.3.14b
 
-ccxt==3.0.23
+ccxt==3.0.36
 cryptography==39.0.2
 aiohttp==3.8.4
 SQLAlchemy==2.0.7

From 1b3d9efedd9a9c4a2bc367cd3fd1d4d2734c8848 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:56:55 +0000
Subject: [PATCH 133/147] Bump types-requests from 2.28.11.15 to 2.28.11.16

Bumps [types-requests](https://github.com/python/typeshed) from 2.28.11.15 to 2.28.11.16.
- [Release notes](https://github.com/python/typeshed/releases)
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-requests
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 8312e2820..a9458b51d 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -27,6 +27,6 @@ nbconvert==7.2.10
 # mypy types
 types-cachetools==5.3.0.4
 types-filelock==3.2.7
-types-requests==2.28.11.15
+types-requests==2.28.11.16
 types-tabulate==0.9.0.1
 types-python-dateutil==2.8.19.10

From 75c31cc8cc966af3964e419f8cea0ba42a32a720 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:57:14 +0000
Subject: [PATCH 134/147] Bump ruff from 0.0.257 to 0.0.259

Bumps [ruff](https://github.com/charliermarsh/ruff) from 0.0.257 to 0.0.259.
- [Release notes](https://github.com/charliermarsh/ruff/releases)
- [Changelog](https://github.com/charliermarsh/ruff/blob/main/BREAKING_CHANGES.md)
- [Commits](https://github.com/charliermarsh/ruff/compare/v0.0.257...v0.0.259)

---
updated-dependencies:
- dependency-name: ruff
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 8312e2820..02d384889 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -7,7 +7,7 @@
 -r docs/requirements-docs.txt
 
 coveralls==3.3.1
-ruff==0.0.257
+ruff==0.0.259
 mypy==1.1.1
 pre-commit==3.2.0
 pytest==7.2.2

From b72f61080b98abfa8933686f42c59c8131ce097c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:57:46 +0000
Subject: [PATCH 135/147] Bump orjson from 3.8.7 to 3.8.8

Bumps [orjson](https://github.com/ijl/orjson) from 3.8.7 to 3.8.8.
- [Release notes](https://github.com/ijl/orjson/releases)
- [Changelog](https://github.com/ijl/orjson/blob/master/CHANGELOG.md)
- [Commits](https://github.com/ijl/orjson/compare/3.8.7...3.8.8)

---
updated-dependencies:
- dependency-name: orjson
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index ad34883ae..80fc1f776 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ py_find_1st==1.1.5
 # Load ticker files 30% faster
 python-rapidjson==1.10
 # Properly format api responses
-orjson==3.8.7
+orjson==3.8.8
 
 # Notify systemd
 sdnotify==0.3.2

From d13ea71a58744eb2bf4e2ae39bd5bc3763cf19e1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:57:55 +0000
Subject: [PATCH 136/147] Bump mkdocs-material from 9.1.3 to 9.1.4

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.3 to 9.1.4.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.3...9.1.4)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 docs/requirements-docs.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
index 110373844..7f4215aef 100644
--- a/docs/requirements-docs.txt
+++ b/docs/requirements-docs.txt
@@ -1,6 +1,6 @@
 markdown==3.3.7
 mkdocs==1.4.2
-mkdocs-material==9.1.3
+mkdocs-material==9.1.4
 mdx_truly_sane_lists==1.3
 pymdown-extensions==9.10
 jinja2==3.1.2

From 8955e091750cf805f5e01b3ec56ebb6c42d2f1cb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:58:00 +0000
Subject: [PATCH 137/147] Bump filelock from 3.10.0 to 3.10.6

Bumps [filelock](https://github.com/tox-dev/py-filelock) from 3.10.0 to 3.10.6.
- [Release notes](https://github.com/tox-dev/py-filelock/releases)
- [Changelog](https://github.com/tox-dev/py-filelock/blob/main/docs/changelog.rst)
- [Commits](https://github.com/tox-dev/py-filelock/compare/3.10.0...3.10.6)

---
updated-dependencies:
- dependency-name: filelock
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-hyperopt.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-hyperopt.txt b/requirements-hyperopt.txt
index 4d86da2b6..2c7c27d98 100644
--- a/requirements-hyperopt.txt
+++ b/requirements-hyperopt.txt
@@ -5,5 +5,5 @@
 scipy==1.10.1
 scikit-learn==1.1.3
 scikit-optimize==0.9.0
-filelock==3.10.0
+filelock==3.10.6
 progressbar2==4.2.0

From 7e11bce4f44a8272832095ea21b6306346f6010f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 03:58:02 +0000
Subject: [PATCH 138/147] Bump pypa/gh-action-pypi-publish from 1.8.1 to 1.8.3

Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.8.1 to 1.8.3.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.8.1...v1.8.3)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 904387fb2..5c80bc141 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -425,7 +425,7 @@ jobs:
         python setup.py sdist bdist_wheel
 
     - name: Publish to PyPI (Test)
-      uses: pypa/gh-action-pypi-publish@v1.8.1
+      uses: pypa/gh-action-pypi-publish@v1.8.3
       if: (github.event_name == 'release')
       with:
         user: __token__
@@ -433,7 +433,7 @@ jobs:
         repository_url: https://test.pypi.org/legacy/
 
     - name: Publish to PyPI
-      uses: pypa/gh-action-pypi-publish@v1.8.1
+      uses: pypa/gh-action-pypi-publish@v1.8.3
       if: (github.event_name == 'release')
       with:
         user: __token__

From 8845f765db7e217e6810184cb7efe3b3415f741d Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 27 Mar 2023 06:25:11 +0200
Subject: [PATCH 139/147] pre-commit - bump requests

---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index ca3da8e90..4784055a9 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -15,7 +15,7 @@ repos:
         additional_dependencies:
           - types-cachetools==5.3.0.4
           - types-filelock==3.2.7
-          - types-requests==2.28.11.15
+          - types-requests==2.28.11.16
           - types-tabulate==0.9.0.1
           - types-python-dateutil==2.8.19.10
           - SQLAlchemy==2.0.7

From 4891174a71730db31aeef08e431d890ceb2afea1 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 27 Mar 2023 06:44:36 +0200
Subject: [PATCH 140/147] list-data should sort pairs also in timerange mode

---
 freqtrade/commands/data_commands.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/freqtrade/commands/data_commands.py b/freqtrade/commands/data_commands.py
index 1e74e1036..bcef1c252 100644
--- a/freqtrade/commands/data_commands.py
+++ b/freqtrade/commands/data_commands.py
@@ -204,11 +204,14 @@ def start_list_data(args: Dict[str, Any]) -> None:
             pair, timeframe, candle_type,
             *dhc.ohlcv_data_min_max(pair, timeframe, candle_type)
         ) for pair, timeframe, candle_type in paircombs]
+
         print(tabulate([
             (pair, timeframe, candle_type,
                 start.strftime(DATETIME_PRINT_FORMAT),
                 end.strftime(DATETIME_PRINT_FORMAT))
-            for pair, timeframe, candle_type, start, end in paircombs1
+            for pair, timeframe, candle_type, start, end in sorted(
+                paircombs1,
+                key=lambda x: (x[0], timeframe_to_minutes(x[1]), x[2]))
             ],
             headers=("Pair", "Timeframe", "Type", 'From', 'To'),
             tablefmt='psql', stralign='right'))

From 1743ad7946ddc6e1c6a550e0716094ab246d1ff5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 05:14:04 +0000
Subject: [PATCH 141/147] Bump pre-commit from 3.2.0 to 3.2.1

Bumps [pre-commit](https://github.com/pre-commit/pre-commit) from 3.2.0 to 3.2.1.
- [Release notes](https://github.com/pre-commit/pre-commit/releases)
- [Changelog](https://github.com/pre-commit/pre-commit/blob/main/CHANGELOG.md)
- [Commits](https://github.com/pre-commit/pre-commit/compare/v3.2.0...v3.2.1)

---
updated-dependencies:
- dependency-name: pre-commit
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements-dev.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-dev.txt b/requirements-dev.txt
index 02d384889..afb8d0bf4 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -9,7 +9,7 @@
 coveralls==3.3.1
 ruff==0.0.259
 mypy==1.1.1
-pre-commit==3.2.0
+pre-commit==3.2.1
 pytest==7.2.2
 pytest-asyncio==0.21.0
 pytest-cov==4.0.0

From bc0816aa66d4acb41d7b98c04529421a55e32faa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 05:15:59 +0000
Subject: [PATCH 142/147] Bump cryptography from 39.0.2 to 40.0.1

Bumps [cryptography](https://github.com/pyca/cryptography) from 39.0.2 to 40.0.1.
- [Release notes](https://github.com/pyca/cryptography/releases)
- [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/cryptography/compare/39.0.2...40.0.1)

---
updated-dependencies:
- dependency-name: cryptography
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 7e7463d9f..b32ed2808 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ pandas==1.5.3
 pandas-ta==0.3.14b
 
 ccxt==3.0.36
-cryptography==39.0.2
+cryptography==40.0.1
 aiohttp==3.8.4
 SQLAlchemy==2.0.7
 python-telegram-bot==13.15

From 90669e0ba9ecb1387d32d759a1372bb89d0fe901 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 07:49:56 +0000
Subject: [PATCH 143/147] Bump ccxt from 3.0.36 to 3.0.37

Bumps [ccxt](https://github.com/ccxt/ccxt) from 3.0.36 to 3.0.37.
- [Release notes](https://github.com/ccxt/ccxt/releases)
- [Changelog](https://github.com/ccxt/ccxt/blob/master/CHANGELOG.md)
- [Commits](https://github.com/ccxt/ccxt/compare/3.0.36...3.0.37)

---
updated-dependencies:
- dependency-name: ccxt
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 7d25fa5a1..809925488 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,7 @@ numpy==1.24.2
 pandas==1.5.3
 pandas-ta==0.3.14b
 
-ccxt==3.0.36
+ccxt==3.0.37
 cryptography==40.0.1
 aiohttp==3.8.4
 SQLAlchemy==2.0.7

From 4f4dfa2a59a03acf3e877727fb0bfe6c7ae8af0e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Mar 2023 07:50:06 +0000
Subject: [PATCH 144/147] Bump pydantic from 1.10.6 to 1.10.7

Bumps [pydantic](https://github.com/pydantic/pydantic) from 1.10.6 to 1.10.7.
- [Release notes](https://github.com/pydantic/pydantic/releases)
- [Changelog](https://github.com/pydantic/pydantic/blob/v1.10.7/HISTORY.md)
- [Commits](https://github.com/pydantic/pydantic/compare/v1.10.6...v1.10.7)

---
updated-dependencies:
- dependency-name: pydantic
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 7d25fa5a1..00b8dc390 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -35,7 +35,7 @@ sdnotify==0.3.2
 
 # API Server
 fastapi==0.95.0
-pydantic==1.10.6
+pydantic==1.10.7
 uvicorn==0.21.1
 pyjwt==2.6.0
 aiofiles==23.1.0

From e35c85000e0ee872960157c1a887468d44b4f60b Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 27 Mar 2023 20:19:23 +0200
Subject: [PATCH 145/147] Excude raspberry from catboost installs

closes #8404
---
 requirements-freqai.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-freqai.txt b/requirements-freqai.txt
index bc0be85e5..e6eae667c 100644
--- a/requirements-freqai.txt
+++ b/requirements-freqai.txt
@@ -5,7 +5,7 @@
 # Required for freqai
 scikit-learn==1.1.3
 joblib==1.2.0
-catboost==1.1.1; platform_machine != 'aarch64' and python_version < '3.11'
+catboost==1.1.1; platform_machine != 'aarch64' and 'arm' not in platform_machine and python_version < '3.11'
 lightgbm==3.3.5
 xgboost==1.7.4
 tensorboard==2.12.0

From 3928051baf6faa162dd865f6b4f2ce7281944ade Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 27 Mar 2023 20:35:19 +0200
Subject: [PATCH 146/147] Revert unneeded formatting changes

---
 freqtrade/data/history/featherdatahandler.py |  3 +-
 tests/data/test_datahandler.py               | 54 +++++++-------------
 2 files changed, 19 insertions(+), 38 deletions(-)

diff --git a/freqtrade/data/history/featherdatahandler.py b/freqtrade/data/history/featherdatahandler.py
index 87c1d0886..4e016080c 100644
--- a/freqtrade/data/history/featherdatahandler.py
+++ b/freqtrade/data/history/featherdatahandler.py
@@ -30,8 +30,7 @@ class FeatherDataHandler(IDataHandler):
         :param candle_type: Any of the enum CandleType (must match trading mode!)
         :return: None
         """
-        filename = self._pair_data_filename(
-            self._datadir, pair, timeframe, candle_type)
+        filename = self._pair_data_filename(self._datadir, pair, timeframe, candle_type)
         self.create_dir_if_needed(filename)
 
         data.reset_index(drop=True).loc[:, self._columns].to_feather(
diff --git a/tests/data/test_datahandler.py b/tests/data/test_datahandler.py
index 2c5241367..f19b15455 100644
--- a/tests/data/test_datahandler.py
+++ b/tests/data/test_datahandler.py
@@ -20,31 +20,25 @@ from tests.conftest import log_has, log_has_re
 
 
 def test_datahandler_ohlcv_get_pairs(testdatadir):
-    pairs = JsonDataHandler.ohlcv_get_pairs(
-        testdatadir, '5m', candle_type=CandleType.SPOT)
+    pairs = JsonDataHandler.ohlcv_get_pairs(testdatadir, '5m', candle_type=CandleType.SPOT)
     # Convert to set to avoid failures due to sorting
     assert set(pairs) == {'UNITTEST/BTC', 'XLM/BTC', 'ETH/BTC', 'TRX/BTC', 'LTC/BTC',
                           'XMR/BTC', 'ZEC/BTC', 'ADA/BTC', 'ETC/BTC', 'NXT/BTC',
                           'DASH/BTC', 'XRP/ETH'}
 
-    pairs = JsonGzDataHandler.ohlcv_get_pairs(
-        testdatadir, '8m', candle_type=CandleType.SPOT)
+    pairs = JsonGzDataHandler.ohlcv_get_pairs(testdatadir, '8m', candle_type=CandleType.SPOT)
     assert set(pairs) == {'UNITTEST/BTC'}
 
-    pairs = HDF5DataHandler.ohlcv_get_pairs(
-        testdatadir, '5m', candle_type=CandleType.SPOT)
+    pairs = HDF5DataHandler.ohlcv_get_pairs(testdatadir, '5m', candle_type=CandleType.SPOT)
     assert set(pairs) == {'UNITTEST/BTC'}
 
-    pairs = JsonDataHandler.ohlcv_get_pairs(
-        testdatadir, '1h', candle_type=CandleType.MARK)
+    pairs = JsonDataHandler.ohlcv_get_pairs(testdatadir, '1h', candle_type=CandleType.MARK)
     assert set(pairs) == {'UNITTEST/USDT:USDT', 'XRP/USDT:USDT'}
 
-    pairs = JsonGzDataHandler.ohlcv_get_pairs(
-        testdatadir, '1h', candle_type=CandleType.FUTURES)
+    pairs = JsonGzDataHandler.ohlcv_get_pairs(testdatadir, '1h', candle_type=CandleType.FUTURES)
     assert set(pairs) == {'XRP/USDT:USDT'}
 
-    pairs = HDF5DataHandler.ohlcv_get_pairs(
-        testdatadir, '1h', candle_type=CandleType.MARK)
+    pairs = HDF5DataHandler.ohlcv_get_pairs(testdatadir, '1h', candle_type=CandleType.MARK)
     assert set(pairs) == {'UNITTEST/USDT:USDT'}
 
 
@@ -85,8 +79,7 @@ def test_rebuild_pair_from_filename(input, expected):
 
 
 def test_datahandler_ohlcv_get_available_data(testdatadir):
-    paircombs = JsonDataHandler.ohlcv_get_available_data(
-        testdatadir, TradingMode.SPOT)
+    paircombs = JsonDataHandler.ohlcv_get_available_data(testdatadir, TradingMode.SPOT)
     # Convert to set to avoid failures due to sorting
     assert set(paircombs) == {
         ('UNITTEST/BTC', '5m', CandleType.SPOT),
@@ -108,8 +101,7 @@ def test_datahandler_ohlcv_get_available_data(testdatadir):
         ('NOPAIR/XXX', '4m', CandleType.SPOT),
     }
 
-    paircombs = JsonDataHandler.ohlcv_get_available_data(
-        testdatadir, TradingMode.FUTURES)
+    paircombs = JsonDataHandler.ohlcv_get_available_data(testdatadir, TradingMode.FUTURES)
     # Convert to set to avoid failures due to sorting
     assert set(paircombs) == {
         ('UNITTEST/USDT:USDT', '1h', 'mark'),
@@ -120,11 +112,9 @@ def test_datahandler_ohlcv_get_available_data(testdatadir):
         ('XRP/USDT:USDT', '8h', 'funding_rate'),
     }
 
-    paircombs = JsonGzDataHandler.ohlcv_get_available_data(
-        testdatadir, TradingMode.SPOT)
+    paircombs = JsonGzDataHandler.ohlcv_get_available_data(testdatadir, TradingMode.SPOT)
     assert set(paircombs) == {('UNITTEST/BTC', '8m', CandleType.SPOT)}
-    paircombs = HDF5DataHandler.ohlcv_get_available_data(
-        testdatadir, TradingMode.SPOT)
+    paircombs = HDF5DataHandler.ohlcv_get_available_data(testdatadir, TradingMode.SPOT)
     assert set(paircombs) == {('UNITTEST/BTC', '5m', CandleType.SPOT)}
 
 
@@ -416,21 +406,18 @@ def test_hdf5datahandler_ohlcv_load_and_resave(
 
     assert not ohlcv[ohlcv['date'] < startdt].empty
 
-    timerange = TimeRange.parse_timerange(
-        f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
+    timerange = TimeRange.parse_timerange(f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
 
     # Call private function to ensure timerange is filtered in hdf5
     ohlcv = dh._ohlcv_load(pair, timeframe, timerange, candle_type=candle_type)
-    ohlcv1 = dh1._ohlcv_load('UNITTEST/NEW', timeframe,
-                             timerange, candle_type=candle_type)
+    ohlcv1 = dh1._ohlcv_load('UNITTEST/NEW', timeframe, timerange, candle_type=candle_type)
     assert len(ohlcv) == len(ohlcv1)
     assert ohlcv.equals(ohlcv1)
     assert ohlcv[ohlcv['date'] < startdt].empty
     assert ohlcv[ohlcv['date'] > enddt].empty
 
     # Try loading inexisting file
-    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe,
-                          candle_type=candle_type)
+    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe, candle_type=candle_type)
     assert ohlcv.empty
 
 
@@ -465,8 +452,7 @@ def test_generic_datahandler_ohlcv_load_and_resave(
     # Get data to test
     dh = get_datahandler(testdatadir, datahandler)
 
-    file = tmpdir2 / \
-        f"UNITTEST_NEW-{timeframe}{candle_append}.{dh._get_file_extension()}"
+    file = tmpdir2 / f"UNITTEST_NEW-{timeframe}{candle_append}.{dh._get_file_extension()}"
     assert not file.is_file()
 
     dh1 = get_datahandler(tmpdir1, datahandler)
@@ -475,14 +461,11 @@ def test_generic_datahandler_ohlcv_load_and_resave(
 
     assert not ohlcv[ohlcv['date'] < startdt].empty
 
-    timerange = TimeRange.parse_timerange(
-        f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
+    timerange = TimeRange.parse_timerange(f"{startdt.replace('-', '')}-{enddt.replace('-', '')}")
 
-    ohlcv = dhbase.ohlcv_load(
-        pair, timeframe, timerange=timerange, candle_type=candle_type)
+    ohlcv = dhbase.ohlcv_load(pair, timeframe, timerange=timerange, candle_type=candle_type)
     if datahandler == 'hdf5':
-        ohlcv1 = dh1._ohlcv_load(
-            'UNITTEST/NEW', timeframe, timerange, candle_type=candle_type)
+        ohlcv1 = dh1._ohlcv_load('UNITTEST/NEW', timeframe, timerange, candle_type=candle_type)
         if candle_type == 'mark':
             ohlcv1['volume'] = 0.0
     else:
@@ -495,8 +478,7 @@ def test_generic_datahandler_ohlcv_load_and_resave(
     assert ohlcv[ohlcv['date'] > enddt].empty
 
     # Try loading inexisting file
-    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe,
-                          candle_type=candle_type)
+    ohlcv = dh.ohlcv_load('UNITTEST/NONEXIST', timeframe, candle_type=candle_type)
     assert ohlcv.empty
 
 

From ed0e7ead312e5ba0a678bddb5669ef75949d8f99 Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 27 Mar 2023 20:36:05 +0200
Subject: [PATCH 147/147] Fix wrong import

---
 freqtrade/data/history/featherdatahandler.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/freqtrade/data/history/featherdatahandler.py b/freqtrade/data/history/featherdatahandler.py
index 4e016080c..bb387fc84 100644
--- a/freqtrade/data/history/featherdatahandler.py
+++ b/freqtrade/data/history/featherdatahandler.py
@@ -4,9 +4,8 @@ from typing import Optional
 from pandas import DataFrame, read_feather, to_datetime
 
 from freqtrade.configuration import TimeRange
-from freqtrade.constants import DEFAULT_DATAFRAME_COLUMNS, TradeList, DEFAULT_TRADES_COLUMNS
+from freqtrade.constants import DEFAULT_DATAFRAME_COLUMNS, DEFAULT_TRADES_COLUMNS, TradeList
 from freqtrade.enums import CandleType
-from freqtrade.data.converter import trades_dict_to_list
 
 from .idatahandler import IDataHandler