# -*- coding: utf-8 -*- # PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN: # https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code from ccxt.async_support.base.exchange import Exchange from ccxt.abstract.whitebit import ImplicitAPI import hashlib from ccxt.base.types import Any, Balances, BorrowInterest, Bool, Conversion, CrossBorrowRate, Currencies, Currency, DepositAddress, FundingHistory, Int, Market, MarketType, Num, Order, OrderBook, OrderSide, OrderType, Position, Str, Strings, Ticker, Tickers, FundingRate, FundingRates, Trade, TradingFees, Transaction, TransferEntry from typing import List from ccxt.base.errors import ExchangeError from ccxt.base.errors import AuthenticationError from ccxt.base.errors import PermissionDenied from ccxt.base.errors import ArgumentsRequired from ccxt.base.errors import BadRequest from ccxt.base.errors import BadSymbol from ccxt.base.errors import InsufficientFunds from ccxt.base.errors import InvalidOrder from ccxt.base.errors import OrderNotFound from ccxt.base.errors import NotSupported from ccxt.base.errors import DDoSProtection from ccxt.base.errors import ExchangeNotAvailable from ccxt.base.decimal_to_precision import TICK_SIZE from ccxt.base.precise import Precise class whitebit(Exchange, ImplicitAPI): def describe(self) -> Any: return self.deep_extend(super(whitebit, self).describe(), { 'id': 'whitebit', 'name': 'WhiteBit', 'version': 'v4', 'countries': ['EE'], 'rateLimit': 50, 'pro': True, 'has': { 'CORS': None, 'spot': True, 'margin': True, 'swap': True, 'future': False, 'option': False, 'cancelAllOrders': True, 'cancelAllOrdersAfter': True, 'cancelOrder': True, 'cancelOrders': False, 'createConvertTrade': True, 'createDepositAddress': True, 'createMarketBuyOrderWithCost': True, 'createMarketOrderWithCost': False, 'createMarketSellOrderWithCost': False, 'createOrder': True, 'createPostOnlyOrder': True, 'createStopLimitOrder': True, 'createStopMarketOrder': True, 'createStopOrder': True, 'createTriggerOrder': True, 'editOrder': False, 'fetchBalance': True, 'fetchBorrowRateHistories': False, 'fetchBorrowRateHistory': False, 'fetchClosedOrders': True, 'fetchConvertQuote': True, 'fetchConvertTrade': False, 'fetchConvertTradeHistory': True, 'fetchCrossBorrowRate': True, 'fetchCrossBorrowRates': False, 'fetchCurrencies': True, 'fetchDeposit': True, 'fetchDepositAddress': True, 'fetchDepositAddresses': False, 'fetchDepositAddressesByNetwork': False, 'fetchDeposits': True, 'fetchDepositsWithdrawals': True, 'fetchDepositWithdrawFee': 'emulated', 'fetchDepositWithdrawFees': True, 'fetchFundingHistory': True, 'fetchFundingRate': True, 'fetchFundingRateHistory': False, 'fetchFundingRates': True, 'fetchIndexOHLCV': False, 'fetchIsolatedBorrowRate': False, 'fetchIsolatedBorrowRates': False, 'fetchMarginMode': False, 'fetchMarkets': True, 'fetchMarkOHLCV': False, 'fetchMyTrades': True, 'fetchOHLCV': True, 'fetchOpenInterestHistory': False, 'fetchOpenOrders': True, 'fetchOrderBook': True, 'fetchOrderTrades': True, 'fetchPosition': True, 'fetchPositionHistory': True, 'fetchPositionMode': False, 'fetchPositions': True, 'fetchPremiumIndexOHLCV': False, 'fetchStatus': True, 'fetchTicker': True, 'fetchTickers': True, 'fetchTime': True, 'fetchTrades': True, 'fetchTradingFee': False, 'fetchTradingFees': True, 'fetchTransactionFees': True, 'repayCrossMargin': False, 'repayIsolatedMargin': False, 'setLeverage': True, 'transfer': True, 'withdraw': True, }, 'timeframes': { '1m': '1m', '3m': '3m', '5m': '5m', '15m': '15m', '30m': '30m', '1h': '1h', '2h': '2h', '4h': '4h', '6h': '6h', '8h': '8h', '12h': '12h', '1d': '1d', '3d': '3d', '1w': '1w', '1M': '1M', }, 'urls': { 'logo': 'https://user-images.githubusercontent.com/1294454/66732963-8eb7dd00-ee66-11e9-849b-10d9282bb9e0.jpg', 'api': { 'v1': { 'public': 'https://whitebit.com/api/v1/public', 'private': 'https://whitebit.com/api/v1', }, 'v2': { 'public': 'https://whitebit.com/api/v2/public', }, 'v4': { 'public': 'https://whitebit.com/api/v4/public', 'private': 'https://whitebit.com/api/v4', }, }, 'www': 'https://www.whitebit.com', 'doc': 'https://github.com/whitebit-exchange/api-docs', 'fees': 'https://whitebit.com/fee-schedule', 'referral': 'https://whitebit.com/referral/d9bdf40e-28f2-4b52-b2f9-cd1415d82963', }, 'api': { 'web': { 'get': [ 'v1/healthcheck', ], }, 'v1': { 'public': { 'get': [ 'markets', 'tickers', 'ticker', 'symbols', 'depth/result', 'history', 'kline', ], }, 'private': { 'post': [ 'account/balance', 'order/new', 'order/cancel', 'orders', 'account/order_history', 'account/executed_history', 'account/executed_history/all', 'account/order', ], }, }, 'v2': { 'public': { 'get': [ 'markets', 'ticker', 'assets', 'fee', 'depth/{market}', 'trades/{market}', ], }, }, 'v4': { 'public': { 'get': [ 'assets', 'collateral/markets', 'fee', 'orderbook/depth/{market}', 'orderbook/{market}', 'ticker', 'trades/{market}', 'time', 'ping', 'markets', 'futures', 'platform/status', 'mining-pool', ], }, 'private': { 'post': [ 'collateral-account/balance', 'collateral-account/balance-summary', 'collateral-account/positions/history', 'collateral-account/leverage', 'collateral-account/positions/open', 'collateral-account/summary', 'collateral-account/funding-history', 'main-account/address', 'main-account/balance', 'main-account/create-new-address', 'main-account/codes', 'main-account/codes/apply', 'main-account/codes/my', 'main-account/codes/history', 'main-account/fiat-deposit-url', 'main-account/history', 'main-account/withdraw', 'main-account/withdraw-pay', 'main-account/transfer', 'main-account/smart/plans', 'main-account/smart/investment', 'main-account/smart/investment/close', 'main-account/smart/investments', 'main-account/fee', 'main-account/smart/interest-payment-history', 'trade-account/balance', 'trade-account/executed-history', 'trade-account/order', 'trade-account/order/history', 'order/collateral/limit', 'order/collateral/market', 'order/collateral/stop-limit', 'order/collateral/trigger-market', 'order/collateral/bulk', 'order/new', 'order/market', 'order/stock_market', 'order/stop_limit', 'order/stop_market', 'order/cancel', 'order/cancel/all', 'order/kill-switch', 'order/kill-switch/status', 'order/bulk', 'order/modify', 'order/conditional-cancel', 'orders', 'oco-orders', 'order/collateral/oco', 'order/oco-cancel', 'order/oto-cancel', 'profile/websocket_token', 'convert/estimate', 'convert/confirm', 'convert/history', 'sub-account/create', 'sub-account/delete', 'sub-account/edit', 'sub-account/list', 'sub-account/transfer', 'sub-account/block', 'sub-account/unblock', 'sub-account/balances', 'sub-account/transfer/history', 'sub-account/api-key/create', 'sub-account/api-key/edit', 'sub-account/api-key/delete', 'sub-account/api-key/list', 'sub-account/api-key/reset', 'sub-account/api-key/ip-address/list', 'sub-account/api-key/ip-address/create', 'sub-account/api-key/ip-address/delete', 'mining/rewards', 'market/fee', 'conditional-orders', ], }, }, }, 'fees': { 'trading': { 'tierBased': False, 'percentage': True, 'taker': self.parse_number('0.001'), 'maker': self.parse_number('0.001'), }, }, 'options': { 'timeDifference': 0, # the difference between system clock and exchange clock 'adjustForTimeDifference': False, # controls the adjustment logic upon instantiation 'fiatCurrencies': ['EUR', 'USD', 'RUB', 'UAH'], 'fetchBalance': { 'account': 'spot', }, 'accountsByType': { 'funding': 'main', 'main': 'main', 'spot': 'spot', 'margin': 'collateral', 'trade': 'spot', }, 'networksById': { 'BEP20': 'BSC', }, 'defaultType': 'spot', 'brokerId': 'ccxt', }, 'features': { 'default': { 'sandbox': False, 'createOrder': { 'marginMode': True, 'triggerPrice': True, 'triggerDirection': False, 'triggerPriceType': None, 'stopLossPrice': False, # todo 'takeProfitPrice': False, # todo 'attachedStopLossTakeProfit': None, 'timeInForce': { 'IOC': True, # todo 'FOK': False, 'PO': True, # todo 'GTD': False, }, 'hedged': False, 'trailing': False, 'leverage': False, 'marketBuyByCost': True, 'marketBuyRequiresPrice': False, 'selfTradePrevention': False, 'iceberg': False, }, 'createOrders': None, 'fetchMyTrades': { 'marginMode': False, 'limit': 100, 'daysBack': None, 'untilDays': None, 'symbolRequired': False, }, 'fetchOrder': None, 'fetchOpenOrders': { 'marginMode': False, 'limit': 100, 'trigger': False, 'trailing': False, 'symbolRequired': False, }, 'fetchOrders': None, # todo 'fetchClosedOrders': { 'marginMode': False, 'limit': 100, 'daysBack': None, 'daysBackCanceled': None, 'untilDays': None, 'trigger': False, 'trailing': False, 'symbolRequired': False, }, 'fetchOHLCV': { 'limit': 1440, }, }, 'spot': { 'extends': 'default', }, 'swap': { 'linear': { 'extends': 'default', }, 'inverse': { 'extends': 'default', }, }, 'future': { 'linear': None, 'inverse': None, }, }, 'precisionMode': TICK_SIZE, 'exceptions': { 'exact': { 'Unauthorized request.': AuthenticationError, # {"code":10,"message":"Unauthorized request."} 'The market format is invalid.': BadSymbol, # {"code":0,"message":"Validation failed","errors":{"market":["The market format is invalid."]}} 'Market is not available': BadSymbol, # {"success":false,"message":{"market":["Market is not available"]},"result":[]} 'Invalid payload.': BadRequest, # {"code":9,"message":"Invalid payload."} 'Amount must be greater than 0': InvalidOrder, # {"code":0,"message":"Validation failed","errors":{"amount":["Amount must be greater than 0"]}} 'Not enough balance.': InsufficientFunds, # {"code":10,"message":"Inner validation failed","errors":{"amount":["Not enough balance."]}} 'The order id field is required.': InvalidOrder, # {"code":0,"message":"Validation failed","errors":{"orderId":["The order id field is required."]}} 'Not enough balance': InsufficientFunds, # {"code":0,"message":"Validation failed","errors":{"amount":["Not enough balance"]}} 'This action is unauthorized.': PermissionDenied, # {"code":0,"message":"This action is unauthorized."} 'This API Key is not authorized to perform self action.': PermissionDenied, # {"code":4,"message":"This API Key is not authorized to perform self action."} 'Unexecuted order was not found.': OrderNotFound, # {"code":2,"message":"Inner validation failed","errors":{"order_id":["Unexecuted order was not found."]}} 'The selected from is invalid.': BadRequest, # {"code":0,"message":"Validation failed","errors":{"from":["The selected from is invalid."]}} '503': ExchangeNotAvailable, # {"response":null,"status":503,"errors":{"message":[""]},"notification":null,"warning":null,"_token":null}, '422': OrderNotFound, # {"response":null,"status":422,"errors":{"orderId":["Finished order id 1295772653 not found on your account"]},"notification":null,"warning":"Finished order id 1295772653 not found on your account","_token":null} }, 'broad': { 'This action is unauthorized': PermissionDenied, # {"code":2,"message":"This action is unauthorized. Enable your key in API settings"} 'Given amount is less than min amount': InvalidOrder, # {"code":0,"message":"Validation failed","errors":{"amount":["Given amount is less than min amount 200000"],"total":["Total is less than 5.05"]}} 'Min amount step': InvalidOrder, # {"code":32,"errors":{"amount":["Min amount step = 0.01"]},"message":"Validation failed"} 'Total is less than': InvalidOrder, # {"code":0,"message":"Validation failed","errors":{"amount":["Given amount is less than min amount 200000"],"total":["Total is less than 5.05"]}} 'fee must be no less than': InvalidOrder, # {"code":0,"message":"Validation failed","errors":{"amount":["Total amount + fee must be no less than 5.05505"]}} 'Enable your key in API settings': PermissionDenied, # {"code":2,"message":"This action is unauthorized. Enable your key in API settings"} 'You don\'t have such amount for transfer': InsufficientFunds, # {"code":3,"message":"Inner validation failed","errors":{"amount":["You don't have such amount for transfer(available 0.44523433, in amount: 2)"]}} }, }, }) async def fetch_markets(self, params={}) -> List[Market]: """ retrieves data on all markets for whitebit https://docs.whitebit.com/public/http-v4/#market-info :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data """ if self.options['adjustForTimeDifference']: await self.load_time_difference() markets = await self.v4PublicGetMarkets() # # [ # { # "name": "SON_USD", # Market pair name # "stock": "SON", # Ticker of stock currency # "money": "USD", # Ticker of money currency # "stockPrec": "3", # Stock currency precision # "moneyPrec": "2", # Precision of money currency # "feePrec": "4", # Fee precision # "makerFee": "0.1", # Default maker fee ratio # "takerFee": "0.1", # Default taker fee ratio # "minAmount": "0.001", # Minimal amount of stock to trade # "minTotal": "0.001", # Minimal amount of money to trade # "tradesEnabled": True, # Is trading enabled # "isCollateral": True, # Is margin trading enabled # "type": "spot", # Market type. Possible values: "spot", "futures" # "maxTotal": "1000000000" # Maximum total(amount * price) of money to trade # }, # { # ... # } # ] # return self.parse_markets(markets) def parse_market(self, market: dict) -> Market: id = self.safe_string(market, 'name') baseId = self.safe_string(market, 'stock') quoteId = self.safe_string(market, 'money') quoteId = 'USDT' if (quoteId == 'PERP') else quoteId base = self.safe_currency_code(baseId) quote = self.safe_currency_code(quoteId) active = self.safe_value(market, 'tradesEnabled') isCollateral = self.safe_value(market, 'isCollateral') typeId = self.safe_string(market, 'type') type: MarketType settle: Str = None settleId: Str = None symbol = base + '/' + quote swap = typeId == 'futures' margin = isCollateral and not swap contract = False amountPrecision = self.parse_number(self.parse_precision(self.safe_string(market, 'stockPrec'))) contractSize = amountPrecision linear: Bool = None inverse: Bool = None if swap: settleId = quoteId settle = self.safe_currency_code(settleId) symbol = symbol + ':' + settle type = 'swap' contract = True linear = True inverse = False else: type = 'spot' takerFeeRate = self.safe_string(market, 'takerFee') taker = Precise.string_div(takerFeeRate, '100') makerFeeRate = self.safe_string(market, 'makerFee') maker = Precise.string_div(makerFeeRate, '100') return { 'id': id, 'symbol': symbol, 'base': base, 'quote': quote, 'settle': settle, 'baseId': baseId, 'quoteId': quoteId, 'settleId': settleId, 'type': type, 'spot': not swap, 'margin': margin, 'swap': swap, 'future': False, 'option': False, 'active': active, 'contract': contract, 'linear': linear, 'inverse': inverse, 'taker': self.parse_number(taker), 'maker': self.parse_number(maker), 'contractSize': contractSize, 'expiry': None, 'expiryDatetime': None, 'strike': None, 'optionType': None, 'precision': { 'amount': amountPrecision, 'price': self.parse_number(self.parse_precision(self.safe_string(market, 'moneyPrec'))), }, 'limits': { 'leverage': { 'min': None, 'max': None, }, 'amount': { 'min': self.safe_number(market, 'minAmount'), 'max': None, }, 'price': { 'min': None, 'max': None, }, 'cost': { 'min': self.safe_number(market, 'minTotal'), 'max': self.safe_number(market, 'maxTotal'), }, }, 'created': None, 'info': market, } async def fetch_currencies(self, params={}) -> Currencies: """ fetches all available currencies on an exchange https://docs.whitebit.com/public/http-v4/#asset-status-list :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an associative dictionary of currencies """ response = await self.v4PublicGetAssets(params) # # { # BTC: { # name: "Bitcoin", # unified_cryptoasset_id: "1", # can_withdraw: True, # can_deposit: True, # min_withdraw: "0.0003", # max_withdraw: "0", # maker_fee: "0.1", # taker_fee: "0.1", # min_deposit: "0.0001", # max_deposit: "0", # networks: { # deposits: ["BTC",], # withdraws: ["BTC",], # default: "BTC", # }, # confirmations: { # BTC: "2", # }, # limits: { # deposit: { # BTC: {min: "0.0001",}, # }, # withdraw: { # BTC: {min: "0.0003",}, # }, # }, # currency_precision: "8", # is_memo: False, # }, # USD: { # name: "United States Dollar", # unified_cryptoasset_id: "6955", # can_withdraw: True, # can_deposit: True, # min_withdraw: "10", # max_withdraw: "10000", # maker_fee: "0.1", # taker_fee: "0.1", # min_deposit: "10", # max_deposit: "10000", # networks: { # deposits: ["USD",], # withdraws: ["USD",], # default: "USD", # }, # providers: { # deposits: ["ADVCASH",], # withdraws: ["ADVCASH",], # }, # limits: { # deposit: { # USD: { max: "10000", min: "10",}, # }, # withdraw: { # USD: {max: "10000", min: "10",}, # }, # }, # currency_precision: "2", # is_memo: False, # } # } # ids = list(response.keys()) result: dict = {} for i in range(0, len(ids)): id = ids[i] currency = response[id] # breaks down in Python due to utf8 encoding issues on the exchange side # name = self.safe_string(currency, 'name') canDeposit = self.safe_bool(currency, 'can_deposit', True) canWithdraw = self.safe_bool(currency, 'can_withdraw', True) active = canDeposit and canWithdraw code = self.safe_currency_code(id) hasProvider = ('providers' in currency) result[code] = { 'id': id, 'code': code, 'info': currency, # the original payload 'name': None, # see the comment above 'active': active, 'deposit': canDeposit, 'withdraw': canWithdraw, 'fee': None, 'networks': None, # todo 'type': 'fiat' if hasProvider else 'crypto', 'precision': None, 'limits': { 'amount': { 'min': None, 'max': None, }, 'withdraw': { 'min': self.safe_number(currency, 'min_withdraw'), 'max': self.safe_number(currency, 'max_withdraw'), }, }, } return result async def fetch_transaction_fees(self, codes: Strings = None, params={}): """ @deprecated please use fetchDepositWithdrawFees instead https://docs.whitebit.com/public/http-v4/#fee :param str[]|None codes: not used by fetchTransactionFees() :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a list of `fee structures ` """ await self.load_markets() response = await self.v4PublicGetFee(params) # # { # "1INCH":{ # "is_depositable":true, # "is_withdrawal":true, # "ticker":"1INCH", # "name":"1inch", # "providers":[ # ], # "withdraw":{ # "max_amount":"0", # "min_amount":"21.5", # "fixed":"17.5", # "flex":null # }, # "deposit":{ # "max_amount":"0", # "min_amount":"19.5", # "fixed":null, # "flex":null # } # }, # {...} # } # currenciesIds = list(response.keys()) withdrawFees: dict = {} depositFees: dict = {} for i in range(0, len(currenciesIds)): currency = currenciesIds[i] data = response[currency] code = self.safe_currency_code(currency) withdraw = self.safe_value(data, 'withdraw', {}) withdrawFees[code] = self.safe_string(withdraw, 'fixed') deposit = self.safe_value(data, 'deposit', {}) depositFees[code] = self.safe_string(deposit, 'fixed') return { 'withdraw': withdrawFees, 'deposit': depositFees, 'info': response, } async def fetch_deposit_withdraw_fees(self, codes: Strings = None, params={}): """ fetch deposit and withdraw fees https://docs.whitebit.com/public/http-v4/#fee :param str[]|None codes: not used by fetchDepositWithdrawFees() :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a list of `fee structures ` """ await self.load_markets() response = await self.v4PublicGetFee(params) # # { # "1INCH": { # "is_depositable": True, # "is_withdrawal": True, # "ticker": "1INCH", # "name": "1inch", # "providers": [], # "withdraw": { # "max_amount": "0", # "min_amount": "21.5", # "fixed": "17.5", # "flex": null # }, # "deposit": { # "max_amount": "0", # "min_amount": "19.5", # "fixed": null, # "flex": null # } # }, # "WBT(ERC20)": { # "is_depositable": True, # "is_withdrawal": True, # "ticker": "WBT", # "name": "WhiteBIT Token", # "providers": [], # "withdraw": {max_amount: "0", min_amount: '0.7', fixed: "0.253", flex: null}, # "deposit": {max_amount: "0", min_amount: "0.35", fixed: null, flex: null} # }, # "WBT(TRC20)": { # "is_depositable": True, # "is_withdrawal": True, # "ticker": "WBT", # "name": "WhiteBIT Token", # "providers": [], # "withdraw": {max_amount: "0", min_amount: "1.5", fixed: "0.075", flex: null}, # "deposit": {max_amount: "0", min_amount: "0.75", fixed: null, flex: null} # }, # ... # } # return self.parse_deposit_withdraw_fees(response, codes) def parse_deposit_withdraw_fees(self, response, codes=None, currencyIdKey=None): # # { # "1INCH": { # "is_depositable": True, # "is_withdrawal": True, # "ticker": "1INCH", # "name": "1inch", # "providers": [], # "withdraw": { # "max_amount": "0", # "min_amount": "21.5", # "fixed": "17.5", # "flex": null # }, # "deposit": { # "max_amount": "0", # "min_amount": "19.5", # "fixed": null, # "flex": null # } # }, # "WBT(ERC20)": { # "is_depositable": True, # "is_withdrawal": True, # "ticker": "WBT", # "name": "WhiteBIT Token", # "providers": [], # "withdraw": {max_amount: "0", min_amount: "0.7", fixed: "0.253", flex: null}, # "deposit": {max_amount: "0", min_amount: "0.35", fixed: null, flex: null} # }, # "WBT(TRC20)": { # "is_depositable": True, # "is_withdrawal": True, # "ticker": "WBT", # "name": "WhiteBIT Token", # "providers": [], # "withdraw": {max_amount: "0", min_amount: "1.5", fixed: "0.075", flex: null}, # "deposit": {max_amount: "0", min_amount: "0.75", fixed: null, flex: null} # }, # ... # } # depositWithdrawFees: dict = {} codes = self.market_codes(codes) currencyIds = list(response.keys()) for i in range(0, len(currencyIds)): entry = currencyIds[i] splitEntry = entry.split(' ') currencyId = splitEntry[0] feeInfo = response[entry] code = self.safe_currency_code(currencyId) if (codes is None) or (self.in_array(code, codes)): depositWithdrawFee = self.safe_value(depositWithdrawFees, code) if depositWithdrawFee is None: depositWithdrawFees[code] = self.deposit_withdraw_fee({}) depositWithdrawFees[code]['info'][entry] = feeInfo networkId = self.safe_string(splitEntry, 1) withdraw = self.safe_value(feeInfo, 'withdraw') deposit = self.safe_value(feeInfo, 'deposit') withdrawFee = self.safe_number(withdraw, 'fixed') depositFee = self.safe_number(deposit, 'fixed') withdrawResult: dict = { 'fee': withdrawFee, 'percentage': False if (withdrawFee is not None) else None, } depositResult: dict = { 'fee': depositFee, 'percentage': False if (depositFee is not None) else None, } if networkId is not None: networkLength = len(networkId) networkId = networkId[1:networkLength - 1] networkCode = self.network_id_to_code(networkId) depositWithdrawFees[code]['networks'][networkCode] = { 'withdraw': withdrawResult, 'deposit': depositResult, } else: depositWithdrawFees[code]['withdraw'] = withdrawResult depositWithdrawFees[code]['deposit'] = depositResult depositWithdrawCodes = list(depositWithdrawFees.keys()) for i in range(0, len(depositWithdrawCodes)): code = depositWithdrawCodes[i] currency = self.currency(code) depositWithdrawFees[code] = self.assign_default_deposit_withdraw_fees(depositWithdrawFees[code], currency) return depositWithdrawFees async def fetch_trading_fees(self, params={}) -> TradingFees: """ fetch the trading fees for multiple markets https://docs.whitebit.com/public/http-v4/#asset-status-list :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a dictionary of `fee structures ` indexed by market symbols """ await self.load_markets() response = await self.v4PublicGetAssets(params) # # { # "1INCH": { # "name": "1inch", # "unified_cryptoasset_id": "8104", # "can_withdraw": True, # "can_deposit": True, # "min_withdraw": "33", # "max_withdraw": "0", # "maker_fee": "0.1", # "taker_fee": "0.1", # "min_deposit": "30", # "max_deposit": "0" # }, # ... # } # result: dict = {} for i in range(0, len(self.symbols)): symbol = self.symbols[i] market = self.market(symbol) fee = self.safe_value(response, market['baseId'], {}) makerFee = self.safe_string(fee, 'maker_fee') takerFee = self.safe_string(fee, 'taker_fee') makerFee = Precise.string_div(makerFee, '100') takerFee = Precise.string_div(takerFee, '100') result[symbol] = { 'info': fee, 'symbol': market['symbol'], 'percentage': True, 'tierBased': False, 'maker': self.parse_number(makerFee), 'taker': self.parse_number(takerFee), } return result async def fetch_ticker(self, symbol: str, params={}) -> Ticker: """ fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market https://docs.whitebit.com/public/http-v4/#market-activity :param str symbol: unified symbol of the market to fetch the ticker for :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `ticker structure ` """ await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], } response = await self.v1PublicGetTicker(self.extend(request, params)) # # { # "success":true, # "message":"", # "result": { # "bid":"0.021979", # "ask":"0.021996", # "open":"0.02182", # "high":"0.022039", # "low":"0.02161", # "last":"0.021987", # "volume":"2810.267", # "deal":"61.383565474", # "change":"0.76", # }, # } # ticker = self.safe_dict(response, 'result', {}) return self.parse_ticker(ticker, market) def parse_ticker(self, ticker: dict, market: Market = None) -> Ticker: # # FetchTicker(v1) # # { # "bid": "0.021979", # "ask": "0.021996", # "open": "0.02182", # "high": "0.022039", # "low": "0.02161", # "last": "0.021987", # "volume": "2810.267", # "deal": "61.383565474", # "change": "0.76", # } # # FetchTickers(v4) # # "BCH_RUB": { # "base_id": 1831, # "quote_id": 0, # "last_price": "32830.21", # "quote_volume": "1494659.8024096", # "base_volume": "46.1083", # "isFrozen": False, # "change": "2.12" # in percent # } # # WS market_update # # { # "open": "52853.04", # "close": "55913.88", # "high": "56272", # "low": "49549.67", # "volume": "57331.067185", # "deal": "3063860382.42985338", # "last": "55913.88", # "period": 86400 # } # v2 # { # lastUpdateTimestamp: '2025-01-02T09:16:36.000Z', # tradingPairs: 'ARB_USDC', # lastPrice: '0.7727', # lowestAsk: '0.7735', # highestBid: '0.7732', # baseVolume24h: '1555793.74', # quoteVolume24h: '1157602.622406', # tradesEnabled: True # } # marketId = self.safe_string(ticker, 'tradingPairs') market = self.safe_market(marketId, market) # last price is provided as "last" or "last_price" last = self.safe_string_n(ticker, ['last', 'last_price', 'lastPrice']) # if "close" is provided, use it, otherwise use close = self.safe_string(ticker, 'close', last) return self.safe_ticker({ 'symbol': market['symbol'], 'timestamp': None, 'datetime': None, 'high': self.safe_string(ticker, 'high'), 'low': self.safe_string(ticker, 'low'), 'bid': self.safe_string_2(ticker, 'bid', 'highestBid'), 'bidVolume': None, 'ask': self.safe_string_2(ticker, 'ask', 'lowestAsk'), 'askVolume': None, 'vwap': None, 'open': self.safe_string(ticker, 'open'), 'close': close, 'last': last, 'previousClose': None, 'change': None, 'percentage': self.safe_string(ticker, 'change'), 'average': None, 'baseVolume': self.safe_string_n(ticker, ['base_volume', 'volume', 'baseVolume24h']), 'quoteVolume': self.safe_string_n(ticker, ['quote_volume', 'deal', 'quoteVolume24h']), 'info': ticker, }, market) async def fetch_tickers(self, symbols: Strings = None, params={}) -> Tickers: """ fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market https://docs.whitebit.com/public/http-v4/#market-activity :param str[] [symbols]: unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.method]: either v2PublicGetTicker or v4PublicGetTicker default is v4PublicGetTicker :returns dict: a dictionary of `ticker structures ` """ await self.load_markets() symbols = self.market_symbols(symbols) method = 'v4PublicGetTicker' method, params = self.handle_option_and_params(params, 'fetchTickers', 'method', method) response = None if method == 'v4PublicGetTicker': response = await self.v4PublicGetTicker(params) else: response = await self.v2PublicGetTicker(params) # # "BCH_RUB": { # "base_id":1831, # "quote_id":0, # "last_price":"32830.21", # "quote_volume":"1494659.8024096", # "base_volume":"46.1083", # "isFrozen":false, # "change":"2.12" # }, # resultList = self.safe_list(response, 'result') if resultList is not None: return self.parse_tickers(resultList, symbols) marketIds = list(response.keys()) result: dict = {} for i in range(0, len(marketIds)): marketId = marketIds[i] market = self.safe_market(marketId) ticker = self.parse_ticker(response[marketId], market) symbol = ticker['symbol'] result[symbol] = ticker return self.filter_by_array_tickers(result, 'symbol', symbols) async def fetch_order_book(self, symbol: str, limit: Int = None, params={}) -> OrderBook: """ fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data https://docs.whitebit.com/public/http-v4/#orderbook :param str symbol: unified symbol of the market to fetch the order book for :param int [limit]: the maximum amount of order book entries to return :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: A dictionary of `order book structures ` indexed by market symbols """ await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], } if limit is not None: request['limit'] = limit # default = 100, maximum = 100 response = await self.v4PublicGetOrderbookMarket(self.extend(request, params)) # # { # "timestamp": 1594391413, # "asks": [ # [ # "9184.41", # "0.773162" # ], # [...] # ], # "bids": [ # [ # "9181.19", # "0.010873" # ], # [...] # ] # } # timestamp = self.safe_timestamp(response, 'timestamp') return self.parse_order_book(response, symbol, timestamp) async def fetch_trades(self, symbol: str, since: Int = None, limit: Int = None, params={}) -> List[Trade]: """ get the list of most recent trades for a particular symbol https://docs.whitebit.com/public/http-v4/#recent-trades :param str symbol: unified symbol of the market to fetch trades for :param int [since]: timestamp in ms of the earliest trade to fetch :param int [limit]: the maximum amount of trades to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :returns Trade[]: a list of `trade structures ` """ await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], } response = await self.v4PublicGetTradesMarket(self.extend(request, params)) # # [ # { # "tradeID": 158056419, # "price": "9186.13", # "quote_volume": "0.0021", # "base_volume": "9186.13", # "trade_timestamp": 1594391747, # "type": "sell" # }, # ], # return self.parse_trades(response, market, since, limit) async def fetch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}): """ fetch all trades made by the user https://docs.whitebit.com/private/http-trade-v4/#query-executed-order-history :param str symbol: unified symbol of the market to fetch trades for :param int [since]: timestamp in ms of the earliest trade to fetch :param int [limit]: the maximum amount of trades to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :returns Trade[]: a list of `trade structures ` """ await self.load_markets() market: Market = None request: dict = {} if symbol is not None: market = self.market(symbol) request['market'] = market['id'] response = await self.v4PrivatePostTradeAccountExecutedHistory(self.extend(request, params)) # # when no symbol is provided # # { # "USDC_USDT":[ # { # "id":"1343815269", # "clientOrderId":"", # "time":"1641051917.532965", # "side":"sell", # "role":"2", # "amount":"9.986", # "price":"0.9995", # "deal":"9.981007", # "fee":"0.009981007", # "orderId":"58166729555" # }, # ] # } # # when a symbol is provided # # [ # { # "id": 1343815269, # "clientOrderId": '', # "time": 1641051917.532965, # "side": "sell", # "role": 2, # "amount": "9.986", # "price": "0.9995", # "deal": "9.981007", # "fee": "0.009981007", # "orderId": 58166729555, # }, # ] # if isinstance(response, list): return self.parse_trades(response, market, since, limit) else: results = [] keys = list(response.keys()) for i in range(0, len(keys)): marketId = keys[i] marketNew = self.safe_market(marketId, None, '_') rawTrades = self.safe_value(response, marketId, []) parsed = self.parse_trades(rawTrades, marketNew, since, limit) results = self.array_concat(results, parsed) results = self.sort_by_2(results, 'timestamp', 'id') return self.filter_by_since_limit(results, since, limit, 'timestamp') def parse_trade(self, trade: dict, market: Market = None) -> Trade: # # fetchTradesV4 # # { # "tradeID": 158056419, # "price": "9186.13", # "quote_volume": "0.0021", # "base_volume": "9186.13", # "trade_timestamp": 1594391747, # "type": "sell" # } # # orderTrades(v4Private) # # { # "time": 1593342324.613711, # "fee": "0.00000419198", # "price": "0.00000701", # "amount": "598", # "id": 149156519, # trade id # "dealOrderId": 3134995325, # orderId # "clientOrderId": "customId11", # "role": 2, # 1 = maker, 2 = taker # "deal": "0.00419198" # amount in money # "feeAsset": "USDT" # } # # fetchMyTrades # # { # "id": 1343815269, # "clientOrderId": '', # "time": 1641051917.532965, # "side": "sell", # "role": 2, # "amount": "9.986", # "price": "0.9995", # "deal": "9.981007", # "fee": "0.009981007", # "orderId": 58166729555, # "feeAsset": "USDT" # } # market = self.safe_market(None, market) timestamp = self.safe_timestamp_2(trade, 'time', 'trade_timestamp') orderId = self.safe_string_2(trade, 'dealOrderId', 'orderId') cost = self.safe_string(trade, 'deal') price = self.safe_string(trade, 'price') amount = self.safe_string_2(trade, 'amount', 'quote_volume') id = self.safe_string_2(trade, 'id', 'tradeID') side = self.safe_string_2(trade, 'type', 'side') symbol = market['symbol'] role = self.safe_integer(trade, 'role') takerOrMaker: Str = None if role is not None: takerOrMaker = 'maker' if (role == 1) else 'taker' fee = None feeCost = self.safe_string(trade, 'fee') if feeCost is not None: fee = { 'cost': feeCost, 'currency': self.safe_currency_code(self.safe_string(trade, 'feeAsset')), } return self.safe_trade({ 'info': trade, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'symbol': symbol, 'id': id, 'order': orderId, 'type': None, 'takerOrMaker': takerOrMaker, 'side': side, 'price': price, 'amount': amount, 'cost': cost, 'fee': fee, }, market) async def fetch_ohlcv(self, symbol: str, timeframe='1m', since: Int = None, limit: Int = None, params={}) -> List[list]: """ fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market https://docs.whitebit.com/public/http-v1/#kline :param str symbol: unified symbol of the market to fetch OHLCV data for :param str timeframe: the length of time each candle represents :param int [since]: timestamp in ms of the earliest candle to fetch :param int [limit]: the maximum amount of candles to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :returns int[][]: A list of candles ordered, open, high, low, close, volume """ await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], 'interval': self.safe_string(self.timeframes, timeframe, timeframe), } if since is not None: maxLimit = 1440 if limit is None: limit = maxLimit limit = min(limit, maxLimit) start = self.parse_to_int(since / 1000) request['start'] = start if limit is not None: request['limit'] = min(limit, 1440) response = await self.v1PublicGetKline(self.extend(request, params)) # # { # "success":true, # "message":"", # "result":[ # [1591488000,"0.025025","0.025025","0.025029","0.025023","6.181","0.154686629"], # [1591488060,"0.025028","0.025033","0.025035","0.025026","8.067","0.201921167"], # [1591488120,"0.025034","0.02505","0.02505","0.025034","20.089","0.503114696"], # ] # } # result = self.safe_list(response, 'result', []) return self.parse_ohlcvs(result, market, timeframe, since, limit) def parse_ohlcv(self, ohlcv, market: Market = None) -> list: # # [ # 1591488000, # "0.025025", # "0.025025", # "0.025029", # "0.025023", # "6.181", # "0.154686629" # ] # return [ self.safe_timestamp(ohlcv, 0), # timestamp self.safe_number(ohlcv, 1), # open self.safe_number(ohlcv, 3), # high self.safe_number(ohlcv, 4), # low self.safe_number(ohlcv, 2), # close self.safe_number(ohlcv, 5), # volume ] async def fetch_status(self, params={}): """ the latest known information on the availability of the exchange API https://docs.whitebit.com/public/http-v4/#server-status :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `status structure ` """ response = await self.v4PublicGetPing(params) # # [ # "pong" # ] # status = self.safe_string(response, 0) return { 'status': 'ok' if (status == 'pong') else status, 'updated': None, 'eta': None, 'url': None, 'info': response, } async def fetch_time(self, params={}) -> Int: """ fetches the current integer timestamp in milliseconds from the exchange server https://docs.whitebit.com/public/http-v4/#server-time :param dict [params]: extra parameters specific to the exchange API endpoint :returns int: the current integer timestamp in milliseconds from the exchange server """ response = await self.v4PublicGetTime(params) # # { # "time":1737380046 # } # return self.safe_integer(response, 'time') async def create_market_order_with_cost(self, symbol: str, side: OrderSide, cost: float, params={}): """ create a market order by providing the symbol, side and cost :param str symbol: unified symbol of the market to create an order in :param str side: 'buy' or 'sell' :param float cost: how much you want to trade in units of the quote currency :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `order structure ` """ req = { 'cost': cost, } # only buy side is supported return await self.create_order(symbol, 'market', side, 0, None, self.extend(req, params)) async def create_market_buy_order_with_cost(self, symbol: str, cost: float, params={}) -> Order: """ create a market buy order by providing the symbol and cost :param str symbol: unified symbol of the market to create an order in :param float cost: how much you want to trade in units of the quote currency :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `order structure ` """ return await self.create_market_order_with_cost(symbol, 'buy', cost, params) async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}): """ create a trade order https://docs.whitebit.com/private/http-trade-v4/#create-limit-order https://docs.whitebit.com/private/http-trade-v4/#create-market-order https://docs.whitebit.com/private/http-trade-v4/#create-buy-stock-market-order https://docs.whitebit.com/private/http-trade-v4/#create-stop-limit-order https://docs.whitebit.com/private/http-trade-v4/#create-stop-market-order :param str symbol: unified symbol of the market to create an order in :param str type: 'market' or 'limit' :param str side: 'buy' or 'sell' :param float amount: how much of currency you want to trade in units of base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param float [params.cost]: *market orders only* the cost of the order in units of the base currency :param float [params.triggerPrice]: The price at which a trigger order is triggered at :param bool [params.postOnly]: If True, the order will only be posted to the order book and not executed immediately :param str [params.clientOrderId]: a unique id for the order :param str [params.marginMode]: 'cross' or 'isolated', for margin trading, uses self.options.defaultMarginMode if not passed, defaults to None/None/None :returns dict: an `order structure ` """ await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], 'side': side, } cost = None cost, params = self.handle_param_string(params, 'cost') if cost is not None: if (side != 'buy') or (type != 'market'): raise InvalidOrder(self.id + ' createOrder() cost is only supported for market buy orders') request['amount'] = self.cost_to_precision(symbol, cost) else: request['amount'] = self.amount_to_precision(symbol, amount) clientOrderId = self.safe_string_2(params, 'clOrdId', 'clientOrderId') if clientOrderId is None: brokerId = self.safe_string(self.options, 'brokerId') if brokerId is not None: request['clientOrderId'] = brokerId + self.uuid16() else: request['clientOrderId'] = clientOrderId params = self.omit(params, ['clientOrderId']) marketType = self.safe_string(market, 'type') isLimitOrder = type == 'limit' isMarketOrder = type == 'market' triggerPrice = self.safe_number_n(params, ['triggerPrice', 'stopPrice', 'activation_price']) isStopOrder = (triggerPrice is not None) postOnly = self.is_post_only(isMarketOrder, False, params) marginMode, query = self.handle_margin_mode_and_params('createOrder', params) if postOnly: request['postOnly'] = True if marginMode is not None and marginMode != 'cross': raise NotSupported(self.id + ' createOrder() is only available for cross margin') params = self.omit(query, ['postOnly', 'triggerPrice', 'stopPrice']) useCollateralEndpoint = marginMode is not None or marketType == 'swap' response = None if isStopOrder: request['activation_price'] = self.price_to_precision(symbol, triggerPrice) if isLimitOrder: # stop limit order request['price'] = self.price_to_precision(symbol, price) response = await self.v4PrivatePostOrderStopLimit(self.extend(request, params)) else: # stop market order if useCollateralEndpoint: response = await self.v4PrivatePostOrderCollateralTriggerMarket(self.extend(request, params)) else: response = await self.v4PrivatePostOrderStopMarket(self.extend(request, params)) else: if isLimitOrder: # limit order request['price'] = self.price_to_precision(symbol, price) if useCollateralEndpoint: response = await self.v4PrivatePostOrderCollateralLimit(self.extend(request, params)) else: response = await self.v4PrivatePostOrderNew(self.extend(request, params)) else: # market order if useCollateralEndpoint: response = await self.v4PrivatePostOrderCollateralMarket(self.extend(request, params)) else: if cost is not None: response = await self.v4PrivatePostOrderMarket(self.extend(request, params)) else: response = await self.v4PrivatePostOrderStockMarket(self.extend(request, params)) return self.parse_order(response) async def edit_order(self, id: str, symbol: str, type: OrderType, side: OrderSide, amount: Num = None, price: Num = None, params={}): """ edit a trade order https://docs.whitebit.com/private/http-trade-v4/#modify-order :param str id: cancel order id :param str symbol: unified symbol of the market to create an order in :param str type: 'market' or 'limit' :param str side: 'buy' or 'sell' :param float amount: how much of currency you want to trade in units of base currency :param float price: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `order structure ` """ if id is None: raise ArgumentsRequired(self.id + ' editOrder() requires a id argument') if symbol is None: raise ArgumentsRequired(self.id + ' editOrder() requires a symbol argument') await self.load_markets() market = self.market(symbol) request: dict = { 'orderId': id, 'market': market['id'], } clientOrderId = self.safe_string_2(params, 'clOrdId', 'clientOrderId') if clientOrderId is not None: # Update clientOrderId of the order request['clientOrderId'] = clientOrderId isLimitOrder = type == 'limit' triggerPrice = self.safe_number_n(params, ['triggerPrice', 'stopPrice', 'activation_price']) isStopOrder = (triggerPrice is not None) params = self.omit(params, ['clOrdId', 'clientOrderId', 'triggerPrice', 'stopPrice']) if isStopOrder: request['activation_price'] = self.price_to_precision(symbol, triggerPrice) if isLimitOrder: # stop limit order request['amount'] = self.amount_to_precision(symbol, amount) request['price'] = self.price_to_precision(symbol, price) else: # stop market order if side == 'buy': # Use total parameter instead of amount for modify buy stop market order request['total'] = self.amount_to_precision(symbol, amount) else: request['amount'] = self.amount_to_precision(symbol, amount) else: request['amount'] = self.amount_to_precision(symbol, amount) if isLimitOrder: # limit order request['price'] = self.price_to_precision(symbol, price) response = await self.v4PrivatePostOrderModify(self.extend(request, params)) return self.parse_order(response) async def cancel_order(self, id: str, symbol: Str = None, params={}): """ cancels an open order https://docs.whitebit.com/private/http-trade-v4/#cancel-order :param str id: order id :param str symbol: unified symbol of the market the order was made in :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: An `order structure ` """ if symbol is None: raise ArgumentsRequired(self.id + ' cancelOrder() requires a symbol argument') await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], 'orderId': int(id), } response = await self.v4PrivatePostOrderCancel(self.extend(request, params)) # # { # "orderId": 4180284841, # order id # "clientOrderId": "customId11", # custom order identifier; "clientOrderId": "" - if not specified. # "market": "BTC_USDT", # deal market # "side": "buy", # order side # "type": "stop market", # order type # "timestamp": 1595792396.165973, # current timestamp # "dealMoney": "0", # if order finished - amount in money currency that is finished # "dealStock": "0", # if order finished - amount in stock currency that is finished # "amount": "0.001", # amount # "takerFee": "0.001", # maker fee ratio. If the number less than 0.0001 - it will be rounded to zero # "makerFee": "0.001", # maker fee ratio. If the number less than 0.0001 - it will be rounded to zero # "left": "0.001", # if order not finished - rest of the amount that must be finished # "dealFee": "0", # fee in money that you pay if order is finished # "price": "40000", # price if price isset # "activation_price": "40000" # activation price if activation price is set # } # return self.parse_order(response) async def cancel_all_orders(self, symbol: Str = None, params={}): """ cancel all open orders https://docs.whitebit.com/private/http-trade-v4/#cancel-all-orders :param str symbol: unified market symbol, only orders in the market of self symbol are cancelled when symbol is not None :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: market type, ['swap', 'spot'] :param boolean [params.isMargin]: cancel all margin orders :returns dict[]: a list of `order structures ` """ await self.load_markets() market = None request: dict = {} if symbol is not None: market = self.market(symbol) request['market'] = market['id'] type = None type, params = self.handle_market_type_and_params('cancelAllOrders', market, params) requestType = [] if type == 'spot': isMargin = None isMargin, params = self.handle_option_and_params(params, 'cancelAllOrders', 'isMargin', False) if isMargin: requestType.append('margin') else: requestType.append('spot') elif type == 'swap': requestType.append('futures') else: raise NotSupported(self.id + ' cancelAllOrders() does not support ' + type + ' type') request['type'] = requestType response = await self.v4PrivatePostOrderCancelAll(self.extend(request, params)) # # [] # return self.parse_orders(response, market) async def cancel_all_orders_after(self, timeout: Int, params={}): """ dead man's switch, cancel all orders after the given timeout https://docs.whitebit.com/private/http-trade-v4/#sync-kill-switch-timer :param number timeout: time in milliseconds, 0 represents cancel the timer :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.types]: Order types value. Example: "spot", "margin", "futures" or None :param str [params.symbol]: symbol unified symbol of the market the order was made in :returns dict: the api result """ await self.load_markets() symbol = self.safe_string(params, 'symbol') if symbol is None: raise ArgumentsRequired(self.id + ' cancelAllOrdersAfter() requires a symbol argument in params') market = self.market(symbol) params = self.omit(params, 'symbol') isBiggerThanZero = (timeout > 0) request: dict = { 'market': market['id'], # 'timeout': self.number_to_string(timeout / 1000) if (timeout > 0) else null, } if isBiggerThanZero: request['timeout'] = self.number_to_string(timeout / 1000) else: request['timeout'] = 'null' response = await self.v4PrivatePostOrderKillSwitch(self.extend(request, params)) # # { # "market": "BTC_USDT", # currency market, # "startTime": 1662478154, # now timestamp, # "cancellationTime": 1662478154, # now + timer_value, # "types": ["spot", "margin"] # } # return response def parse_balance(self, response) -> Balances: balanceKeys = list(response.keys()) result: dict = {} for i in range(0, len(balanceKeys)): id = balanceKeys[i] code = self.safe_currency_code(id) balance = response[id] if isinstance(balance, dict) and balance is not None: account = self.account() account['free'] = self.safe_string_2(balance, 'available', 'main_balance') account['used'] = self.safe_string(balance, 'freeze') account['total'] = self.safe_string(balance, 'main_balance') result[code] = account else: account = self.account() account['total'] = balance result[code] = account return self.safe_balance(result) async def fetch_balance(self, params={}) -> Balances: """ query for balance and get the amount of funds available for trading or funds locked in orders https://docs.whitebit.com/private/http-main-v4/#main-balance https://docs.whitebit.com/private/http-trade-v4/#trading-balance :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `balance structure ` """ await self.load_markets() marketType = None marketType, params = self.handle_market_type_and_params('fetchBalance', None, params) response = None if marketType == 'swap': response = await self.v4PrivatePostCollateralAccountBalance(params) else: options = self.safe_value(self.options, 'fetchBalance', {}) defaultAccount = self.safe_string(options, 'account') account = self.safe_string_2(params, 'account', 'type', defaultAccount) params = self.omit(params, ['account', 'type']) if account == 'main' or account == 'funding': response = await self.v4PrivatePostMainAccountBalance(params) else: response = await self.v4PrivatePostTradeAccountBalance(params) # # main account # # { # "BTC":{"main_balance":"0.0013929494020316"}, # "ETH":{"main_balance":"0.001398289308"}, # } # # spot trade account # # { # "BTC": {"available": "0.123", "freeze": "1"}, # "XMR": {"available": "3013", "freeze": "100"}, # } # # swap # # { # "BTC": 1, # "USDT": 1000 # } # return self.parse_balance(response) async def fetch_open_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]: """ fetch all unfilled currently open orders https://docs.whitebit.com/private/http-trade-v4/#query-unexecutedactive-orders :param str [symbol]: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open order structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns Order[]: a list of `order structures ` """ await self.load_markets() market = None request: dict = {} if symbol is not None: market = self.market(symbol) request['market'] = market['id'] if limit is not None: request['limit'] = min(limit, 100) response = await self.v4PrivatePostOrders(self.extend(request, params)) # # [ # { # "orderId": 3686033640, # "clientOrderId": "customId11", # "market": "BTC_USDT", # "side": "buy", # "type": "limit", # "timestamp": 1594605801.49815, # current timestamp of unexecuted order # "dealMoney": "0", # executed amount in money # "dealStock": "0", # executed amount in stock # "amount": "2.241379", # active order amount # "takerFee": "0.001", # "makerFee": "0.001", # "left": "2.241379", # unexecuted amount in stock # "dealFee": "0", # executed fee by deal # "price": "40000" # }, # ] # return self.parse_orders(response, market, since, limit, {'status': 'open'}) async def fetch_closed_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]: """ fetches information on multiple closed orders made by the user https://docs.whitebit.com/private/http-trade-v4/#query-executed-orders :param str symbol: unified market symbol of the market orders were made in :param int [since]: the earliest time in ms to fetch orders for :param int [limit]: the maximum number of order structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns Order[]: a list of `order structures ` """ await self.load_markets() request: dict = {} market = None if symbol is not None: market = self.market(symbol) symbol = market['symbol'] request['market'] = market['id'] if limit is not None: request['limit'] = min(limit, 100) # default 50 max 100 response = await self.v4PrivatePostTradeAccountOrderHistory(self.extend(request, params)) # # { # "BTC_USDT": [ # { # "id": 160305483, # "clientOrderId": "customId11", # "time": 1594667731.724403, # "side": "sell", # "role": 2, # 1 = maker, 2 = taker # "amount": "0.000076", # "price": "9264.21", # "deal": "0.70407996", # "fee": "0.00070407996" # }, # ], # } # marketIds = list(response.keys()) results = [] for i in range(0, len(marketIds)): marketId = marketIds[i] marketNew = self.safe_market(marketId, None, '_') orders = response[marketId] for j in range(0, len(orders)): order = self.parse_order(orders[j], marketNew) results.append(self.extend(order, {'status': 'closed'})) results = self.sort_by(results, 'timestamp') results = self.filter_by_symbol_since_limit(results, symbol, since, limit) return results def parse_order_type(self, type: Str): types: dict = { 'limit': 'limit', 'market': 'market', 'stop market': 'market', 'stop limit': 'limit', 'stock market': 'market', 'margin limit': 'limit', 'margin market': 'market', } return self.safe_string(types, type, type) def parse_order(self, order: dict, market: Market = None) -> Order: # # createOrder, fetchOpenOrders, cancelOrder # # { # "orderId":105687928629, # "clientOrderId":"", # "market":"DOGE_USDT", # "side":"sell", # "type":"stop market", # "timestamp":1659091079.729576, # "dealMoney":"0", # executed amount in quote # "dealStock":"0", # base filled amount # "amount":"100", # "takerFee":"0.001", # "makerFee":"0", # "left":"100", # "price": "40000", # price if price isset # "dealFee":"0", # "activation_price":"0.065" # stop price(if stop limit or stop market) # } # # fetchClosedOrders # # { # "id":105531094719, # "clientOrderId":"", # "ctime":1659045334.550127, # "ftime":1659045334.550127, # "side":"buy", # "amount":"5.9940059", # cost in terms of quote for regular market orders, amount in terms or base for all other order types # "price":"0", # "type":"market", # "takerFee":"0.001", # "makerFee":"0", # "dealFee":"0.0059375815", # "dealStock":"85", # base filled amount # "dealMoney":"5.9375815", # executed amount in quote # } # marketId = self.safe_string(order, 'market') market = self.safe_market(marketId, market, '_') symbol = market['symbol'] side = self.safe_string(order, 'side') filled = self.safe_string(order, 'dealStock') remaining = self.safe_string(order, 'left') clientOrderId = self.safe_string(order, 'clientOrderId') if clientOrderId == '': clientOrderId = None price = self.safe_string(order, 'price') triggerPrice = self.safe_number(order, 'activation_price') orderId = self.safe_string_2(order, 'orderId', 'id') type = self.safe_string(order, 'type') orderType = self.parse_order_type(type) if orderType == 'market': remaining = None amount = self.safe_string(order, 'amount') cost = self.safe_string(order, 'dealMoney') if (side == 'buy') and ((type == 'market') or (type == 'stop market')): amount = filled dealFee = self.safe_string(order, 'dealFee') fee = None if dealFee is not None: fee = { 'cost': self.parse_number(dealFee), 'currency': market['quote'], } timestamp = self.safe_timestamp_2(order, 'ctime', 'timestamp') lastTradeTimestamp = self.safe_timestamp(order, 'ftime') return self.safe_order({ 'info': order, 'id': orderId, 'symbol': symbol, 'clientOrderId': clientOrderId, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'lastTradeTimestamp': lastTradeTimestamp, 'timeInForce': None, 'postOnly': None, 'status': None, 'side': side, 'price': price, 'type': orderType, 'triggerPrice': triggerPrice, 'amount': amount, 'filled': filled, 'remaining': remaining, 'average': None, 'cost': cost, 'fee': fee, 'trades': None, }, market) async def fetch_order_trades(self, id: str, symbol: Str = None, since: Int = None, limit: Int = None, params={}): """ fetch all the trades made from a single order https://docs.whitebit.com/private/http-trade-v4/#query-executed-order-deals :param str id: order id :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch trades for :param int [limit]: the maximum number of trades to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `trade structures ` """ await self.load_markets() request: dict = { 'orderId': int(id), } market = None if symbol is not None: market = self.market(symbol) request['market'] = market['id'] if limit is not None: request['limit'] = min(limit, 100) response = await self.v4PrivatePostTradeAccountOrder(self.extend(request, params)) # # { # "records": [ # { # "time": 1593342324.613711, # "fee": "0.00000419198", # "price": "0.00000701", # "amount": "598", # "id": 149156519, # trade id # "dealOrderId": 3134995325, # orderId # "clientOrderId": "customId11", # empty string if not specified # "role": 2, # 1 = maker, 2 = taker # "deal": "0.00419198" # } # ], # "offset": 0, # "limit": 100 # } # data = self.safe_list(response, 'records', []) return self.parse_trades(data, market) async def fetch_deposit_address(self, code: str, params={}) -> DepositAddress: """ fetch the deposit address for a currency associated with self account https://docs.whitebit.com/private/http-main-v4/#get-fiat-deposit-address https://docs.whitebit.com/private/http-main-v4/#get-cryptocurrency-deposit-address :param str code: unified currency code :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `address structure ` """ await self.load_markets() currency = self.currency(code) request: dict = { 'ticker': currency['id'], } response = None if self.is_fiat(code): provider = self.safe_string(params, 'provider') if provider is None: raise ArgumentsRequired(self.id + ' fetchDepositAddress() requires a provider when the ticker is fiat') request['provider'] = provider amount = self.safe_number(params, 'amount') if amount is None: raise ArgumentsRequired(self.id + ' fetchDepositAddress() requires an amount when the ticker is fiat') request['amount'] = amount uniqueId = self.safe_value(params, 'uniqueId') if uniqueId is None: raise ArgumentsRequired(self.id + ' fetchDepositAddress() requires an uniqueId when the ticker is fiat') response = await self.v4PrivatePostMainAccountFiatDepositUrl(self.extend(request, params)) else: response = await self.v4PrivatePostMainAccountAddress(self.extend(request, params)) # # fiat # # { # "url": "https://someaddress.com" # } # # crypto # # { # "account": { # "address": "GDTSOI56XNVAKJNJBLJGRNZIVOCIZJRBIDKTWSCYEYNFAZEMBLN75RMN", # "memo": "48565488244493" # }, # "required": { # "fixedFee": "0", # "flexFee": { # "maxFee": "0", # "minFee": "0", # "percent": "0" # }, # "maxAmount": "0", # "minAmount": "1" # } # } # url = self.safe_string(response, 'url') account = self.safe_value(response, 'account', {}) address = self.safe_string(account, 'address', url) tag = self.safe_string(account, 'memo') self.check_address(address) return { 'info': response, 'currency': code, 'network': None, 'address': address, 'tag': tag, } async def create_deposit_address(self, code: str, params={}) -> DepositAddress: """ create a currency deposit address https://docs.whitebit.com/private/http-main-v4/#create-new-address-for-deposit :param str code: unified currency code of the currency for the deposit address :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.network]: the blockchain network to create a deposit address on :param str [params.type]: address type, available for specific currencies :returns dict: an `address structure ` """ await self.load_markets() currency = self.currency(code) request: dict = { 'ticker': currency['id'], } response = await self.v4PrivatePostMainAccountCreateNewAddress(self.extend(request, params)) # # { # "account": { # "address": "GDTSOI56XNVAKJNJBLJGRNZIVOCIZJRBIDKTWSCYEYNFAZEMBLN75RMN", # "memo": "48565488244493" # }, # "required": { # "maxAmount": "0", # "minAmount": "1", # "fixedFee": "0", # "flexFee": { # "maxFee": "0", # "minFee": "0", # "percent": "0" # } # } # } # data = self.safe_dict(response, 'account', {}) return self.parse_deposit_address(data, currency) def parse_deposit_address(self, depositAddress, currency: Currency = None) -> DepositAddress: # # { # "address": "GDTSOI56XNVAKJNJBLJGRNZIVOCIZJRBIDKTWSCYEYNFAZEMBLN75RMN", # "memo": "48565488244493" # }, # return { 'info': depositAddress, 'currency': self.safe_currency_code(None, currency), 'network': None, 'address': self.safe_string(depositAddress, 'address'), 'tag': self.safe_string(depositAddress, 'memo'), } async def set_leverage(self, leverage: Int, symbol: Str = None, params={}): """ set the level of leverage for a market https://docs.whitebit.com/private/http-trade-v4/#change-collateral-account-leverage :param float leverage: the rate of leverage :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: response from the exchange """ await self.load_markets() if symbol is not None: raise NotSupported(self.id + ' setLeverage() does not allow to set per symbol') if (leverage < 1) or (leverage > 20): raise BadRequest(self.id + ' setLeverage() leverage should be between 1 and 20') request: dict = { 'leverage': leverage, } return await self.v4PrivatePostCollateralAccountLeverage(self.extend(request, params)) # { # "leverage": 5 # } async def transfer(self, code: str, amount: float, fromAccount: str, toAccount: str, params={}) -> TransferEntry: """ transfer currency internally between wallets on the same account https://docs.whitebit.com/private/http-main-v4/#transfer-between-main-and-trade-balances :param str code: unified currency code :param float amount: amount to transfer :param str fromAccount: account to transfer from - main, spot, collateral :param str toAccount: account to transfer to - main, spot, collateral :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transfer structure ` """ await self.load_markets() currency = self.currency(code) accountsByType = self.safe_value(self.options, 'accountsByType') fromAccountId = self.safe_string(accountsByType, fromAccount, fromAccount) toAccountId = self.safe_string(accountsByType, toAccount, toAccount) amountString = self.currency_to_precision(code, amount) request: dict = { 'ticker': currency['id'], 'amount': amountString, 'from': fromAccountId, 'to': toAccountId, } response = await self.v4PrivatePostMainAccountTransfer(self.extend(request, params)) # # [] # return self.parse_transfer(response, currency) def parse_transfer(self, transfer: dict, currency: Currency = None) -> TransferEntry: # # [] # return { 'info': transfer, 'id': None, 'timestamp': None, 'datetime': None, 'currency': self.safe_currency_code(None, currency), 'amount': None, 'fromAccount': None, 'toAccount': None, 'status': None, } async def withdraw(self, code: str, amount: float, address: str, tag=None, params={}) -> Transaction: """ make a withdrawal https://docs.whitebit.com/private/http-main-v4/#create-withdraw-request :param str code: unified currency code :param float amount: the amount to withdraw :param str address: the address to withdraw to :param str tag: :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transaction structure ` """ await self.load_markets() currency = self.currency(code) # check if it has canDeposit request: dict = { 'ticker': currency['id'], 'amount': self.currency_to_precision(code, amount), 'address': address, } uniqueId = self.safe_value(params, 'uniqueId') if uniqueId is None: uniqueId = self.uuid22() request['uniqueId'] = uniqueId if tag is not None: request['memo'] = tag if self.is_fiat(code): provider = self.safe_value(params, 'provider') if provider is None: raise ArgumentsRequired(self.id + ' withdraw() requires a provider when the ticker is fiat') request['provider'] = provider response = await self.v4PrivatePostMainAccountWithdraw(self.extend(request, params)) # # empty array with a success status # go to deposit/withdraw history and check you request status by uniqueId # # [] # return self.extend({'id': uniqueId}, self.parse_transaction(response, currency)) def parse_transaction(self, transaction: dict, currency: Currency = None) -> Transaction: # # { # "address": "3ApEASLcrQtZpg1TsssFgYF5V5YQJAKvuE", # deposit address # "uniqueId": null, # unique Id of deposit # "transactionId": "a6d71d69-2b17-4ad8-8b15-2d686c54a1a5", # "createdAt": 1593437922, # timestamp of deposit # "currency": "Bitcoin", # deposit currency # "ticker": "BTC", # deposit currency ticker # "method": 1, # called method 1 - deposit, 2 - withdraw # "amount": "0.0006", # amount of deposit # "description": "", # deposit description # "memo": "", # deposit memo # "fee": "0", # deposit fee # "status": 15, # transactions status # "network": null, # if currency is multinetwork # "transactionHash": "a275a514013e4e0f927fd0d1bed215e7f6f2c4c6ce762836fe135ec22529d886", # deposit transaction hash # "details": { # "partial": { # details about partially successful withdrawals # "requestAmount": "50000", # requested withdrawal amount # "processedAmount": "39000", # processed withdrawal amount # "processedFee": "273", # fee for processed withdrawal amount # "normalizeTransaction": "" # deposit id # } # }, # "confirmations": { # if transaction status == 15 you can see self object # "actual": 1, # current block confirmations # "required": 2 # required block confirmation for successful deposit # } # "centralized": False, # } # currency = self.safe_currency(None, currency) address = self.safe_string(transaction, 'address') timestamp = self.safe_timestamp(transaction, 'createdAt') currencyId = self.safe_string(transaction, 'ticker') status = self.safe_string(transaction, 'status') method = self.safe_string(transaction, 'method') return { 'id': self.safe_string(transaction, 'uniqueId'), 'txid': self.safe_string(transaction, 'transactionId'), 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'network': self.safe_string(transaction, 'network'), 'addressFrom': address if (method == '1') else None, 'address': address, 'addressTo': address if (method == '2') else None, 'amount': self.safe_number(transaction, 'amount'), 'type': 'deposit' if (method == '1') else 'withdrawal', 'currency': self.safe_currency_code(currencyId, currency), 'status': self.parse_transaction_status(status), 'updated': None, 'tagFrom': None, 'tag': None, 'tagTo': None, 'comment': self.safe_string(transaction, 'description'), 'internal': None, 'fee': { 'cost': self.safe_number(transaction, 'fee'), 'currency': self.safe_currency_code(currencyId, currency), }, 'info': transaction, } def parse_transaction_status(self, status: Str): statuses: dict = { '1': 'pending', '2': 'pending', '3': 'ok', '4': 'canceled', '5': 'pending', '6': 'pending', '7': 'ok', '9': 'canceled', '10': 'pending', '11': 'pending', '12': 'pending', '13': 'pending', '14': 'pending', '15': 'pending', '16': 'pending', '17': 'pending', } return self.safe_string(statuses, status, status) async def fetch_deposit(self, id: str, code: Str = None, params={}): """ fetch information on a deposit https://docs.whitebit.com/private/http-main-v4/#get-depositwithdraw-history :param str id: deposit id :param str code: not used by whitebit fetchDeposit() :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transaction structure ` """ await self.load_markets() currency = None request: dict = { 'transactionMethod': 1, 'uniqueId': id, 'limit': 1, 'offset': 0, } if code is not None: currency = self.currency(code) request['ticker'] = currency['id'] response = await self.v4PrivatePostMainAccountHistory(self.extend(request, params)) # # { # "limit": 100, # "offset": 0, # "records": [ # { # "address": "3ApEASLcrQtZpg1TsssFgYF5V5YQJAKvuE", # deposit address # "uniqueId": null, # unique Id of deposit # "createdAt": 1593437922, # timestamp of deposit # "currency": "Bitcoin", # deposit currency # "ticker": "BTC", # deposit currency ticker # "method": 1, # called method 1 - deposit, 2 - withdraw # "amount": "0.0006", # amount of deposit # "description": "", # deposit description # "memo": "", # deposit memo # "fee": "0", # deposit fee # "status": 15, # transactions status # "network": null, # if currency is multinetwork # "transactionHash": "a275a514013e4e0f927fd0d1bed215e7f6f2c4c6ce762836fe135ec22529d886", # deposit transaction hash # "details": { # "partial": { # details about partially successful withdrawals # "requestAmount": "50000", # requested withdrawal amount # "processedAmount": "39000", # processed withdrawal amount # "processedFee": "273", # fee for processed withdrawal amount # "normalizeTransaction": "" # deposit id # } # }, # "confirmations": { # if transaction status == 15 you can see self object # "actual": 1, # current block confirmations # "required": 2 # required block confirmation for successful deposit # } # }, # {...}, # ], # "total": 300 # total number of transactions, use self for calculating ‘limit’ and ‘offset' # } # records = self.safe_value(response, 'records', []) first = self.safe_dict(records, 0, {}) return self.parse_transaction(first, currency) async def fetch_deposits(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Transaction]: """ fetch all deposits made to an account https://docs.whitebit.com/private/http-main-v4/#get-depositwithdraw-history :param str code: unified currency code :param int [since]: the earliest time in ms to fetch deposits for :param int [limit]: the maximum number of deposits structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `transaction structures ` """ await self.load_markets() currency = None request: dict = { 'transactionMethod': 1, 'limit': 100, 'offset': 0, } if code is not None: currency = self.currency(code) request['ticker'] = currency['id'] if limit is not None: request['limit'] = min(limit, 100) response = await self.v4PrivatePostMainAccountHistory(self.extend(request, params)) # # { # "limit": 100, # "offset": 0, # "records": [ # { # "address": "3ApEASLcrQtZpg1TsssFgYF5V5YQJAKvuE", # deposit address # "uniqueId": null, # unique Id of deposit # "createdAt": 1593437922, # timestamp of deposit # "currency": "Bitcoin", # deposit currency # "ticker": "BTC", # deposit currency ticker # "method": 1, # called method 1 - deposit, 2 - withdraw # "amount": "0.0006", # amount of deposit # "description": "", # deposit description # "memo": "", # deposit memo # "fee": "0", # deposit fee # "status": 15, # transactions status # "network": null, # if currency is multinetwork # "transactionHash": "a275a514013e4e0f927fd0d1bed215e7f6f2c4c6ce762836fe135ec22529d886", # deposit transaction hash # "details": { # "partial": { # details about partially successful withdrawals # "requestAmount": "50000", # requested withdrawal amount # "processedAmount": "39000", # processed withdrawal amount # "processedFee": "273", # fee for processed withdrawal amount # "normalizeTransaction": "" # deposit id # } # }, # "confirmations": { # if transaction status == 15 you can see self object # "actual": 1, # current block confirmations # "required": 2 # required block confirmation for successful deposit # } # }, # {...}, # ], # "total": 300 # total number of transactions, use self for calculating ‘limit’ and ‘offset' # } # records = self.safe_list(response, 'records', []) return self.parse_transactions(records, currency, since, limit) async def fetch_borrow_interest(self, code: Str = None, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[BorrowInterest]: """ fetch the interest owed by the user for borrowing currency for margin trading https://docs.whitebit.com/private/http-trade-v4/#open-positions :param str code: unified currency code :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch borrrow interest for :param int [limit]: the maximum number of structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `borrow interest structures ` """ await self.load_markets() request: dict = {} market = None if symbol is not None: market = self.market(symbol) request['market'] = market['id'] response = await self.v4PrivatePostCollateralAccountPositionsOpen(self.extend(request, params)) # # [ # { # "positionId": 191823, # "market": "BTC_USDT", # "openDate": 1660340344.027163, # "modifyDate": 1660340344.027163, # "amount": "0.003075", # "basePrice": "24149.24512", # "liquidationPrice": "7059.02", # "leverage": "5", # "pnl": "-0.15", # "pnlPercent": "-0.20", # "margin": "14.86", # "freeMargin": "44.99", # "funding": "0", # "unrealizedFunding": "0.0000307828284903", # "liquidationState": null # } # ] # interest = self.parse_borrow_interests(response, market) return self.filter_by_currency_since_limit(interest, code, since, limit) def parse_borrow_interest(self, info: dict, market: Market = None) -> BorrowInterest: # # { # "positionId": 191823, # "market": "BTC_USDT", # "openDate": 1660340344.027163, # "modifyDate": 1660340344.027163, # "amount": "0.003075", # "basePrice": "24149.24512", # "liquidationPrice": "7059.02", # "leverage": "5", # "pnl": "-0.15", # "pnlPercent": "-0.20", # "margin": "14.86", # "freeMargin": "44.99", # "funding": "0", # "unrealizedFunding": "0.0000307828284903", # "liquidationState": null # } # marketId = self.safe_string(info, 'market') symbol = self.safe_symbol(marketId, market, '_') timestamp = self.safe_timestamp(info, 'modifyDate') return { 'info': info, 'symbol': symbol, 'currency': 'USDT', 'interest': self.safe_number(info, 'unrealizedFunding'), 'interestRate': 0.00098, # https://whitebit.com/fees 'amountBorrowed': self.safe_number(info, 'amount'), 'marginMode': 'cross', 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), } async def fetch_funding_rate(self, symbol: str, params={}) -> FundingRate: """ fetch the current funding rate https://docs.whitebit.com/public/http-v4/#available-futures-markets-list :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `funding rate structure ` """ await self.load_markets() symbol = self.symbol(symbol) response = await self.fetch_funding_rates([symbol], params) return self.safe_value(response, symbol) async def fetch_funding_rates(self, symbols: Strings = None, params={}) -> FundingRates: """ fetch the funding rate for multiple markets https://docs.whitebit.com/public/http-v4/#available-futures-markets-list :param str[]|None symbols: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `funding rate structures `, indexed by market symbols """ await self.load_markets() symbols = self.market_symbols(symbols) response = await self.v4PublicGetFutures(params) # # [ # { # "name": "BTC_USDT", # "type": "direct", # "quanto_multiplier": "0.0001", # "ref_discount_rate": "0", # "order_price_deviate": "0.5", # "maintenance_rate": "0.005", # "mark_type": "index", # "last_price": "38026", # "mark_price": "37985.6", # "index_price": "37954.92", # "funding_rate_indicative": "0.000219", # "mark_price_round": "0.01", # "funding_offset": 0, # "in_delisting": False, # "risk_limit_base": "1000000", # "interest_rate": "0.0003", # "order_price_round": "0.1", # "order_size_min": 1, # "ref_rebate_rate": "0.2", # "funding_interval": 28800, # "risk_limit_step": "1000000", # "leverage_min": "1", # "leverage_max": "100", # "risk_limit_max": "8000000", # "maker_fee_rate": "-0.00025", # "taker_fee_rate": "0.00075", # "funding_rate": "0.002053", # "order_size_max": 1000000, # "funding_next_apply": 1610035200, # "short_users": 977, # "config_change_time": 1609899548, # "trade_size": 28530850594, # "position_size": 5223816, # "long_users": 455, # "funding_impact_value": "60000", # "orders_limit": 50, # "trade_id": 10851092, # "orderbook_id": 2129638396 # } # ] # data = self.safe_list(response, 'result', []) return self.parse_funding_rates(data, symbols) def parse_funding_rate(self, contract, market: Market = None) -> FundingRate: # # { # "ticker_id":"ADA_PERP", # "stock_currency":"ADA", # "money_currency":"USDT", # "last_price":"0.296708", # "stock_volume":"7982130", # "money_volume":"2345758.29189", # "bid":"0.296608", # "ask":"0.296758", # "high":"0.298338", # "low":"0.290171", # "product_type":"Perpetual", # "open_interest":"46533000", # "index_price":"0.29659", # "index_name":"Cardano", # "index_currency":"ADA", # "funding_rate":"0.0001", # "next_funding_rate_timestamp":"1691193600000", # "brackets":{ # "1":"0", # "2":"0", # "3":"0", # "5":"0", # "10":"0", # "20":"0", # "50":"-10000", # "100":"-5000" # }, # "max_leverage":"100" # } # marketId = self.safe_string(contract, 'ticker_id') symbol = self.safe_symbol(marketId, market) markPrice = self.safe_number(contract, 'markPrice') indexPrice = self.safe_number(contract, 'indexPrice') interestRate = self.safe_number(contract, 'interestRate') fundingRate = self.safe_number(contract, 'funding_rate') fundingTime = self.safe_integer(contract, 'next_funding_rate_timestamp') return { 'info': contract, 'symbol': symbol, 'markPrice': markPrice, 'indexPrice': indexPrice, 'interestRate': interestRate, 'timestamp': None, 'datetime': None, 'fundingRate': fundingRate, 'fundingTimestamp': fundingTime, 'fundingDatetime': self.iso8601(fundingTime), 'nextFundingRate': None, 'nextFundingTimestamp': None, 'nextFundingDatetime': None, 'previousFundingRate': None, 'previousFundingTimestamp': None, 'previousFundingDatetime': None, 'interval': None, } async def fetch_funding_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[FundingHistory]: """ fetch the history of funding payments paid and received on self account https://docs.whitebit.com/private/http-trade-v4/#funding-history :param str [symbol]: unified market symbol :param int [since]: the starting timestamp in milliseconds :param int [limit]: the number of entries to return :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: the latest time in ms to fetch funding history for :returns dict[]: a list of `funding history structures ` """ await self.load_markets() if symbol is None: raise ArgumentsRequired(self.id + ' fetchFundingHistory() requires a symbol argument') market = self.market(symbol) request: dict = { 'market': market['id'], } if since is not None: request['startDate'] = since if limit is not None: request['limit'] = since request, params = self.handle_until_option('endDate', request, params) response = await self.v4PrivatePostCollateralAccountFundingHistory(request) # # { # "records": [ # { # "market": "BTC_PERP", # "fundingTime": "1708704000000", # "fundingRate": "0.00017674", # "fundingAmount": "-0.171053531892", # "positionAmount": "0.019", # "settlementPrice": "50938.2", # "rateCalculatedTime": "1708675200000" # }, # ], # "limit": 100, # "offset": 0 # } # data = self.safe_list(response, 'records', []) return self.parse_funding_histories(data, market, since, limit) def parse_funding_history(self, contract, market: Market = None): # # { # "market": "BTC_PERP", # "fundingTime": "1708704000000", # "fundingRate": "0.00017674", # "fundingAmount": "-0.171053531892", # "positionAmount": "0.019", # "settlementPrice": "50938.2", # "rateCalculatedTime": "1708675200000" # } # marketId = self.safe_string(contract, 'market') timestamp = self.safe_integer(contract, 'fundingTime') return { 'info': contract, 'symbol': self.safe_symbol(marketId, market, None, 'swap'), 'code': None, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'id': None, 'amount': self.safe_number(contract, 'fundingAmount'), } def parse_funding_histories(self, contracts, market=None, since: Int = None, limit: Int = None) -> List[FundingHistory]: result = [] for i in range(0, len(contracts)): contract = contracts[i] result.append(self.parse_funding_history(contract, market)) sorted = self.sort_by(result, 'timestamp') return self.filter_by_since_limit(sorted, since, limit) async def fetch_deposits_withdrawals(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Transaction]: """ fetch history of deposits and withdrawals https://github.com/whitebit-exchange/api-docs/blob/main/pages/private/http-main-v4.md#get-depositwithdraw-history :param str [code]: unified currency code for the currency of the deposit/withdrawals, default is None :param int [since]: timestamp in ms of the earliest deposit/withdrawal, default is None :param int [limit]: max number of deposit/withdrawals to return, default = 50, Min: 1, Max: 100 :param dict [params]: extra parameters specific to the exchange API endpoint EXCHANGE SPECIFIC PARAMETERS :param number [params.transactionMethod]: Method. Example: 1 to display deposits / 2 to display withdraws. Do not send self parameter in order to receive both deposits and withdraws. :param str [params.address]: Can be used for filtering transactions by specific address or memo. :param str[] [params.addresses]: Can be used for filtering transactions by specific addresses or memos(max: 20). :param str [params.uniqueId]: Can be used for filtering transactions by specific unique id :param int [params.offset]: If you want the request to return entries starting from a particular line, you can use OFFSET clause to tell it where it should start. Default: 0, Min: 0, Max: 10000 :param str[] [params.status]: Can be used for filtering transactions by status codes. Caution: You must use self parameter with appropriate transactionMethod and use valid status codes for self method. You can find them below. Example: "status": [3,7] :returns dict: a list of `transaction structure ` """ await self.load_markets() request: dict = {} currency = None if code is not None: currency = self.currency(code) request['ticker'] = currency['id'] if limit is not None: request['limit'] = limit # default 1000 response = await self.v4PrivatePostMainAccountHistory(self.extend(request, params)) # # { # "limit": 100, # "offset": 0, # "records": [ # { # "address": "3ApEASLcrQtZpg1TsssFgYF5V5YQJAKvuE", # deposit address # "uniqueId": null, # unique Id of deposit # "createdAt": 1593437922, # timestamp of deposit # "currency": "Bitcoin", # deposit currency # "ticker": "BTC", # deposit currency ticker # "method": 1, # called method 1 - deposit, 2 - withdraw # "amount": "0.0006", # amount of deposit # "description": "", # deposit description # "memo": "", # deposit memo # "fee": "0", # deposit fee # "status": 15, # transactions status # "network": null, # if currency is multinetwork # "transactionHash": "a275a514013e4e0f927fd0d1bed215e7f6f2c4c6ce762836fe135ec22529d886", # deposit transaction hash # "transactionId": "5e112b38-9652-11ed-a1eb-0242ac120002", # transaction id # "details": { # "partial": { # details about partially successful withdrawals # "requestAmount": "50000", # requested withdrawal amount # "processedAmount": "39000", # processed withdrawal amount # "processedFee": "273", # fee for processed withdrawal amount # "normalizeTransaction": "" # deposit id # } # }, # "confirmations": { # if transaction status == 15(Pending) you can see self object # "actual": 1, # current block confirmations # "required": 2 # required block confirmation for successful deposit # } # }, # {...}, # ], # "total": 300 # total number of transactions, use self for calculating ‘limit’ and ‘offset' # } # records = self.safe_list(response, 'records') return self.parse_transactions(records, currency, since, limit) async def fetch_convert_quote(self, fromCode: str, toCode: str, amount: Num = None, params={}) -> Conversion: """ fetch a quote for converting from one currency to another https://docs.whitebit.com/private/http-trade-v4/#convert-estimate :param str fromCode: the currency that you want to sell and convert from :param str toCode: the currency that you want to buy and convert into :param float amount: how much you want to trade in units of the from currency :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `conversion structure ` """ await self.load_markets() fromCurrency = self.currency(fromCode) toCurrency = self.currency(toCode) request: dict = { 'from': fromCode, 'to': toCode, 'amount': self.number_to_string(amount), 'direction': 'from', } response = await self.v4PrivatePostConvertEstimate(self.extend(request, params)) # # { # "give": "4", # "receive": "0.00004762", # "rate": "0.0000119", # "id": "1740889", # "expireAt": 1741090147, # "from": "USDT", # "to": "BTC" # } # return self.parse_conversion(response, fromCurrency, toCurrency) async def create_convert_trade(self, id: str, fromCode: str, toCode: str, amount: Num = None, params={}) -> Conversion: """ convert from one currency to another https://docs.whitebit.com/private/http-trade-v4/#convert-confirm :param str id: the id of the trade that you want to make :param str fromCode: the currency that you want to sell and convert from :param str toCode: the currency that you want to buy and convert into :param float [amount]: how much you want to trade in units of the from currency :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `conversion structure ` """ await self.load_markets() fromCurrency = self.currency(fromCode) toCurrency = self.currency(toCode) request: dict = { 'quoteId': id, } response = await self.v4PrivatePostConvertConfirm(self.extend(request, params)) # # { # "finalGive": "4", # "finalReceive": "0.00004772" # } # return self.parse_conversion(response, fromCurrency, toCurrency) async def fetch_convert_trade_history(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Conversion]: """ fetch the users history of conversion trades https://docs.whitebit.com/private/http-trade-v4/#convert-history :param str [code]: the unified currency code :param int [since]: the earliest time in ms to fetch conversions for :param int [limit]: the maximum number of conversion structures to retrieve, default 20, max 200 :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.until]: the end time in ms :param str [params.fromTicker]: the currency that you sold and converted from :param str [params.toTicker]: the currency that you bought and converted into :param str [params.quoteId]: the quote id of the conversion :returns dict[]: a list of `conversion structures ` """ await self.load_markets() request: dict = {} if code is not None: request['fromTicker'] = code if since is not None: start = self.parse_to_int(since / 1000) request['from'] = self.number_to_string(start) if limit is not None: request['limit'] = limit request, params = self.handle_until_option('to', request, params, 0.001) response = await self.v4PrivatePostConvertHistory(self.extend(request, params)) # # { # "records": [ # { # "id": "1741105", # "path": [ # { # "from": "USDT", # "to": "BTC", # "rate": "0.00001193" # } # ], # "date": 1741090757, # "give": "4", # "receive": "0.00004772", # "rate": "0.00001193" # } # ], # "total": 1, # "limit": 100, # "offset": 0 # } # rows = self.safe_list(response, 'records', []) return self.parse_conversions(rows, code, 'fromCurrency', 'toCurrency', since, limit) def parse_conversion(self, conversion: dict, fromCurrency: Currency = None, toCurrency: Currency = None) -> Conversion: # # fetchConvertQuote # # { # "give": "4", # "receive": "0.00004762", # "rate": "0.0000119", # "id": "1740889", # "expireAt": 1741090147, # "from": "USDT", # "to": "BTC" # } # # createConvertTrade # # { # "finalGive": "4", # "finalReceive": "0.00004772" # } # # fetchConvertTradeHistory # # { # "id": "1741105", # "path": [ # { # "from": "USDT", # "to": "BTC", # "rate": "0.00001193" # } # ], # "date": 1741090757, # "give": "4", # "receive": "0.00004772", # "rate": "0.00001193" # } # path = self.safe_list(conversion, 'path', []) first = self.safe_dict(path, 0, {}) fromPath = self.safe_string(first, 'from') toPath = self.safe_string(first, 'to') timestamp = self.safe_timestamp_2(conversion, 'date', 'expireAt') fromCoin = self.safe_string(conversion, 'from', fromPath) fromCode = self.safe_currency_code(fromCoin, fromCurrency) toCoin = self.safe_string(conversion, 'to', toPath) toCode = self.safe_currency_code(toCoin, toCurrency) return { 'info': conversion, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'id': self.safe_string(conversion, 'id'), 'fromCurrency': fromCode, 'fromAmount': self.safe_number_2(conversion, 'give', 'finalGive'), 'toCurrency': toCode, 'toAmount': self.safe_number_2(conversion, 'receive', 'finalReceive'), 'price': self.safe_number(conversion, 'rate'), 'fee': None, } async def fetch_position_history(self, symbol: str, since: Int = None, limit: Int = None, params={}) -> List[Position]: """ fetches historical positions https://docs.whitebit.com/private/http-trade-v4/#positions-history :param str symbol: unified contract symbol :param int [since]: the earliest time in ms to fetch positions for :param int [limit]: the maximum amount of records to fetch :param dict [params]: extra parameters specific to the exchange api endpoint :param int [params.positionId]: the id of the requested position :returns dict[]: a list of `position structures ` """ await self.load_markets() market = self.market(symbol) request: dict = { 'market': market['id'], } if since is not None: request['startDate'] = since if limit is not None: request['limit'] = since request, params = self.handle_until_option('endDate', request, params) response = await self.v4PrivatePostCollateralAccountPositionsHistory(self.extend(request, params)) # # [ # { # "positionId": 479975679, # "market": "BTC_PERP", # "openDate": 1741941025.309887, # "modifyDate": 1741941025.309887, # "amount": "0.001", # "basePrice": "82498.7", # "realizedFunding": "0", # "liquidationPrice": "0", # "liquidationState": null, # "orderDetail": { # "id": 1224727949521, # "tradeAmount": "0.001", # "price": "82498.7", # "tradeFee": "0.028874545", # "fundingFee": "0", # "realizedPnl": "-0.028874545" # } # } # ] # positions = self.parse_positions(response) return self.filter_by_symbol_since_limit(positions, symbol, since, limit) async def fetch_positions(self, symbols: Strings = None, params={}) -> List[Position]: """ fetch all open positions https://docs.whitebit.com/private/http-trade-v4/#open-positions :param str[] [symbols]: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `position structures ` """ await self.load_markets() symbols = self.market_symbols(symbols) response = await self.v4PrivatePostCollateralAccountPositionsOpen(params) # # [ # { # "positionId": 479975679, # "market": "BTC_PERP", # "openDate": 1741941025.3098869, # "modifyDate": 1741941025.3098869, # "amount": "0.001", # "basePrice": "82498.7", # "liquidationPrice": "70177.2", # "pnl": "0", # "pnlPercent": "0.00", # "margin": "4.2", # "freeMargin": "9.9", # "funding": "0", # "unrealizedFunding": "0", # "liquidationState": null, # "tpsl": null # } # ] # return self.parse_positions(response, symbols) async def fetch_position(self, symbol: str, params={}) -> Position: """ fetch data on a single open contract trade position https://docs.whitebit.com/private/http-trade-v4/#open-positions :param str symbol: unified market symbol of the market the position is held in :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `position structure ` """ await self.load_markets() market = self.market(symbol) request: dict = { 'symbol': market['id'], } response = await self.v4PrivatePostCollateralAccountPositionsOpen(self.extend(request, params)) # # [ # { # "positionId": 479975679, # "market": "BTC_PERP", # "openDate": 1741941025.3098869, # "modifyDate": 1741941025.3098869, # "amount": "0.001", # "basePrice": "82498.7", # "liquidationPrice": "70177.2", # "pnl": "0", # "pnlPercent": "0.00", # "margin": "4.2", # "freeMargin": "9.9", # "funding": "0", # "unrealizedFunding": "0", # "liquidationState": null, # "tpsl": null # } # ] # data = self.safe_dict(response, 0, {}) return self.parse_position(data, market) def parse_position(self, position: dict, market: Market = None) -> Position: # # fetchPosition, fetchPositions # # { # "positionId": 479975679, # "market": "BTC_PERP", # "openDate": 1741941025.3098869, # "modifyDate": 1741941025.3098869, # "amount": "0.001", # "basePrice": "82498.7", # "liquidationPrice": "70177.2", # "pnl": "0", # "pnlPercent": "0.00", # "margin": "4.2", # "freeMargin": "9.9", # "funding": "0", # "unrealizedFunding": "0", # "liquidationState": null, # "tpsl": null # } # # fetchPositionHistory # # { # "positionId": 479975679, # "market": "BTC_PERP", # "openDate": 1741941025.309887, # "modifyDate": 1741941025.309887, # "amount": "0.001", # "basePrice": "82498.7", # "realizedFunding": "0", # "liquidationPrice": "0", # "liquidationState": null, # "orderDetail": { # "id": 1224727949521, # "tradeAmount": "0.001", # "price": "82498.7", # "tradeFee": "0.028874545", # "fundingFee": "0", # "realizedPnl": "-0.028874545" # } # } # marketId = self.safe_string(position, 'market') timestamp = self.safe_timestamp(position, 'openDate') tpsl = self.safe_dict(position, 'tpsl', {}) orderDetail = self.safe_dict(position, 'orderDetail', {}) return self.safe_position({ 'info': position, 'id': self.safe_string(position, 'positionId'), 'symbol': self.safe_symbol(marketId, market), 'notional': None, 'marginMode': None, 'liquidationPrice': self.safe_number(position, 'liquidationPrice'), 'entryPrice': self.safe_number(position, 'basePrice'), 'unrealizedPnl': self.safe_number(position, 'pnl'), 'realizedPnl': self.safe_number(orderDetail, 'realizedPnl'), 'percentage': self.safe_number(position, 'pnlPercent'), 'contracts': None, 'contractSize': None, 'markPrice': None, 'lastPrice': None, 'side': None, 'hedged': None, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'lastUpdateTimestamp': self.safe_timestamp(position, 'modifyDate'), 'maintenanceMargin': None, 'maintenanceMarginPercentage': None, 'collateral': self.safe_number(position, 'margin'), 'initialMargin': None, 'initialMarginPercentage': None, 'leverage': None, 'marginRatio': None, 'stopLossPrice': self.safe_number(tpsl, 'stopLoss'), 'takeProfitPrice': self.safe_number(tpsl, 'takeProfit'), }) async def fetch_cross_borrow_rate(self, code: str, params={}) -> CrossBorrowRate: """ fetch the rate of interest to borrow a currency for margin trading https://docs.whitebit.com/private/http-main-v4/#get-plans :param str code: unified currency code :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `borrow rate structure ` """ await self.load_markets() currency = self.currency(code) request: dict = { 'ticker': currency['id'], } response = await self.v4PrivatePostMainAccountSmartPlans(self.extend(request, params)) # # data = self.safe_list(response, 0, []) return self.parse_borrow_rate(data, currency) def parse_borrow_rate(self, info, currency: Currency = None): # # currencyId = self.safe_string(info, 'ticker') percent = self.safe_string(info, 'percent') return { 'currency': self.safe_currency_code(currencyId, currency), 'rate': self.parse_number(Precise.string_div(percent, '100')), 'period': self.safe_integer(info, 'duration'), 'timestamp': None, 'datetime': None, 'info': info, } def is_fiat(self, currency: str) -> bool: fiatCurrencies = self.safe_value(self.options, 'fiatCurrencies', []) return self.in_array(currency, fiatCurrencies) def nonce(self): return self.milliseconds() - self.options['timeDifference'] def sign(self, path, api='public', method='GET', params={}, headers=None, body=None): query = self.omit(params, self.extract_params(path)) version = self.safe_value(api, 0) accessibility = self.safe_value(api, 1) pathWithParams = '/' + self.implode_params(path, params) url = self.urls['api'][version][accessibility] + pathWithParams if accessibility == 'public': if query: url += '?' + self.urlencode(query) if accessibility == 'private': self.check_required_credentials() nonce = str(self.nonce()) secret = self.encode(self.secret) request = '/' + 'api' + '/' + version + pathWithParams body = self.json(self.extend({'request': request, 'nonce': nonce}, params)) payload = self.string_to_base64(body) signature = self.hmac(self.encode(payload), secret, hashlib.sha512) headers = { 'Content-Type': 'application/json', 'X-TXC-APIKEY': self.apiKey, 'X-TXC-PAYLOAD': payload, 'X-TXC-SIGNATURE': signature, } return {'url': url, 'method': method, 'body': body, 'headers': headers} def handle_errors(self, code: int, reason: str, url: str, method: str, headers: dict, body: str, response, requestHeaders, requestBody): if (code == 418) or (code == 429): raise DDoSProtection(self.id + ' ' + str(code) + ' ' + reason + ' ' + body) if code == 404: raise ExchangeError(self.id + ' ' + str(code) + ' endpoint not found') if response is not None: # For cases where we have a meaningful status # {"response":null,"status":422,"errors":{"orderId":["Finished order id 435453454535 not found on your account"]},"notification":null,"warning":"Finished order id 435453454535 not found on your account","_token":null} status = self.safe_string(response, 'status') errors = self.safe_value(response, 'errors') # {"code":10,"message":"Unauthorized request."} message = self.safe_string(response, 'message') # For these cases where we have a generic code variable error key # {"code":0,"message":"Validation failed","errors":{"amount":["Amount must be greater than 0"]}} codeNew = self.safe_integer(response, 'code') hasErrorStatus = status is not None and status != '200' and errors is not None if hasErrorStatus or codeNew is not None: feedback = self.id + ' ' + body errorInfo = message if hasErrorStatus: errorInfo = status else: errorObject = self.safe_dict(response, 'errors', {}) errorKeys = list(errorObject.keys()) errorsLength = len(errorKeys) if errorsLength > 0: errorKey = errorKeys[0] errorMessageArray = self.safe_value(errorObject, errorKey, []) errorMessageLength = len(errorMessageArray) errorInfo = errorMessageArray[0] if (errorMessageLength > 0) else body self.throw_exactly_matched_exception(self.exceptions['exact'], errorInfo, feedback) self.throw_broadly_matched_exception(self.exceptions['broad'], body, feedback) raise ExchangeError(feedback) return None