stable/freqtrade/plugins/pairlist/IPairList.py

180 lines
7.2 KiB
Python
Raw Normal View History

2018-12-05 19:44:56 +00:00
"""
2020-05-19 00:35:01 +00:00
PairList Handler base class
2020-05-17 11:13:26 +00:00
"""
2018-12-05 19:44:56 +00:00
import logging
from abc import ABC, abstractmethod, abstractproperty
2020-05-20 10:27:07 +00:00
from copy import deepcopy
from typing import Any, Dict, List, Optional
2018-12-05 19:44:56 +00:00
2022-09-18 11:31:52 +00:00
from freqtrade.constants import Config
from freqtrade.exceptions import OperationalException
2021-05-17 04:47:49 +00:00
from freqtrade.exchange import Exchange, market_is_active
from freqtrade.exchange.types import Ticker, Tickers
2020-10-13 05:11:08 +00:00
from freqtrade.mixins import LoggingMixin
2020-05-17 11:13:26 +00:00
2018-12-05 19:44:56 +00:00
logger = logging.getLogger(__name__)
2020-10-13 05:11:08 +00:00
class IPairList(LoggingMixin, ABC):
2018-12-05 19:44:56 +00:00
2021-05-17 04:47:49 +00:00
def __init__(self, exchange: Exchange, pairlistmanager,
2022-09-18 11:31:52 +00:00
config: Config, pairlistconfig: Dict[str, Any],
pairlist_pos: int) -> None:
"""
:param exchange: Exchange instance
2020-05-19 00:35:01 +00:00
:param pairlistmanager: Instantiated Pairlist manager
:param config: Global bot configuration
2020-05-19 00:35:01 +00:00
:param pairlistconfig: Configuration for this Pairlist Handler - can be empty.
:param pairlist_pos: Position of the Pairlist Handler in the chain
"""
self._enabled = True
2021-05-17 04:47:49 +00:00
self._exchange: Exchange = exchange
self._pairlistmanager = pairlistmanager
2018-12-05 19:44:56 +00:00
self._config = config
2019-11-09 05:55:16 +00:00
self._pairlistconfig = pairlistconfig
self._pairlist_pos = pairlist_pos
self.refresh_period = self._pairlistconfig.get('refresh_period', 1800)
2020-10-13 05:11:08 +00:00
LoggingMixin.__init__(self, logger, self.refresh_period)
2018-12-05 19:44:56 +00:00
@property
def name(self) -> str:
"""
Gets name of the class
-> no need to overwrite in subclasses
"""
return self.__class__.__name__
@abstractproperty
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
as tickers argument to filter_pairlist
"""
2018-12-05 19:44:56 +00:00
@abstractmethod
def short_desc(self) -> str:
"""
Short whitelist method description - used for startup-messages
-> Please overwrite in subclasses
"""
def _validate_pair(self, pair: str, ticker: Optional[Ticker]) -> bool:
2020-05-20 10:27:07 +00:00
"""
Check one pair against Pairlist Handler's specific conditions.
Either implement it in the Pairlist Handler or override the generic
filter_pairlist() method.
:param pair: Pair that's currently validated
:param ticker: ticker dict as returned from ccxt.fetch_ticker
2020-05-20 10:27:07 +00:00
:return: True if the pair can stay, false if it should be removed
"""
raise NotImplementedError()
def gen_pairlist(self, tickers: Tickers) -> List[str]:
"""
Generate the pairlist.
This method is called once by the pairlistmanager in the refresh_pairlist()
method to supply the starting pairlist for the chain of the Pairlist Handlers.
Pairlist Filters (those Pairlist Handlers that cannot be used at the first
position in the chain) shall not override this base implementation --
it will raise the exception if a Pairlist Handler is used at the first
position in the chain.
:param tickers: Tickers (from exchange.get_tickers). May be cached.
:return: List of pairs
"""
raise OperationalException("This Pairlist Handler should not be used "
"at the first position in the list of Pairlist Handlers.")
def filter_pairlist(self, pairlist: List[str], tickers: Tickers) -> List[str]:
2018-12-05 19:44:56 +00:00
"""
2019-11-09 05:55:16 +00:00
Filters and sorts pairlist and returns the whitelist again.
2020-05-20 10:27:07 +00:00
2019-11-09 05:55:16 +00:00
Called on each bot iteration - please use internal caching if necessary
2020-05-20 10:27:07 +00:00
This generic implementation calls self._validate_pair() for each pair
in the pairlist.
Some Pairlist Handlers override this generic implementation and employ
own filtration.
2019-11-09 05:55:16 +00:00
:param pairlist: pairlist to filter or sort
:param tickers: Tickers (from exchange.get_tickers). May be cached.
2019-11-09 05:55:16 +00:00
:return: new whitelist
2018-12-05 19:44:56 +00:00
"""
if self._enabled:
# Copy list since we're modifying this list
for p in deepcopy(pairlist):
# Filter out assets
if not self._validate_pair(p, tickers[p] if p in tickers else None):
pairlist.remove(p)
2020-05-20 10:27:07 +00:00
return pairlist
2018-12-05 19:44:56 +00:00
def verify_blacklist(self, pairlist: List[str], logmethod) -> List[str]:
2019-11-09 06:23:34 +00:00
"""
Proxy method to verify_blacklist for easy access for child classes.
2020-03-09 10:30:13 +00:00
:param pairlist: Pairlist to validate
:param logmethod: Function that'll be called, `logger.info` or `logger.warning`.
2020-03-09 10:30:13 +00:00
:return: pairlist - blacklisted pairs
"""
return self._pairlistmanager.verify_blacklist(pairlist, logmethod)
2019-11-09 06:23:34 +00:00
def verify_whitelist(self, pairlist: List[str], logmethod,
keep_invalid: bool = False) -> List[str]:
2021-01-12 00:13:58 +00:00
"""
Proxy method to verify_whitelist for easy access for child classes.
:param pairlist: Pairlist to validate
:param logmethod: Function that'll be called, `logger.info` or `logger.warning`
:param keep_invalid: If sets to True, drops invalid pairs silently while expanding regexes.
2021-01-12 00:13:58 +00:00
:return: pairlist - whitelisted pairs
"""
return self._pairlistmanager.verify_whitelist(pairlist, logmethod, keep_invalid)
2021-01-12 00:13:58 +00:00
2019-11-09 13:44:39 +00:00
def _whitelist_for_active_markets(self, pairlist: List[str]) -> List[str]:
2018-12-05 19:44:56 +00:00
"""
Check available markets and remove pair from whitelist if necessary
:param pairlist: the sorted list of pairs the user might want to trade
2019-03-11 20:10:22 +00:00
:return: the list of pairs the user wants to trade without those unavailable or
2018-12-05 19:44:56 +00:00
black_listed
"""
2019-11-09 05:55:16 +00:00
markets = self._exchange.markets
if not markets:
raise OperationalException(
2021-08-06 22:19:36 +00:00
'Markets not loaded. Make sure that exchange is initialized correctly.')
2018-12-05 19:44:56 +00:00
2019-10-30 14:59:52 +00:00
sanitized_whitelist: List[str] = []
2019-11-09 13:44:39 +00:00
for pair in pairlist:
2019-11-09 05:55:16 +00:00
# pair is not in the generated dynamic market or has the wrong stake currency
if pair not in markets:
self.log_once(f"Pair {pair} is not compatible with exchange "
f"{self._exchange.name}. Removing it from whitelist..",
logger.warning)
2018-12-05 19:44:56 +00:00
continue
2020-02-24 19:41:45 +00:00
if not self._exchange.market_is_tradable(markets[pair]):
self.log_once(f"Pair {pair} is not tradable with Freqtrade."
"Removing it from whitelist..", logger.warning)
continue
2020-02-26 06:08:09 +00:00
if self._exchange.get_pair_quote_currency(pair) != self._config['stake_currency']:
self.log_once(f"Pair {pair} is not compatible with your stake currency "
f"{self._config['stake_currency']}. Removing it from whitelist..",
logger.warning)
continue
# Check if market is active
market = markets[pair]
if not market_is_active(market):
self.log_once(f"Ignoring {pair} from whitelist. Market is not active.", logger.info)
continue
2019-10-30 14:59:52 +00:00
if pair not in sanitized_whitelist:
sanitized_whitelist.append(pair)
2018-12-05 19:44:56 +00:00
# We need to remove pairs that are unknown
2019-10-30 14:59:52 +00:00
return sanitized_whitelist