From 5306fb3709d53f45f87fc57e2cef4ba2ea2c3312 Mon Sep 17 00:00:00 2001 From: Robert Davey Date: Sun, 25 May 2025 12:40:11 +0100 Subject: [PATCH] Add clarification to the exit table --- docs/includes/strategy-exit-comparisons.md | 25 +++++++++++----------- 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/includes/strategy-exit-comparisons.md b/docs/includes/strategy-exit-comparisons.md index 9abbda7fa..fb6a3226d 100644 --- a/docs/includes/strategy-exit-comparisons.md +++ b/docs/includes/strategy-exit-comparisons.md @@ -1,17 +1,18 @@ ## Exit logic comparisons -Freqtrade allows your strategy to implement different exit logics. +Freqtrade allows your strategy to implement different exit logic using signal-based or callback-based functions. This section aims to compare each different section, helping you to choose the one that best fits your needs. -* **`populate_exit_trend()`** - Vectorized exit logic based on the dataframe - ✅ **Use** to define exit conditions based on indicators or other data that can be calculated in a vectorized manner. +* **`populate_exit_trend()`** - Vectorized signal-based exit logic using indicators in the main dataframe + ✅ **Use** to define exit signals based on indicators or other data that can be calculated in a vectorized manner. 🚫 **Don't use** to customize exit conditions for each individual trade, or if trade data is necessary to make an exit decision. -* **`custom_exit()`** - Custom exit signal, called for every open trade every iteration until a trade is closed. - ✅ **Use** to customize exit conditions for each individual trade, or if trade data is necessary to make an exit decision. -* **`custom_stoploss()`** - Custom stoploss, called for every open trade every iteration until a trade is closed. The value returned here is also used for [stoploss on exchange](stoploss.md#stop-loss-on-exchangefreqtrade). - ✅ **Use** to customize the stoploss logic to set a dynamic stoploss based on trade data or other conditions. - 🚫 **Don't use** to exit a trade immediately based on a specific condition. Use `custom_exit()` for that purpose. -* **`custom_roi()`** - Custom ROI, called for every open trade every iteration until a trade is closed. - ✅ **Use** to customize the minimum ROI threshold to exit a trade dynamically based on profit or other conditions. - 🚫 **Don't use** to exit a trade immediately based on a specific condition. Use `custom_exit()` for that purpose. - 🚫 **Don't use** for static roi. Use `minimal_roi` for that purpose instead. +* **`custom_exit()`** - Custom exit logic that will exit a position immediately, called for every open trade at every bot loop iteration until a trade is closed. + ✅ **Use** to specify exit conditions for each individual trade, or if trade data is necessary to make an exit decision, e.g. using profit data to exit. + 🚫 **Don't use** when you want to exit at candle close (use a `populate_exit_trend()` signal instead), or as a proxy for `custom_stoploss()`, and be aware that rate-based exits in backtesting can be inaccurate. +* **`custom_stoploss()`** - Custom trailing stoploss, called for every open trade every iteration until a trade is closed. The value returned here is also used for [stoploss on exchange](stoploss.md#stop-loss-on-exchangefreqtrade). + ✅ **Use** to customize the stoploss logic to set a dynamic stoploss based on trade data or other conditions. + 🚫 **Don't use** to exit a trade immediately based on a specific condition. Use `custom_exit()` for that purpose. +* **`custom_roi()`** - Custom ROI, called for every open trade every iteration until a trade is closed. + ✅ **Use** to specify a minimum ROI threshold ("take-profit") to exit a trade at this ROI level at some point within the trade duration, based on profit or other conditions. + 🚫 **Don't use** to exit a trade immediately based on a specific condition. Use `custom_exit()`. + 🚫 **Don't use** for static ROI. Use `minimal_roi`.