ccxt 4.2.76__py2.py3-none-any.whl → 4.4.48__py2.py3-none-any.whl

ccxt/async_support/ace.py

@@ -7,11 +7,11 @@ from ccxt.async_support.base.exchange import Exchange
 from ccxt.abstract.ace import ImplicitAPI
 from ccxt.base.types import Balances, Int, Market, Num, Order, OrderBook, OrderSide, OrderType, Str, Strings, Ticker, Tickers, Trade
 from typing import List
+from ccxt.base.errors import AuthenticationError
 from ccxt.base.errors import ArgumentsRequired
 from ccxt.base.errors import BadRequest
 from ccxt.base.errors import InsufficientFunds
 from ccxt.base.errors import InvalidOrder
-from ccxt.base.errors import AuthenticationError
 from ccxt.base.decimal_to_precision import TICK_SIZE
 from ccxt.base.precise import Precise
 
@@ -67,8 +67,13 @@ class ace(Exchange, ImplicitAPI):
                 'fetchOrderBook': True,
                 'fetchOrders': False,
                 'fetchOrderTrades': True,
+                'fetchPosition': False,
+                'fetchPositionHistory': False,
                 'fetchPositionMode': False,
                 'fetchPositions': False,
+                'fetchPositionsForSymbol': False,
+                'fetchPositionsHistory': False,
+                'fetchPositionsRisk': False,
                 'fetchPremiumIndexOHLCV': False,
                 'fetchTicker': True,
                 'fetchTickers': True,
@@ -103,7 +108,7 @@ class ace(Exchange, ImplicitAPI):
                 '1M': 31,
             },
             'urls': {
-                'logo': 'https://user-images.githubusercontent.com/1294454/216908003-fb314cf6-e66e-471c-b91d-1d86e4baaa90.jpg',
+                'logo': 'https://github.com/user-attachments/assets/115f1e4a-0fd0-4b76-85d5-a49ebf64d1c8',
                 'api': {
                     'public': 'https://ace.io/polarisex',
                     'private': 'https://ace.io/polarisex/open',
@@ -149,6 +154,64 @@ class ace(Exchange, ImplicitAPI):
             'options': {
                 'brokerId': 'ccxt',
             },
+            'features': {
+                'spot': {
+                    'sandbox': False,
+                    'createOrder': {
+                        'marginMode': False,
+                        'triggerPrice': False,
+                        'triggerPriceType': None,
+                        'triggerDirection': False,
+                        'stopLossPrice': False,
+                        'takeProfitPrice': False,
+                        'attachedStopLossTakeProfit': None,  # not supported
+                        'timeInForce': {
+                            'IOC': False,
+                            'FOK': False,
+                            'PO': False,
+                            'GTD': False,
+                        },
+                        'hedged': False,
+                        'leverage': False,
+                        'marketBuyRequiresPrice': False,
+                        'marketBuyByCost': False,
+                        'selfTradePrevention': False,
+                        'trailing': False,
+                        'iceberg': False,
+                    },
+                    'createOrders': None,
+                    'fetchMyTrades': {
+                        'marginMode': False,
+                        'limit': 500,
+                        'daysBack': None,
+                        'untilDays': None,
+                    },
+                    'fetchOrder': {
+                        'marginMode': False,
+                        'trigger': False,
+                        'trailing': False,
+                    },
+                    'fetchOpenOrders': {
+                        'marginMode': False,
+                        'limit': None,
+                        'trigger': False,
+                        'trailing': False,
+                    },
+                    'fetchOrders': None,
+                    'fetchClosedOrders': None,
+                    'fetchOHLCV': {
+                        'limit': 2000,
+                    },
+                },
+                'swap': {
+                    'linear': None,
+                    'inverse': None,
+                },
+                'future': {
+                    'linear': None,
+                    'inverse': None,
+                },
+            },
             'precisionMode': TICK_SIZE,
             'exceptions': {
                 'exact': {
@@ -173,10 +236,12 @@ class ace(Exchange, ImplicitAPI):
             },
         })
 
-    async def fetch_markets(self, params={}):
+    async def fetch_markets(self, params={}) -> List[Market]:
         """
         retrieves data on all markets for ace
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#oapi-api---market-pair
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#oapi-api---market-pair
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -197,11 +262,24 @@ class ace(Exchange, ImplicitAPI):
         #
         return self.parse_markets(response)
 
-    def parse_market(self, market) -> Market:
-        baseId = self.safe_string(market, 'base')
-        base = self.safe_currency_code(baseId)
-        quoteId = self.safe_string(market, 'quote')
-        quote = self.safe_currency_code(quoteId)
+    def parse_market(self, market: dict) -> Market:
+        #
+        #     {
+        #         "symbol": "ADA/TWD",
+        #         "base": "ADA",
+        #         "baseCurrencyId": "122",
+        #         "quote": "TWD",
+        #         "quoteCurrencyId": "1",
+        #         "basePrecision": "2",
+        #         "quotePrecision": "3",
+        #         "minLimitBaseAmount": "1.0",
+        #         "maxLimitBaseAmount": "150000.0"
+        #     }
+        #
+        baseId = self.safe_string(market, 'baseCurrencyId')
+        base = self.safe_currency_code(self.safe_string(market, 'base'))
+        quoteId = self.safe_string(market, 'quoteCurrencyId')
+        quote = self.safe_currency_code(self.safe_string(market, 'quote'))
         symbol = base + '/' + quote
         return {
             'id': self.safe_string(market, 'symbol'),
@@ -254,7 +332,7 @@ class ace(Exchange, ImplicitAPI):
             'info': market,
         }
 
-    def parse_ticker(self, ticker, market: Market = None) -> Ticker:
+    def parse_ticker(self, ticker: dict, market: Market = None) -> Ticker:
         #
         #     {
         #         "base_volume":229196.34035399999,
@@ -290,7 +368,9 @@ class ace(Exchange, ImplicitAPI):
     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
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#oapi-api---trade-data
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#oapi-api---trade-data
+
         :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 <https://docs.ccxt.com/#/?id=ticker-structure>`
@@ -299,7 +379,7 @@ class ace(Exchange, ImplicitAPI):
         market = self.market(symbol)
         response = await self.publicGetOapiV2ListTradePrice(params)
         marketId = market['id']
-        ticker = self.safe_value(response, marketId, {})
+        ticker = self.safe_dict(response, marketId, {})
         #
         #     {
         #         "BTC/USDT":{
@@ -314,7 +394,9 @@ class ace(Exchange, ImplicitAPI):
     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
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#oapi-api---trade-data
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#oapi-api---trade-data
+
         :param str[]|None 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
         :returns dict: a dictionary of `ticker structures <https://docs.ccxt.com/#/?id=ticker-structure>`
@@ -335,7 +417,7 @@ class ace(Exchange, ImplicitAPI):
         for i in range(0, len(pairs)):
             marketId = pairs[i]
             market = self.safe_market(marketId)
-            rawTicker = self.safe_value(response, marketId)
+            rawTicker = self.safe_dict(response, marketId, {})
             ticker = self.parse_ticker(rawTicker, market)
             tickers.append(ticker)
         return self.filter_by_array_tickers(tickers, 'symbol', symbols)
@@ -343,7 +425,9 @@ class ace(Exchange, ImplicitAPI):
     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
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-books
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-books
+
         :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
@@ -351,7 +435,7 @@ class ace(Exchange, ImplicitAPI):
         """
         await self.load_markets()
         market = self.market(symbol)
-        request = {
+        request: dict = {
             'quoteCurrencyId': market['quoteId'],
             'baseCurrencyId': market['baseId'],
         }
@@ -395,8 +479,8 @@ class ace(Exchange, ImplicitAPI):
         #         "status": 200
         #     }
         #
-        orderBook = self.safe_value(response, 'attachment')
-        return self.parse_order_book(orderBook, market['symbol'], None, 'bids', 'asks')
+        orderBook = self.safe_dict(response, 'attachment')
+        return self.parse_order_book(orderBook, market['symbol'], None, 'bids', 'asks', 1, 0)
 
     def parse_ohlcv(self, ohlcv, market: Market = None) -> list:
         #
@@ -429,7 +513,9 @@ class ace(Exchange, ImplicitAPI):
     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
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---klinecandlestick-data
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---klinecandlestick-data
+
         :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
@@ -439,7 +525,7 @@ class ace(Exchange, ImplicitAPI):
         """
         await self.load_markets()
         market = self.market(symbol)
-        request = {
+        request: dict = {
             'duration': self.timeframes[timeframe],
             'quoteCurrencyId': market['quoteId'],
             'baseCurrencyId': market['baseId'],
@@ -449,7 +535,7 @@ class ace(Exchange, ImplicitAPI):
         if since is not None:
             request['startTime'] = since
         response = await self.privatePostV2KlineGetKline(self.extend(request, params))
-        data = self.safe_value(response, 'attachment', [])
+        data = self.safe_list(response, 'attachment', [])
         #
         #     {
         #         "attachment":[
@@ -470,8 +556,8 @@ class ace(Exchange, ImplicitAPI):
         #
         return self.parse_ohlcvs(data, market, timeframe, since, limit)
 
-    def parse_order_status(self, status):
-        statuses = {
+    def parse_order_status(self, status: Str):
+        statuses: dict = {
             '0': 'open',
             '1': 'open',
             '2': 'closed',
@@ -480,7 +566,7 @@ class ace(Exchange, ImplicitAPI):
         }
         return self.safe_string(statuses, status, None)
 
-    def parse_order(self, order, market: Market = None) -> Order:
+    def parse_order(self, order: dict, market: Market = None) -> Order:
         #
         # createOrder
         #         "15697850529570392100421100482693"
@@ -528,18 +614,18 @@ class ace(Exchange, ImplicitAPI):
                 if dateTime is not None:
                     timestamp = self.parse8601(dateTime)
                     timestamp = timestamp - 28800000  # 8 hours
-            orderSide = self.safe_number(order, 'buyOrSell')
+            orderSide = self.safe_string(order, 'buyOrSell')
             if orderSide is not None:
-                side = 'buy' if (orderSide == 1) else 'sell'
+                side = 'buy' if (orderSide == '1') else 'sell'
             amount = self.safe_string(order, 'num')
             price = self.safe_string(order, 'price')
             quoteId = self.safe_string(order, 'quoteCurrencyName')
             baseId = self.safe_string(order, 'baseCurrencyName')
             if quoteId is not None and baseId is not None:
                 symbol = baseId + '/' + quoteId
-            orderType = self.safe_number(order, 'type')
+            orderType = self.safe_string(order, 'type')
             if orderType is not None:
-                type = 'limit' if (orderType == 1) else 'market'
+                type = 'limit' if (orderType == '1') else 'market'
             filled = self.safe_string(order, 'tradeNum')
             remaining = self.safe_string(order, 'remainNum')
             status = self.parse_order_status(self.safe_string(order, 'status'))
@@ -556,7 +642,7 @@ class ace(Exchange, ImplicitAPI):
             'postOnly': None,
             'side': side,
             'price': price,
-            'stopPrice': None,
+            'triggerPrice': None,
             'amount': amount,
             'cost': None,
             'average': average,
@@ -571,12 +657,14 @@ class ace(Exchange, ImplicitAPI):
     async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}):
         """
         create a trade order
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---new-order
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---new-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 fullfilled, in units of the quote currency, ignored in market orders
+        :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 <https://docs.ccxt.com/#/?id=order-structure>`
         """
@@ -584,7 +672,7 @@ class ace(Exchange, ImplicitAPI):
         market = self.market(symbol)
         orderType = type.upper()
         orderSide = side.upper()
-        request = {
+        request: dict = {
             'baseCurrencyId': market['baseId'],
             'quoteCurrencyId': market['quoteId'],
             'type': 1 if (orderType == 'LIMIT') else 2,
@@ -602,20 +690,22 @@ class ace(Exchange, ImplicitAPI):
         #         "status": 200
         #     }
         #
-        data = self.safe_value(response, 'attachment')
+        data = self.safe_dict(response, 'attachment')
         return self.parse_order(data, market)
 
     async def cancel_order(self, id: str, symbol: Str = None, params={}):
         """
         cancels an open order
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---cancel-order
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---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 <https://docs.ccxt.com/#/?id=order-structure>`
         """
         await self.load_markets()
-        request = {
+        request: dict = {
             'orderNo': id,
         }
         response = await self.privatePostV2OrderCancel(self.extend(request, params))
@@ -632,13 +722,16 @@ class ace(Exchange, ImplicitAPI):
     async def fetch_order(self, id: str, symbol: Str = None, params={}):
         """
         fetches information on an order made by the user
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-status
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-status
+
+        :param str id: the 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 <https://docs.ccxt.com/#/?id=order-structure>`
         """
         await self.load_markets()
-        request = {
+        request: dict = {
             'orderNo': id,
         }
         response = await self.privatePostV2OrderShowOrderStatus(self.extend(request, params))
@@ -664,13 +757,15 @@ class ace(Exchange, ImplicitAPI):
         #         "status": 200
         #     }
         #
-        data = self.safe_value(response, 'attachment')
+        data = self.safe_dict(response, 'attachment')
         return self.parse_order(data, None)
 
     async def fetch_open_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
         """
         fetch all unfilled currently open orders
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-list
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-list
+
         :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
@@ -681,7 +776,7 @@ class ace(Exchange, ImplicitAPI):
             raise ArgumentsRequired(self.id + ' fetchOpenOrders() requires a symbol argument')
         await self.load_markets()
         market = self.market(symbol)
-        request = {
+        request: dict = {
             'quoteCurrencyId': market['quoteId'],
             'baseCurrencyId': market['baseId'],
             # 'start': 0,
@@ -689,7 +784,7 @@ class ace(Exchange, ImplicitAPI):
         if limit is not None:
             request['size'] = limit
         response = await self.privatePostV2OrderGetOrderList(self.extend(request, params))
-        orders = self.safe_value(response, 'attachment')
+        orders = self.safe_list(response, 'attachment')
         #
         #     {
         #         "attachment": [
@@ -721,7 +816,7 @@ class ace(Exchange, ImplicitAPI):
         #
         return self.parse_orders(orders, market, since, limit)
 
-    def parse_trade(self, trade, market: Market = None) -> Trade:
+    def parse_trade(self, trade: dict, market: Market = None) -> Trade:
         #
         # fetchOrderTrades
         #         {
@@ -799,7 +894,9 @@ class ace(Exchange, ImplicitAPI):
     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
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-history
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---order-history
+
         :param str id: order id
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch trades for
@@ -809,7 +906,7 @@ class ace(Exchange, ImplicitAPI):
         """
         await self.load_markets()
         market = self.safe_market(symbol)
-        request = {
+        request: dict = {
             'orderNo': id,
         }
         response = await self.privatePostV2OrderShowOrderHistory(self.extend(request, params))
@@ -846,14 +943,16 @@ class ace(Exchange, ImplicitAPI):
         #         "status": 200
         #     }
         #
-        data = self.safe_value(response, 'attachment')
-        trades = self.safe_value(data, 'trades', [])
+        data = self.safe_dict(response, 'attachment')
+        trades = self.safe_list(data, 'trades', [])
         return self.parse_trades(trades, 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
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---trade-list
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---trade-list
+
         :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
@@ -862,7 +961,7 @@ class ace(Exchange, ImplicitAPI):
         """
         await self.load_markets()
         market = self.safe_market(symbol)
-        request = {
+        request: dict = {
             # 'buyOrSell': 1,
             # 'start': 0,
         }
@@ -902,7 +1001,7 @@ class ace(Exchange, ImplicitAPI):
         #         "status": 200
         #     }
         #
-        trades = self.safe_value(response, 'attachment', [])
+        trades = self.safe_list(response, 'attachment', [])
         return self.parse_trades(trades, market, since, limit)
 
     def parse_balance(self, response) -> Balances:
@@ -917,7 +1016,7 @@ class ace(Exchange, ImplicitAPI):
         #         }
         #     ]
         #
-        result = {
+        result: dict = {
             'info': response,
         }
         for i in range(0, len(response)):
@@ -926,7 +1025,7 @@ class ace(Exchange, ImplicitAPI):
             code = self.safe_currency_code(currencyId)
             amount = self.safe_string(balance, 'amount')
             available = self.safe_string(balance, 'cashAmount')
-            account = {
+            account: dict = {
                 'free': available,
                 'total': amount,
             }
@@ -936,13 +1035,15 @@ class ace(Exchange, ImplicitAPI):
     async def fetch_balance(self, params={}) -> Balances:
         """
         query for balance and get the amount of funds available for trading or funds locked in orders
-        :see: https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---account-balance
+
+        https://github.com/ace-exchange/ace-official-api-docs/blob/master/api_v2.md#open-api---account-balance
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `balance structure <https://docs.ccxt.com/#/?id=balance-structure>`
         """
         await self.load_markets()
         response = await self.privatePostV2CoinCustomerAccount(params)
-        balances = self.safe_value(response, 'attachment', [])
+        balances = self.safe_list(response, 'attachment', [])
         #
         #     {
         #         "attachment":[
@@ -972,13 +1073,16 @@ class ace(Exchange, ImplicitAPI):
             auth = 'ACE_SIGN' + self.secret
             data = self.extend({
                 'apiKey': self.apiKey,
-                'timeStamp': nonce,
+                'timeStamp': self.number_to_string(nonce),
             }, params)
-            dataKeys = list(data.keys())
-            sortedDataKeys = self.sort_by(dataKeys, 0, False, '')
-            for i in range(0, len(sortedDataKeys)):
-                key = sortedDataKeys[i]
-                auth += self.safe_string(data, key)
+            sortedData = self.keysort(data)
+            values = list(sortedData.values())
+            stringifiedValues = []
+            for i in range(0, len(values)):
+                value = values[i]
+                strValue = str(value)
+                stringifiedValues.append(strValue)
+            auth += ''.join(stringifiedValues)
             signature = self.hash(self.encode(auth), 'sha256', 'hex')
             data['signKey'] = signature
             headers = {
@@ -995,7 +1099,7 @@ class ace(Exchange, ImplicitAPI):
         url = self.urls['api'][api] + url
         return {'url': url, 'method': method, 'body': body, 'headers': headers}
 
-    def handle_errors(self, code, reason, url, method, headers, body, response, requestHeaders, requestBody):
+    def handle_errors(self, code: int, reason: str, url: str, method: str, headers: dict, body: str, response, requestHeaders, requestBody):
         if response is None:
             return None  # fallback to the default error handler
         feedback = self.id + ' ' + body