2020-05-17 23:36:40 +00:00
|
|
|
"""
|
|
|
|
Shuffle pair list filter
|
|
|
|
"""
|
|
|
|
import logging
|
|
|
|
import random
|
2022-10-30 08:46:12 +00:00
|
|
|
from typing import Any, Dict, List, Literal
|
2020-05-17 23:36:40 +00:00
|
|
|
|
2022-09-18 17:36:11 +00:00
|
|
|
from freqtrade.constants import Config
|
2021-12-08 18:30:14 +00:00
|
|
|
from freqtrade.enums import RunMode
|
2022-10-30 08:46:12 +00:00
|
|
|
from freqtrade.exchange import timeframe_to_seconds
|
2022-10-11 19:33:02 +00:00
|
|
|
from freqtrade.exchange.types import Tickers
|
2020-12-23 15:54:35 +00:00
|
|
|
from freqtrade.plugins.pairlist.IPairList import IPairList
|
2022-10-30 08:46:12 +00:00
|
|
|
from freqtrade.util.periodic_cache import PeriodicCache
|
2020-05-17 23:36:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
2022-10-30 08:46:12 +00:00
|
|
|
ShuffleValues = Literal['candle', 'iteration']
|
|
|
|
|
2020-05-17 23:36:40 +00:00
|
|
|
|
|
|
|
class ShuffleFilter(IPairList):
|
|
|
|
|
2020-05-20 10:27:07 +00:00
|
|
|
def __init__(self, exchange, pairlistmanager,
|
2022-09-18 11:31:52 +00:00
|
|
|
config: Config, pairlistconfig: Dict[str, Any],
|
2020-05-17 23:36:40 +00:00
|
|
|
pairlist_pos: int) -> None:
|
|
|
|
super().__init__(exchange, pairlistmanager, config, pairlistconfig, pairlist_pos)
|
|
|
|
|
2021-11-27 15:21:23 +00:00
|
|
|
# Apply seed in backtesting mode to get comparable results,
|
|
|
|
# but not in live modes to get a non-repeating order of pairs during live modes.
|
2021-11-27 18:41:36 +00:00
|
|
|
if config.get('runmode') in (RunMode.LIVE, RunMode.DRY_RUN):
|
2021-11-27 15:21:23 +00:00
|
|
|
self._seed = None
|
2021-11-27 18:41:36 +00:00
|
|
|
logger.info("Live mode detected, not applying seed.")
|
2021-11-27 15:21:23 +00:00
|
|
|
else:
|
|
|
|
self._seed = pairlistconfig.get('seed')
|
2021-11-27 18:41:36 +00:00
|
|
|
logger.info(f"Backtesting mode detected, applying seed value: {self._seed}")
|
2021-11-27 15:21:23 +00:00
|
|
|
|
2021-11-29 19:35:43 +00:00
|
|
|
self._random = random.Random(self._seed)
|
2022-10-30 08:48:55 +00:00
|
|
|
self._shuffle_freq: ShuffleValues = pairlistconfig.get('shuffle_frequency', 'candle')
|
2022-10-30 08:46:12 +00:00
|
|
|
self.__pairlist_cache = PeriodicCache(
|
|
|
|
maxsize=1000, ttl=timeframe_to_seconds(self._config['timeframe']))
|
2021-11-29 19:35:43 +00:00
|
|
|
|
2020-05-17 23:36:40 +00:00
|
|
|
@property
|
|
|
|
def needstickers(self) -> bool:
|
|
|
|
"""
|
|
|
|
Boolean property defining if tickers are necessary.
|
2020-11-24 19:24:51 +00:00
|
|
|
If no Pairlist requires tickers, an empty Dict is passed
|
2020-05-17 23:36:40 +00:00
|
|
|
as tickers argument to filter_pairlist
|
|
|
|
"""
|
|
|
|
return False
|
|
|
|
|
|
|
|
def short_desc(self) -> str:
|
|
|
|
"""
|
|
|
|
Short whitelist method description - used for startup-messages
|
|
|
|
"""
|
2022-10-30 08:48:55 +00:00
|
|
|
return (f"{self.name} - Shuffling pairs every {self._shuffle_freq}" +
|
2020-05-17 23:36:40 +00:00
|
|
|
(f", seed = {self._seed}." if self._seed is not None else "."))
|
|
|
|
|
2022-10-11 19:33:02 +00:00
|
|
|
def filter_pairlist(self, pairlist: List[str], tickers: Tickers) -> List[str]:
|
2020-05-17 23:36:40 +00:00
|
|
|
"""
|
|
|
|
Filters and sorts pairlist and returns the whitelist again.
|
|
|
|
Called on each bot iteration - please use internal caching if necessary
|
|
|
|
:param pairlist: pairlist to filter or sort
|
2022-10-10 11:54:13 +00:00
|
|
|
:param tickers: Tickers (from exchange.get_tickers). May be cached.
|
2020-05-17 23:36:40 +00:00
|
|
|
:return: new whitelist
|
|
|
|
"""
|
2022-10-30 08:46:12 +00:00
|
|
|
pairlist_bef = tuple(pairlist)
|
|
|
|
pairlist_new = self.__pairlist_cache.get(pairlist_bef)
|
2022-10-30 08:48:55 +00:00
|
|
|
if pairlist_new and self._shuffle_freq == 'candle':
|
2022-10-30 08:46:12 +00:00
|
|
|
# Use cached pairlist.
|
|
|
|
return pairlist_new
|
2020-05-17 23:36:40 +00:00
|
|
|
# Shuffle is done inplace
|
2021-11-29 19:35:43 +00:00
|
|
|
self._random.shuffle(pairlist)
|
2022-10-30 08:46:12 +00:00
|
|
|
self.__pairlist_cache[pairlist_bef] = pairlist
|
2020-05-17 23:36:40 +00:00
|
|
|
|
|
|
|
return pairlist
|