2020-03-01 08:35:53 +00:00
|
|
|
|
2020-06-14 05:00:55 +00:00
|
|
|
def bot_loop_start(self, **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 ressource for comparison)
|
2020-06-14 08:08:19 +00:00
|
|
|
|
|
|
|
For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
|
|
|
|
|
|
|
|
When not implemented by a strategy, this simply does nothing.
|
2020-06-14 05:00:55 +00:00
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
"""
|
|
|
|
pass
|
|
|
|
|
2021-09-26 17:35:54 +00:00
|
|
|
def custom_stake_amount(self, pair: str, current_time: datetime, current_rate: float,
|
2021-08-04 04:46:21 +00:00
|
|
|
proposed_stake: float, min_stake: float, max_stake: float,
|
2021-09-26 17:35:54 +00:00
|
|
|
side: str, **kwargs) -> float:
|
2021-08-04 04:46:21 +00:00
|
|
|
"""
|
2021-09-26 17:35:54 +00:00
|
|
|
Customize stake size for each new trade.
|
2021-08-04 04:46:21 +00:00
|
|
|
|
|
|
|
:param pair: Pair that's currently analyzed
|
|
|
|
:param current_time: datetime object, containing the current datetime
|
|
|
|
:param current_rate: Rate, calculated based on pricing settings in ask_strategy.
|
|
|
|
:param proposed_stake: A stake amount proposed by the bot.
|
|
|
|
:param min_stake: Minimal stake size allowed by exchange.
|
|
|
|
:param max_stake: Balance available for trading.
|
2021-09-26 17:35:54 +00:00
|
|
|
:param side: 'long' or 'short' - indicating the direction of the proposed trade
|
2021-08-04 04:46:21 +00:00
|
|
|
:return: A stake size, which is between min_stake and max_stake.
|
|
|
|
"""
|
|
|
|
return proposed_stake
|
|
|
|
|
2020-12-20 10:12:22 +00:00
|
|
|
use_custom_stoploss = True
|
2020-12-20 09:13:47 +00:00
|
|
|
|
2021-04-26 17:27:22 +00:00
|
|
|
def custom_stoploss(self, pair: str, trade: 'Trade', current_time: 'datetime',
|
|
|
|
current_rate: float, current_profit: float, dataframe: DataFrame,
|
|
|
|
**kwargs) -> float:
|
2020-12-20 09:13:47 +00:00
|
|
|
"""
|
|
|
|
Custom stoploss logic, returning the new distance relative to current_rate (as ratio).
|
|
|
|
e.g. returning -0.05 would create a stoploss 5% below current_rate.
|
|
|
|
The custom stoploss can never be below self.stoploss, which serves as a hard maximum loss.
|
|
|
|
|
|
|
|
For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
|
|
|
|
|
|
|
|
When not implemented by a strategy, returns the initial stoploss value
|
2020-12-20 10:12:22 +00:00
|
|
|
Only called when use_custom_stoploss is set to True.
|
2020-12-20 09:13:47 +00:00
|
|
|
|
|
|
|
:param pair: Pair that's about to be sold.
|
|
|
|
:param trade: trade object.
|
|
|
|
:param current_time: datetime object, containing the current datetime
|
|
|
|
:param current_rate: Rate, calculated based on pricing settings in ask_strategy.
|
|
|
|
:param current_profit: Current profit (as ratio), calculated based on current_rate.
|
2021-04-26 17:27:22 +00:00
|
|
|
:param dataframe: Analyzed dataframe for this pair. Can contain future data in backtesting.
|
2020-12-20 09:13:47 +00:00
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
:return float: New stoploss value, relative to the currentrate
|
|
|
|
"""
|
|
|
|
return self.stoploss
|
|
|
|
|
2021-08-04 04:46:21 +00:00
|
|
|
def custom_sell(self, pair: str, trade: 'Trade', current_time: 'datetime', current_rate: float,
|
|
|
|
current_profit: float, **kwargs) -> 'Optional[Union[str, bool]]':
|
|
|
|
"""
|
|
|
|
Custom sell signal logic indicating that specified position should be sold. Returning a
|
|
|
|
string or True from this method is equal to setting sell signal on a candle at specified
|
|
|
|
time. This method is not called when sell signal is set.
|
|
|
|
|
|
|
|
This method should be overridden to create sell signals that depend on trade parameters. For
|
|
|
|
example you could implement a sell relative to the candle when the trade was opened,
|
|
|
|
or a custom 1:2 risk-reward ROI.
|
|
|
|
|
|
|
|
Custom sell reason max length is 64. Exceeding characters will be removed.
|
|
|
|
|
|
|
|
:param pair: Pair that's currently analyzed
|
|
|
|
:param trade: trade object.
|
|
|
|
:param current_time: datetime object, containing the current datetime
|
|
|
|
:param current_rate: Rate, calculated based on pricing settings in ask_strategy.
|
|
|
|
:param current_profit: Current profit (as ratio), calculated based on current_rate.
|
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
:return: To execute sell, return a string with custom sell reason or True. Otherwise return
|
|
|
|
None or False.
|
|
|
|
"""
|
|
|
|
return None
|
|
|
|
|
2020-06-14 08:08:19 +00:00
|
|
|
def confirm_trade_entry(self, pair: str, order_type: str, amount: float, rate: float,
|
2021-09-26 17:32:24 +00:00
|
|
|
time_in_force: str, current_time: datetime,
|
|
|
|
side: str, **kwargs) -> bool:
|
2020-06-14 08:08:19 +00:00
|
|
|
"""
|
2021-09-26 17:32:24 +00:00
|
|
|
Called right before placing a entry order.
|
2020-06-14 08:08:19 +00:00
|
|
|
Timing for this function is critical, so avoid doing heavy computations or
|
2020-06-14 08:49:15 +00:00
|
|
|
network requests in this method.
|
2020-06-14 08:08:19 +00:00
|
|
|
|
|
|
|
For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
|
|
|
|
|
|
|
|
When not implemented by a strategy, returns True (always confirming).
|
|
|
|
|
2021-09-26 17:32:24 +00:00
|
|
|
:param pair: Pair that's about to be bought/shorted.
|
2020-06-14 08:08:19 +00:00
|
|
|
:param order_type: Order type (as configured in order_types). usually limit or market.
|
|
|
|
:param amount: Amount in target (quote) currency that's going to be traded.
|
|
|
|
:param rate: Rate that's going to be used when using limit orders
|
|
|
|
:param time_in_force: Time in force. Defaults to GTC (Good-til-cancelled).
|
2021-05-09 07:56:36 +00:00
|
|
|
:param current_time: datetime object, containing the current datetime
|
2021-09-26 17:32:24 +00:00
|
|
|
:param side: 'long' or 'short' - indicating the direction of the proposed trade
|
2020-06-14 08:08:19 +00:00
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
:return bool: When True is returned, then the buy-order is placed on the exchange.
|
|
|
|
False aborts the process
|
|
|
|
"""
|
|
|
|
return True
|
|
|
|
|
2020-08-06 23:13:36 +00:00
|
|
|
def confirm_trade_exit(self, pair: str, trade: 'Trade', order_type: str, amount: float,
|
2021-05-09 07:56:36 +00:00
|
|
|
rate: float, time_in_force: str, sell_reason: str,
|
|
|
|
current_time: 'datetime', **kwargs) -> bool:
|
2020-06-14 08:08:19 +00:00
|
|
|
"""
|
|
|
|
Called right before placing a regular sell order.
|
|
|
|
Timing for this function is critical, so avoid doing heavy computations or
|
2020-06-14 08:49:15 +00:00
|
|
|
network requests in this method.
|
2020-06-14 08:08:19 +00:00
|
|
|
|
|
|
|
For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
|
|
|
|
|
|
|
|
When not implemented by a strategy, returns True (always confirming).
|
|
|
|
|
2020-12-31 08:48:49 +00:00
|
|
|
:param pair: Pair that's currently analyzed
|
2020-06-14 08:08:19 +00:00
|
|
|
:param trade: trade object.
|
|
|
|
:param order_type: Order type (as configured in order_types). usually limit or market.
|
|
|
|
:param amount: Amount in quote currency.
|
|
|
|
:param rate: Rate that's going to be used when using limit orders
|
|
|
|
:param time_in_force: Time in force. Defaults to GTC (Good-til-cancelled).
|
|
|
|
:param sell_reason: Sell reason.
|
|
|
|
Can be any of ['roi', 'stop_loss', 'stoploss_on_exchange', 'trailing_stop_loss',
|
|
|
|
'sell_signal', 'force_sell', 'emergency_sell']
|
2021-05-09 07:56:36 +00:00
|
|
|
:param current_time: datetime object, containing the current datetime
|
2020-06-14 08:08:19 +00:00
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
:return bool: When True is returned, then the sell-order is placed on the exchange.
|
|
|
|
False aborts the process
|
|
|
|
"""
|
|
|
|
return True
|
|
|
|
|
2020-03-01 08:43:20 +00:00
|
|
|
def check_buy_timeout(self, pair: str, trade: 'Trade', order: dict, **kwargs) -> bool:
|
2020-03-01 08:35:53 +00:00
|
|
|
"""
|
|
|
|
Check buy timeout function callback.
|
|
|
|
This method can be used to override the buy-timeout.
|
|
|
|
It is called whenever a limit buy order has been created,
|
|
|
|
and is not yet fully filled.
|
|
|
|
Configuration options in `unfilledtimeout` will be verified before this,
|
|
|
|
so ensure to set these timeouts high enough.
|
|
|
|
|
2020-03-01 08:40:07 +00:00
|
|
|
For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
|
|
|
|
|
2020-03-01 08:35:53 +00:00
|
|
|
When not implemented by a strategy, this simply returns False.
|
|
|
|
:param pair: Pair the trade is for
|
|
|
|
:param trade: trade object.
|
|
|
|
:param order: Order dictionary as returned from CCXT.
|
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
:return bool: When True is returned, then the buy-order is cancelled.
|
|
|
|
"""
|
|
|
|
return False
|
|
|
|
|
2020-03-01 08:43:20 +00:00
|
|
|
def check_sell_timeout(self, pair: str, trade: 'Trade', order: dict, **kwargs) -> bool:
|
2020-03-01 08:35:53 +00:00
|
|
|
"""
|
|
|
|
Check sell timeout function callback.
|
|
|
|
This method can be used to override the sell-timeout.
|
|
|
|
It is called whenever a limit sell order has been created,
|
|
|
|
and is not yet fully filled.
|
|
|
|
Configuration options in `unfilledtimeout` will be verified before this,
|
|
|
|
so ensure to set these timeouts high enough.
|
|
|
|
|
2020-03-01 08:40:07 +00:00
|
|
|
For full documentation please go to https://www.freqtrade.io/en/latest/strategy-advanced/
|
|
|
|
|
2020-03-01 08:35:53 +00:00
|
|
|
When not implemented by a strategy, this simply returns False.
|
|
|
|
:param pair: Pair the trade is for
|
|
|
|
:param trade: trade object.
|
|
|
|
:param order: Order dictionary as returned from CCXT.
|
|
|
|
:param **kwargs: Ensure to keep this here so updates to this won't break your strategy.
|
|
|
|
:return bool: When True is returned, then the sell-order is cancelled.
|
|
|
|
"""
|
|
|
|
return False
|