From 7dddab18c47a655d4ba7ab02101d50bbade5f29b Mon Sep 17 00:00:00 2001 From: Axel-CH Date: Sun, 6 Apr 2025 20:02:44 -0400 Subject: [PATCH 1/4] doc: update telegram usage doc to match paused state feature and usage --- docs/telegram-usage.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/telegram-usage.md b/docs/telegram-usage.md index 7dedd9d51..b4817b4c3 100644 --- a/docs/telegram-usage.md +++ b/docs/telegram-usage.md @@ -253,7 +253,11 @@ Below, example of Telegram message you will receive for each command. ### /pause -> **Status:** `paused` +> **Status:** `paused, no more entries will occur from now. Run /start to enable entries.` + +Prevents the bot from opening new trades by changing the state to `paused`. +Open trades will continue to be managed according to their regular rules (ROI/exit signals, stop-loss, etc.). +Note that position adjustment remains active, but only on the exit side—meaning that when the bot is `paused`, it can only reduce the position size of open trades. ### /stop @@ -262,14 +266,12 @@ Below, example of Telegram message you will receive for each command. ### /stopbuy -> **status:** `Setting max_open_trades to 0. Run /reload_config to reset.` - -Prevents the bot from opening new trades by temporarily setting "max_open_trades" to 0. Open trades will be handled via their regular rules (ROI / Sell-signal, stoploss, ...). +Alias of the `/pause` command. After this, give the bot time to close off open trades (can be checked via `/status table`). Once all positions are sold, run `/stop` to completely stop the bot. -`/reload_config` resets "max_open_trades" to the value set in the configuration and resets this command. +`/start` resume the bot to the `running` state, allowing it to open new positions while handling existing ones. !!! Warning The stop-buy signal is ONLY active while the bot is running, and is not persisted anyway, so restarting the bot will cause this to reset. From c90ac30077df83a46f5b1ac78100af6b6b3ce735 Mon Sep 17 00:00:00 2001 From: Axel-CH Date: Mon, 7 Apr 2025 09:20:21 -0400 Subject: [PATCH 2/4] doc: combine /pause and /stopentry /stopbuy sections in telegram usage doc --- docs/telegram-usage.md | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/docs/telegram-usage.md b/docs/telegram-usage.md index b4817b4c3..3ed44d123 100644 --- a/docs/telegram-usage.md +++ b/docs/telegram-usage.md @@ -200,9 +200,8 @@ official commands. You can ask at any moment for help with `/help`. |----------|-------------| | **System commands** | `/start` | Starts the trader -| `/pause` | Pause the trader. Gracefully handle open trades according to their rules. Do not enter new positions. +| `/pause | /stopbuy | /stopentry` | Pause the trader. Gracefully handle open trades according to their rules. Do not enter new positions. | `/stop` | Stops the trader -| `/stopbuy | /stopentry` | Stops the trader from opening new trades. Gracefully closes open trades according to their rules. | `/reload_config` | Reloads the configuration file | `/show_config` | Shows part of the current configuration with relevant settings to operation | `/logs [limit]` | Show last log messages. @@ -251,7 +250,7 @@ Below, example of Telegram message you will receive for each command. > **Status:** `running` -### /pause +### /pause | /stopentry | /stopbuy > **Status:** `paused, no more entries will occur from now. Run /start to enable entries.` @@ -259,22 +258,18 @@ Prevents the bot from opening new trades by changing the state to `paused`. Open trades will continue to be managed according to their regular rules (ROI/exit signals, stop-loss, etc.). Note that position adjustment remains active, but only on the exit side—meaning that when the bot is `paused`, it can only reduce the position size of open trades. -### /stop - -> `Stopping trader ...` -> **Status:** `stopped` - -### /stopbuy - -Alias of the `/pause` command. - After this, give the bot time to close off open trades (can be checked via `/status table`). -Once all positions are sold, run `/stop` to completely stop the bot. +Once all positions are closed, run `/stop` to completely stop the bot. `/start` resume the bot to the `running` state, allowing it to open new positions while handling existing ones. !!! Warning - The stop-buy signal is ONLY active while the bot is running, and is not persisted anyway, so restarting the bot will cause this to reset. + The pause/stopentry signal is ONLY active while the bot is running, and is not persisted anyway, so restarting the bot will cause this to reset. + +### /stop + +> `Stopping trader ...` +> **Status:** `stopped` ### /status From cd9c45e87563243a86a42636826ca589eee9d21f Mon Sep 17 00:00:00 2001 From: Axel-CH Date: Mon, 7 Apr 2025 09:23:49 -0400 Subject: [PATCH 3/4] doc: slight order change in pause telegram command description --- docs/telegram-usage.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/telegram-usage.md b/docs/telegram-usage.md index 3ed44d123..f95fc2cb8 100644 --- a/docs/telegram-usage.md +++ b/docs/telegram-usage.md @@ -200,7 +200,7 @@ official commands. You can ask at any moment for help with `/help`. |----------|-------------| | **System commands** | `/start` | Starts the trader -| `/pause | /stopbuy | /stopentry` | Pause the trader. Gracefully handle open trades according to their rules. Do not enter new positions. +| `/pause | /stopentry | /stopbuy` | Pause the trader. Gracefully handle open trades according to their rules. Do not enter new positions. | `/stop` | Stops the trader | `/reload_config` | Reloads the configuration file | `/show_config` | Shows part of the current configuration with relevant settings to operation From 9b9ef6ae6d812887f25d4720d840d5e9c2f38d38 Mon Sep 17 00:00:00 2001 From: Matthias Date: Tue, 8 Apr 2025 06:26:49 +0200 Subject: [PATCH 4/4] docs: Minor adjustment to doc wording --- docs/telegram-usage.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/telegram-usage.md b/docs/telegram-usage.md index f95fc2cb8..a7a27f150 100644 --- a/docs/telegram-usage.md +++ b/docs/telegram-usage.md @@ -256,12 +256,12 @@ Below, example of Telegram message you will receive for each command. Prevents the bot from opening new trades by changing the state to `paused`. Open trades will continue to be managed according to their regular rules (ROI/exit signals, stop-loss, etc.). -Note that position adjustment remains active, but only on the exit side—meaning that when the bot is `paused`, it can only reduce the position size of open trades. +Note that position adjustment remains active, but only on the exit side — meaning that when the bot is `paused`, it can only reduce the position size of open trades. After this, give the bot time to close off open trades (can be checked via `/status table`). Once all positions are closed, run `/stop` to completely stop the bot. -`/start` resume the bot to the `running` state, allowing it to open new positions while handling existing ones. +Use `/start` to resume the bot to the `running` state, allowing it to open new positions. !!! Warning The pause/stopentry signal is ONLY active while the bot is running, and is not persisted anyway, so restarting the bot will cause this to reset.