|
|
|
|
@ -1,5 +1,5 @@
|
|
|
|
|
from dataclasses import dataclass
|
|
|
|
|
from typing import Any, Callable, Optional, Union
|
|
|
|
|
from typing import Any, Callable, Dict, Optional, Union
|
|
|
|
|
|
|
|
|
|
from pandas import DataFrame
|
|
|
|
|
|
|
|
|
|
@ -38,17 +38,18 @@ def informative(timeframe: str, asset: str = '',
|
|
|
|
|
|
|
|
|
|
:param timeframe: Informative timeframe. Must always be equal or higher than strategy timeframe.
|
|
|
|
|
:param asset: Informative asset, for example BTC, BTC/USDT, ETH/BTC. Do not specify to use
|
|
|
|
|
current pair.
|
|
|
|
|
current pair. Also supports limited pair format strings (see below)
|
|
|
|
|
:param fmt: Column format (str) or column formatter (callable(name, asset, timeframe)). When not
|
|
|
|
|
specified, defaults to:
|
|
|
|
|
* {base}_{quote}_{column}_{timeframe} if asset is specified.
|
|
|
|
|
* {column}_{timeframe} if asset is not specified.
|
|
|
|
|
Format string supports these format variables:
|
|
|
|
|
* {asset} - full name of the asset, for example 'BTC/USDT'.
|
|
|
|
|
Pair format supports these format variables:
|
|
|
|
|
* {base} - base currency in lower case, for example 'eth'.
|
|
|
|
|
* {BASE} - same as {base}, except in upper case.
|
|
|
|
|
* {quote} - quote currency in lower case, for example 'usdt'.
|
|
|
|
|
* {QUOTE} - same as {quote}, except in upper case.
|
|
|
|
|
Format string additionally supports this variables.
|
|
|
|
|
* {asset} - full name of the asset, for example 'BTC/USDT'.
|
|
|
|
|
* {column} - name of dataframe column.
|
|
|
|
|
* {timeframe} - timeframe of informative dataframe.
|
|
|
|
|
:param ffill: ffill dataframe after merging informative pair.
|
|
|
|
|
@ -68,9 +69,25 @@ def informative(timeframe: str, asset: str = '',
|
|
|
|
|
return decorator
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _format_pair_name(config, pair: str) -> str:
|
|
|
|
|
return pair.format(stake_currency=config['stake_currency'],
|
|
|
|
|
stake=config['stake_currency']).upper()
|
|
|
|
|
def __get_pair_formats(market: Optional[Dict[str, Any]]) -> Dict[str, str]:
|
|
|
|
|
if not market:
|
|
|
|
|
return {}
|
|
|
|
|
base = market['base']
|
|
|
|
|
quote = market['quote']
|
|
|
|
|
return {
|
|
|
|
|
'base': base.lower(),
|
|
|
|
|
'BASE': base.upper(),
|
|
|
|
|
'quote': quote.lower(),
|
|
|
|
|
'QUOTE': quote.upper(),
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _format_pair_name(config, pair: str, market: Optional[Dict[str, Any]] = None) -> str:
|
|
|
|
|
return pair.format(
|
|
|
|
|
stake_currency=config['stake_currency'],
|
|
|
|
|
stake=config['stake_currency'],
|
|
|
|
|
**__get_pair_formats(market),
|
|
|
|
|
).upper()
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _create_and_merge_informative_pair(strategy, dataframe: DataFrame, metadata: dict,
|
|
|
|
|
@ -85,7 +102,8 @@ def _create_and_merge_informative_pair(strategy, dataframe: DataFrame, metadata:
|
|
|
|
|
|
|
|
|
|
if asset:
|
|
|
|
|
# Insert stake currency if needed.
|
|
|
|
|
asset = _format_pair_name(config, asset)
|
|
|
|
|
market1 = strategy.dp.market(metadata['pair'])
|
|
|
|
|
asset = _format_pair_name(config, asset, market1)
|
|
|
|
|
else:
|
|
|
|
|
# Not specifying an asset will define informative dataframe for current pair.
|
|
|
|
|
asset = metadata['pair']
|
|
|
|
|
@ -93,8 +111,6 @@ def _create_and_merge_informative_pair(strategy, dataframe: DataFrame, metadata:
|
|
|
|
|
market = strategy.dp.market(asset)
|
|
|
|
|
if market is None:
|
|
|
|
|
raise OperationalException(f'Market {asset} is not available.')
|
|
|
|
|
base = market['base']
|
|
|
|
|
quote = market['quote']
|
|
|
|
|
|
|
|
|
|
# Default format. This optimizes for the common case: informative pairs using same stake
|
|
|
|
|
# currency. When quote currency matches stake currency, column name will omit base currency.
|
|
|
|
|
@ -117,10 +133,7 @@ def _create_and_merge_informative_pair(strategy, dataframe: DataFrame, metadata:
|
|
|
|
|
formatter = fmt.format # A default string formatter.
|
|
|
|
|
|
|
|
|
|
fmt_args = {
|
|
|
|
|
'BASE': base.upper(),
|
|
|
|
|
'QUOTE': quote.upper(),
|
|
|
|
|
'base': base.lower(),
|
|
|
|
|
'quote': quote.lower(),
|
|
|
|
|
**__get_pair_formats(market),
|
|
|
|
|
'asset': asset,
|
|
|
|
|
'timeframe': timeframe,
|
|
|
|
|
}
|
|
|
|
|
|