stable/freqtrade/exchange/__init__.py

365 lines
11 KiB
Python
Raw Normal View History

2017-11-18 07:52:28 +00:00
# pragma pylint: disable=W0603
""" Cryptocurrency Exchanges support """
2017-05-14 12:14:16 +00:00
import logging
2017-11-05 14:21:16 +00:00
from random import randint
from typing import List, Dict, Any, Optional
2017-09-01 19:11:46 +00:00
import ccxt
2017-10-06 10:22:04 +00:00
import arrow
from freqtrade import OperationalException, DependencyException, NetworkException
2017-05-12 17:11:56 +00:00
2017-05-14 12:14:16 +00:00
logger = logging.getLogger(__name__)
2017-05-12 17:11:56 +00:00
2017-09-08 21:10:22 +00:00
# Current selected exchange
_API: ccxt.Exchange = None
2017-10-06 10:22:04 +00:00
_CONF: dict = {}
API_RETRY_COUNT = 4
2017-05-12 17:11:56 +00:00
2017-11-05 14:21:16 +00:00
# Holds all open sell orders for dry_run
2017-11-05 15:12:58 +00:00
_DRY_RUN_OPEN_ORDERS: Dict[str, Any] = {}
2017-11-05 14:21:16 +00:00
# Urls to exchange markets, insert quote and base with .format()
_EXCHANGE_URLS = {
ccxt.bittrex.__name__: '/Market/Index?MarketName={quote}-{base}',
ccxt.binance.__name__: '/tradeDetail.html?symbol={base}_{quote}'
}
def retrier(f):
def wrapper(*args, **kwargs):
count = kwargs.pop('count', API_RETRY_COUNT)
try:
return f(*args, **kwargs)
except (NetworkException, DependencyException) as ex:
logger.warning('%s returned exception: "%s"', f, ex)
if count > 0:
count -= 1
kwargs.update({'count': count})
logger.warning('retrying %s still for %s times', f, count)
return wrapper(*args, **kwargs)
else:
raise OperationalException('Giving up retrying: %s', f)
return wrapper
def init_ccxt(exchange_config: dict) -> ccxt:
"""
Initialize ccxt with given config and return valid
ccxt instance.
:param config: config to use
:return: ccxt
"""
2017-10-06 10:22:04 +00:00
# Find matching class for the given exchange name
2017-10-07 15:38:33 +00:00
name = exchange_config['name']
if name not in ccxt.exchanges:
raise OperationalException('Exchange {} is not supported'.format(name))
2017-10-07 15:38:33 +00:00
try:
api = getattr(ccxt, name.lower())({
'apiKey': exchange_config.get('key'),
'secret': exchange_config.get('secret'),
'password': exchange_config.get('password'),
'uid': exchange_config.get('uid' ''),
2018-04-21 17:11:29 +00:00
'enableRateLimit': True,
})
2018-03-30 20:14:35 +00:00
except (KeyError, AttributeError):
raise OperationalException('Exchange {} is not supported'.format(name))
2017-10-06 10:22:04 +00:00
return api
def init(config: dict) -> None:
"""
Initializes this module with the given config,
it does basic validation whether the specified
exchange and pairs are valid.
:param config: config to use
:return: None
"""
global _CONF, _API
_CONF.update(config)
if config['dry_run']:
logger.info('Instance is running with dry_run enabled')
exchange_config = config['exchange']
_API = init_ccxt(exchange_config)
logger.info('Using Exchange "%s"', get_name())
# Check if all pairs are available
2017-10-06 10:22:04 +00:00
validate_pairs(config['exchange']['pair_whitelist'])
2017-10-01 21:28:09 +00:00
def validate_pairs(pairs: List[str]) -> None:
"""
Checks if all given pairs are tradable on the current exchange.
Raises OperationalException if one pair is not available.
2017-10-01 21:28:09 +00:00
:param pairs: list of pairs
:return: None
"""
try:
markets = _API.load_markets()
except ccxt.BaseError as e:
logger.warning('Unable to validate pairs (assuming they are correct). Reason: %s', e)
return
2017-11-09 20:47:47 +00:00
stake_cur = _CONF['stake_currency']
2017-10-01 21:28:09 +00:00
for pair in pairs:
# Note: ccxt has BaseCurrency/QuoteCurrency format for pairs
# TODO: add a support for having coins in BTC/USDT format
if not pair.endswith(stake_cur):
raise OperationalException(
2017-11-09 20:47:47 +00:00
'Pair {} not compatible with stake_currency: {}'.format(pair, stake_cur)
)
if pair not in markets:
raise OperationalException(
'Pair {} is not available at {}'.format(pair, get_name()))
def exchange_has(endpoint: str) -> bool:
"""
Checks if exchange implements a specific API endpoint.
Wrapper around ccxt 'has' attribute
:param endpoint: Name of endpoint (e.g. 'fetchOHLCV', 'fetchTickers')
:return: bool
"""
return endpoint in _API.has and _API.has[endpoint]
def buy(pair: str, rate: float, amount: float) -> Dict:
2017-09-08 21:10:22 +00:00
if _CONF['dry_run']:
2017-11-05 14:21:16 +00:00
global _DRY_RUN_OPEN_ORDERS
2017-11-18 07:52:28 +00:00
order_id = 'dry_run_buy_{}'.format(randint(0, 10**6))
2017-11-05 14:21:16 +00:00
_DRY_RUN_OPEN_ORDERS[order_id] = {
'pair': pair,
'price': rate,
2017-11-05 14:21:16 +00:00
'amount': amount,
'type': 'limit',
'side': 'buy',
2017-11-05 14:21:16 +00:00
'remaining': 0.0,
'datetime': arrow.utcnow().isoformat(),
'status': 'closed'
2017-11-05 14:21:16 +00:00
}
return {'id': order_id}
2017-10-06 10:22:04 +00:00
try:
return _API.create_limit_buy_order(pair, amount, rate)
except ccxt.InsufficientFunds as e:
raise DependencyException(
'Insufficient funds to create limit buy order on market {}.'
'Tried to buy amount {} at rate {} (total {}).'
'Message: {}'.format(pair, amount, rate, rate*amount, e)
)
except ccxt.InvalidOrder as e:
raise DependencyException(
'Could not create limit buy order on market {}.'
'Tried to buy amount {} at rate {} (total {}).'
'Message: {}'.format(pair, amount, rate, rate*amount, e)
)
except ccxt.NetworkError as e:
raise NetworkException(
'Could not place buy order due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
def sell(pair: str, rate: float, amount: float) -> Dict:
2017-09-08 21:10:22 +00:00
if _CONF['dry_run']:
2017-11-05 14:21:16 +00:00
global _DRY_RUN_OPEN_ORDERS
2017-11-18 07:52:28 +00:00
order_id = 'dry_run_sell_{}'.format(randint(0, 10**6))
2017-11-05 14:21:16 +00:00
_DRY_RUN_OPEN_ORDERS[order_id] = {
'pair': pair,
'price': rate,
2017-11-05 14:21:16 +00:00
'amount': amount,
'type': 'limit',
'side': 'sell',
2017-11-05 14:21:16 +00:00
'remaining': 0.0,
'datetime': arrow.utcnow().isoformat(),
'status': 'closed'
2017-11-05 14:21:16 +00:00
}
return {'id': order_id}
2017-10-06 10:22:04 +00:00
try:
return _API.create_limit_sell_order(pair, amount, rate)
except ccxt.InsufficientFunds as e:
raise DependencyException(
'Insufficient funds to create limit sell order on market {}.'
'Tried to sell amount {} at rate {} (total {}).'
'Message: {}'.format(pair, amount, rate, rate*amount, e)
)
except ccxt.InvalidOrder as e:
raise DependencyException(
'Could not create limit sell order on market {}.'
'Tried to sell amount {} at rate {} (total {}).'
'Message: {}'.format(pair, amount, rate, rate*amount, e)
)
except ccxt.NetworkError as e:
raise NetworkException(
'Could not place sell order due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
def get_balance(currency: str) -> float:
2017-09-08 21:10:22 +00:00
if _CONF['dry_run']:
return 999.9
2017-10-06 10:22:04 +00:00
# ccxt exception is already handled by get_balances
balances = get_balances()
return balances[currency]['free']
2017-10-30 23:36:35 +00:00
def get_balances() -> dict:
2017-11-01 00:25:48 +00:00
if _CONF['dry_run']:
return {}
try:
balances = _API.fetch_balance()
# Remove additional info from ccxt results
balances.pop("info", None)
balances.pop("free", None)
balances.pop("total", None)
balances.pop("used", None)
return balances
except ccxt.NetworkError as e:
raise NetworkException(
'Could not get balance due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
2017-11-01 00:25:48 +00:00
2017-10-30 23:36:35 +00:00
@retrier
def get_tickers() -> Dict:
try:
return _API.fetch_tickers()
except ccxt.NetworkError as e:
raise NetworkException(
'Could not load tickers due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
except ccxt.NotSupported as e:
raise OperationalException(
'Exchange {} does not support fetching tickers in batch.'
'Message: {}'.format(_API.name, e)
)
# TODO: remove refresh argument, keeping it to keep track of where it was intended to be used
@retrier
2018-01-02 09:56:42 +00:00
def get_ticker(pair: str, refresh: Optional[bool] = True) -> dict:
try:
return _API.fetch_ticker(pair)
except ccxt.NetworkError as e:
raise NetworkException(
'Could not load tickers due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
2017-10-06 10:22:04 +00:00
@retrier
def get_ticker_history(pair: str, tick_interval: str) -> List[Dict]:
try:
return _API.fetch_ohlcv(pair, timeframe=tick_interval)
except ccxt.NetworkError as e:
raise NetworkException(
'Could not load ticker history due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException('Could not fetch ticker data. Msg: {}'.format(e))
except ccxt.NotSupported as e:
raise OperationalException(
'Exchange {} does not support fetching historical candlestick data.'
'Message: {}'.format(_API.name, e)
)
def cancel_order(order_id: str, pair: str) -> None:
2017-09-08 21:10:22 +00:00
if _CONF['dry_run']:
2017-10-06 10:22:04 +00:00
return
try:
return _API.cancel_order(order_id, pair)
except ccxt.NetworkError as e:
raise NetworkException(
'Could not get order due to networking error. Message: {}'.format(e)
)
except ccxt.InvalidOrder as e:
raise DependencyException(
'Could not cancel order. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
def get_order(order_id: str, pair: str) -> Dict:
2017-09-08 21:10:22 +00:00
if _CONF['dry_run']:
order = _DRY_RUN_OPEN_ORDERS[order_id]
2017-11-05 14:21:16 +00:00
order.update({
'id': order_id
})
return order
try:
return _API.fetch_order(order_id, pair)
except ccxt.NetworkError as e:
raise NetworkException(
'Could not get order due to networking error. Message: {}'.format(e)
)
except ccxt.InvalidOrder as e:
raise DependencyException(
'Could not get order. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
def get_pair_detail_url(pair: str) -> str:
try:
url_base = _API.urls.get('www')
base, quote = pair.split('/')
return url_base + _EXCHANGE_URLS[_API.id].format(base=base, quote=quote)
except KeyError:
logger.warning('Could not get exchange url for %s', get_name())
return ""
def get_markets() -> List[dict]:
try:
return _API.fetch_markets()
except ccxt.NetworkError as e:
raise NetworkException(
'Could not load markets due to networking error. Message: {}'.format(e)
)
except ccxt.BaseError as e:
raise OperationalException(e)
2017-11-11 18:20:16 +00:00
def get_name() -> str:
return _API.name
def get_id() -> str:
return _API.id
def get_fee(symbol='ETH/BTC', type='', side='', amount=1,
price=1, taker_or_maker='maker') -> float:
# validate that markets are loaded before trying to get fee
if _API.markets is None or len(_API.markets) == 0:
_API.load_markets()
return _API.calculate_fee(symbol=symbol, type=type, side=side, amount=amount,
price=price, takerOrMaker=taker_or_maker)['rate']