ccxt-ir 4.3.46.0.1__py2.py3-none-any.whl

ccxt/pro/woo.py

@@ -0,0 +1,1078 @@
+# -*- 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
+
+import ccxt.async_support
+from ccxt.async_support.base.ws.cache import ArrayCache, ArrayCacheBySymbolById, ArrayCacheBySymbolBySide, ArrayCacheByTimestamp
+import hashlib
+from ccxt.base.types import Balances, Int, Order, OrderBook, Position, Str, Strings, Ticker, Tickers, Trade
+from ccxt.async_support.base.ws.client import Client
+from typing import List
+from ccxt.base.errors import ExchangeError
+from ccxt.base.errors import AuthenticationError
+from ccxt.base.precise import Precise
+
+
+class woo(ccxt.async_support.woo):
+
+    def describe(self):
+        return self.deep_extend(super(woo, self).describe(), {
+            'has': {
+                'ws': True,
+                'watchBalance': True,
+                'watchMyTrades': True,
+                'watchOHLCV': True,
+                'watchOrderBook': True,
+                'watchOrders': True,
+                'watchTicker': True,
+                'watchTickers': True,
+                'watchTrades': True,
+                'watchPositions': True,
+            },
+            'urls': {
+                'api': {
+                    'ws': {
+                        'public': 'wss://wss.woo.org/ws/stream',
+                        'private': 'wss://wss.woo.network/v2/ws/private/stream',
+                    },
+                },
+                'test': {
+                    'ws': {
+                        'public': 'wss://wss.staging.woo.org/ws/stream',
+                        'private': 'wss://wss.staging.woo.org/v2/ws/private/stream',
+                    },
+                },
+            },
+            'requiredCredentials': {
+                'apiKey': True,
+                'secret': True,
+                'uid': True,
+            },
+            'options': {
+                'tradesLimit': 1000,
+                'ordersLimit': 1000,
+                'requestId': {},
+                'watchPositions': {
+                    'fetchPositionsSnapshot': True,  # or False
+                    'awaitPositionsSnapshot': True,  # whether to wait for the positions snapshot before providing updates
+                },
+            },
+            'streaming': {
+                'ping': self.ping,
+                'keepAlive': 9000,
+            },
+            'exceptions': {
+                'ws': {
+                    'exact': {
+                        'Auth is needed.': AuthenticationError,
+                    },
+                },
+            },
+        })
+
+    def request_id(self, url):
+        options = self.safe_value(self.options, 'requestId', {})
+        previousValue = self.safe_integer(options, url, 0)
+        newValue = self.sum(previousValue, 1)
+        self.options['requestId'][url] = newValue
+        return newValue
+
+    async def watch_public(self, messageHash, message):
+        url = self.urls['api']['ws']['public'] + '/' + self.uid
+        requestId = self.request_id(url)
+        subscribe: dict = {
+            'id': requestId,
+        }
+        request = self.extend(subscribe, message)
+        return await self.watch(url, messageHash, request, messageHash, subscribe)
+
+    async def watch_order_book(self, symbol: str, limit: Int = None, params={}) -> OrderBook:
+        """
+        :see: https://docs.woo.org/#orderbook
+        watches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
+        :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 <https://docs.ccxt.com/#/?id=order-book-structure>` indexed by market symbols
+        """
+        await self.load_markets()
+        name = 'orderbook'
+        market = self.market(symbol)
+        topic = market['id'] + '@' + name
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        orderbook = await self.watch_public(topic, message)
+        return orderbook.limit()
+
+    def handle_order_book(self, client: Client, message):
+        #
+        #     {
+        #         "topic": "PERP_BTC_USDT@orderbook",
+        #         "ts": 1650121915308,
+        #         "data": {
+        #             "symbol": "PERP_BTC_USDT",
+        #             "bids": [
+        #                 [
+        #                     0.30891,
+        #                     2469.98
+        #                 ]
+        #             ],
+        #             "asks": [
+        #                 [
+        #                     0.31075,
+        #                     2379.63
+        #                 ]
+        #             ]
+        #         }
+        #     }
+        #
+        data = self.safe_dict(message, 'data')
+        marketId = self.safe_string(data, 'symbol')
+        market = self.safe_market(marketId)
+        symbol = market['symbol']
+        topic = self.safe_string(message, 'topic')
+        if not (symbol in self.orderbooks):
+            self.orderbooks[symbol] = self.order_book({})
+        orderbook = self.orderbooks[symbol]
+        timestamp = self.safe_integer(message, 'ts')
+        snapshot = self.parse_order_book(data, symbol, timestamp, 'bids', 'asks')
+        orderbook.reset(snapshot)
+        client.resolve(orderbook, topic)
+
+    async def watch_ticker(self, symbol: str, params={}) -> Ticker:
+        """
+        watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+        :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>`
+        """
+        await self.load_markets()
+        name = 'ticker'
+        market = self.market(symbol)
+        symbol = market['symbol']
+        topic = market['id'] + '@' + name
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        return await self.watch_public(topic, message)
+
+    def parse_ws_ticker(self, ticker, market=None):
+        #
+        #     {
+        #         "symbol": "PERP_BTC_USDT",
+        #         "open": 19441.5,
+        #         "close": 20147.07,
+        #         "high": 20761.87,
+        #         "low": 19320.54,
+        #         "volume": 2481.103,
+        #         "amount": 50037935.0286,
+        #         "count": 3689
+        #     }
+        #
+        return self.safe_ticker({
+            'symbol': self.safe_symbol(None, market),
+            'timestamp': None,
+            'datetime': None,
+            'high': self.safe_string(ticker, 'high'),
+            'low': self.safe_string(ticker, 'low'),
+            'bid': None,
+            'bidVolume': None,
+            'ask': None,
+            'askVolume': None,
+            'vwap': None,
+            'open': self.safe_string(ticker, 'open'),
+            'close': self.safe_string(ticker, 'close'),
+            'last': None,
+            'previousClose': None,
+            'change': None,
+            'percentage': None,
+            'average': None,
+            'baseVolume': self.safe_string(ticker, 'volume'),
+            'quoteVolume': self.safe_string(ticker, 'amount'),
+            'info': ticker,
+        }, market)
+
+    def handle_ticker(self, client: Client, message):
+        #
+        #     {
+        #         "topic": "PERP_BTC_USDT@ticker",
+        #         "ts": 1657120017000,
+        #         "data": {
+        #             "symbol": "PERP_BTC_USDT",
+        #             "open": 19441.5,
+        #             "close": 20147.07,
+        #             "high": 20761.87,
+        #             "low": 19320.54,
+        #             "volume": 2481.103,
+        #             "amount": 50037935.0286,
+        #             "count": 3689
+        #         }
+        #     }
+        #
+        data = self.safe_value(message, 'data')
+        topic = self.safe_value(message, 'topic')
+        marketId = self.safe_string(data, 'symbol')
+        market = self.safe_market(marketId)
+        timestamp = self.safe_integer(message, 'ts')
+        data['date'] = timestamp
+        ticker = self.parse_ws_ticker(data, market)
+        ticker['symbol'] = market['symbol']
+        self.tickers[market['symbol']] = ticker
+        client.resolve(ticker, topic)
+        return message
+
+    async def watch_tickers(self, symbols: Strings = None, params={}) -> Tickers:
+        """
+        :see: https://docs.woo.org/#24h-tickers
+        watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
+        :param str[] symbols: 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>`
+        """
+        await self.load_markets()
+        symbols = self.market_symbols(symbols)
+        name = 'tickers'
+        topic = name
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        tickers = await self.watch_public(topic, message)
+        return self.filter_by_array(tickers, 'symbol', symbols)
+
+    def handle_tickers(self, client: Client, message):
+        #
+        #     {
+        #         "topic":"tickers",
+        #         "ts":1618820615000,
+        #         "data":[
+        #             {
+        #                 "symbol":"SPOT_OKB_USDT",
+        #                 "open":16.297,
+        #                 "close":17.183,
+        #                 "high":24.707,
+        #                 "low":11.997,
+        #                 "volume":0,
+        #                 "amount":0,
+        #                 "count":0
+        #             },
+        #             {
+        #                 "symbol":"SPOT_XRP_USDT",
+        #                 "open":1.3515,
+        #                 "close":1.43794,
+        #                 "high":1.96674,
+        #                 "low":0.39264,
+        #                 "volume":750127.1,
+        #                 "amount":985440.5122,
+        #                 "count":396
+        #             },
+        #         ...
+        #         ]
+        #     }
+        #
+        topic = self.safe_value(message, 'topic')
+        data = self.safe_value(message, 'data')
+        timestamp = self.safe_integer(message, 'ts')
+        result = []
+        for i in range(0, len(data)):
+            marketId = self.safe_string(data[i], 'symbol')
+            market = self.safe_market(marketId)
+            ticker = self.parse_ws_ticker(self.extend(data[i], {'date': timestamp}), market)
+            self.tickers[market['symbol']] = ticker
+            result.append(ticker)
+        client.resolve(result, topic)
+
+    async def watch_ohlcv(self, symbol: str, timeframe='1m', since: Int = None, limit: Int = None, params={}) -> List[list]:
+        """
+        watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+        :see: https://docs.woo.org/#k-line
+        :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()
+        if (timeframe != '1m') and (timeframe != '5m') and (timeframe != '15m') and (timeframe != '30m') and (timeframe != '1h') and (timeframe != '1d') and (timeframe != '1w') and (timeframe != '1M'):
+            raise ExchangeError(self.id + ' watchOHLCV timeframe argument must be 1m, 5m, 15m, 30m, 1h, 1d, 1w, 1M')
+        market = self.market(symbol)
+        interval = self.safe_string(self.timeframes, timeframe, timeframe)
+        name = 'kline'
+        topic = market['id'] + '@' + name + '_' + interval
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        ohlcv = await self.watch_public(topic, message)
+        if self.newUpdates:
+            limit = ohlcv.getLimit(market['symbol'], limit)
+        return self.filter_by_since_limit(ohlcv, since, limit, 0, True)
+
+    def handle_ohlcv(self, client: Client, message):
+        #
+        #     {
+        #         "topic":"SPOT_BTC_USDT@kline_1m",
+        #         "ts":1618822432146,
+        #         "data":{
+        #             "symbol":"SPOT_BTC_USDT",
+        #             "type":"1m",
+        #             "open":56948.97,
+        #             "close":56891.76,
+        #             "high":56948.97,
+        #             "low":56889.06,
+        #             "volume":44.00947568,
+        #             "amount":2504584.9,
+        #             "startTime":1618822380000,
+        #             "endTime":1618822440000
+        #         }
+        #     }
+        #
+        data = self.safe_value(message, 'data')
+        topic = self.safe_value(message, 'topic')
+        marketId = self.safe_string(data, 'symbol')
+        market = self.safe_market(marketId)
+        symbol = market['symbol']
+        interval = self.safe_string(data, 'type')
+        timeframe = self.find_timeframe(interval)
+        parsed = [
+            self.safe_integer(data, 'startTime'),
+            self.safe_float(data, 'open'),
+            self.safe_float(data, 'high'),
+            self.safe_float(data, 'low'),
+            self.safe_float(data, 'close'),
+            self.safe_float(data, 'volume'),
+        ]
+        self.ohlcvs[symbol] = self.safe_value(self.ohlcvs, symbol, {})
+        stored = self.safe_value(self.ohlcvs[symbol], timeframe)
+        if stored is None:
+            limit = self.safe_integer(self.options, 'OHLCVLimit', 1000)
+            stored = ArrayCacheByTimestamp(limit)
+            self.ohlcvs[symbol][timeframe] = stored
+        stored.append(parsed)
+        client.resolve(stored, topic)
+
+    async def watch_trades(self, symbol: str, since: Int = None, limit: Int = None, params={}) -> List[Trade]:
+        """
+        watches information on multiple trades made in a market
+        :see: https://docs.woo.org/#trade
+        :param str symbol: unified market symbol of the market trades were made in
+        :param int [since]: the earliest time in ms to fetch trades for
+        :param int [limit]: the maximum number of trade structures to retrieve
+        :param dict [params]: extra parameters specific to the exchange API endpoint
+        :returns dict[]: a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure
+        """
+        await self.load_markets()
+        market = self.market(symbol)
+        symbol = market['symbol']
+        topic = market['id'] + '@trade'
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        trades = await self.watch_public(topic, message)
+        if self.newUpdates:
+            limit = trades.getLimit(market['symbol'], limit)
+        return self.filter_by_symbol_since_limit(trades, symbol, since, limit, True)
+
+    def handle_trade(self, client: Client, message):
+        #
+        # {
+        #     "topic":"SPOT_ADA_USDT@trade",
+        #     "ts":1618820361552,
+        #     "data":{
+        #         "symbol":"SPOT_ADA_USDT",
+        #         "price":1.27988,
+        #         "size":300,
+        #         "side":"BUY",
+        #         "source":0
+        #     }
+        # }
+        #
+        topic = self.safe_string(message, 'topic')
+        timestamp = self.safe_integer(message, 'ts')
+        data = self.safe_value(message, 'data')
+        marketId = self.safe_string(data, 'symbol')
+        market = self.safe_market(marketId)
+        symbol = market['symbol']
+        trade = self.parse_ws_trade(self.extend(data, {'timestamp': timestamp}), market)
+        tradesArray = self.safe_value(self.trades, symbol)
+        if tradesArray is None:
+            limit = self.safe_integer(self.options, 'tradesLimit', 1000)
+            tradesArray = ArrayCache(limit)
+        tradesArray.append(trade)
+        self.trades[symbol] = tradesArray
+        client.resolve(tradesArray, topic)
+
+    def parse_ws_trade(self, trade, market=None):
+        #
+        #     {
+        #         "symbol":"SPOT_ADA_USDT",
+        #         "timestamp":1618820361552,
+        #         "price":1.27988,
+        #         "size":300,
+        #         "side":"BUY",
+        #         "source":0
+        #     }
+        # private trade
+        #    {
+        #     "msgType": 0,  # execution report
+        #     "symbol": "SPOT_BTC_USDT",
+        #     "clientOrderId": 0,
+        #     "orderId": 54774393,
+        #     "type": "MARKET",
+        #     "side": "BUY",
+        #     "quantity": 0.0,
+        #     "price": 0.0,
+        #     "tradeId": 56201985,
+        #     "executedPrice": 23534.06,
+        #     "executedQuantity": 0.00040791,
+        #     "fee": 2.1E-7,
+        #     "feeAsset": "BTC",
+        #     "totalExecutedQuantity": 0.00040791,
+        #     "avgPrice": 23534.06,
+        #     "status": "FILLED",
+        #     "reason": "",
+        #     "orderTag": "default",
+        #     "totalFee": 2.1E-7,
+        #     "feeCurrency": "BTC",
+        #     "totalRebate": 0,
+        #     "rebateCurrency": "USDT",
+        #     "visible": 0.0,
+        #     "timestamp": 1675406261689,
+        #     "reduceOnly": False,
+        #     "maker": False
+        #   }
+        #
+        marketId = self.safe_string(trade, 'symbol')
+        market = self.safe_market(marketId, market)
+        symbol = market['symbol']
+        price = self.safe_string(trade, 'executedPrice', 'price')
+        amount = self.safe_string_2(trade, 'executedQuantity', 'size')
+        cost = Precise.string_mul(price, amount)
+        side = self.safe_string_lower(trade, 'side')
+        timestamp = self.safe_integer(trade, 'timestamp')
+        maker = self.safe_bool(trade, 'marker')
+        takerOrMaker = None
+        if maker is not None:
+            takerOrMaker = 'maker' if maker else 'taker'
+        type = self.safe_string_lower(trade, 'type')
+        fee = None
+        feeCost = self.safe_number(trade, 'fee')
+        if feeCost is not None:
+            fee = {
+                'cost': feeCost,
+                'currency': self.safe_currency_code(self.safe_string(trade, 'feeCurrency')),
+            }
+        return self.safe_trade({
+            'id': self.safe_string(trade, 'tradeId'),
+            'timestamp': timestamp,
+            'datetime': self.iso8601(timestamp),
+            'symbol': symbol,
+            'side': side,
+            'price': price,
+            'amount': amount,
+            'cost': cost,
+            'order': self.safe_string(trade, 'orderId'),
+            'takerOrMaker': takerOrMaker,
+            'type': type,
+            'fee': fee,
+            'info': trade,
+        }, market)
+
+    def check_required_uid(self, error=True):
+        if not self.uid:
+            if error:
+                raise AuthenticationError(self.id + ' requires `uid` credential')
+            else:
+                return False
+        return True
+
+    async def authenticate(self, params={}):
+        self.check_required_credentials()
+        url = self.urls['api']['ws']['private'] + '/' + self.uid
+        client = self.client(url)
+        messageHash = 'authenticated'
+        event = 'auth'
+        future = client.future(messageHash)
+        authenticated = self.safe_value(client.subscriptions, messageHash)
+        if authenticated is None:
+            ts = str(self.nonce())
+            auth = '|' + ts
+            signature = self.hmac(self.encode(auth), self.encode(self.secret), hashlib.sha256)
+            request: dict = {
+                'event': event,
+                'params': {
+                    'apikey': self.apiKey,
+                    'sign': signature,
+                    'timestamp': ts,
+                },
+            }
+            message = self.extend(request, params)
+            self.watch(url, messageHash, message, messageHash)
+        return await future
+
+    async def watch_private(self, messageHash, message, params={}):
+        await self.authenticate(params)
+        url = self.urls['api']['ws']['private'] + '/' + self.uid
+        requestId = self.request_id(url)
+        subscribe: dict = {
+            'id': requestId,
+        }
+        request = self.extend(subscribe, message)
+        return await self.watch(url, messageHash, request, messageHash, subscribe)
+
+    async def watch_private_multiple(self, messageHashes, message, params={}):
+        await self.authenticate(params)
+        url = self.urls['api']['ws']['private'] + '/' + self.uid
+        requestId = self.request_id(url)
+        subscribe: dict = {
+            'id': requestId,
+        }
+        request = self.extend(subscribe, message)
+        return await self.watch_multiple(url, messageHashes, request, messageHashes, subscribe)
+
+    async def watch_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
+        """
+        :see: https://docs.woo.org/#executionreport
+        :see: https://docs.woo.org/#algoexecutionreportv2
+        watches information on multiple orders made by the user
+        :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
+        :param bool [params.trigger]: True if trigger order
+        :returns dict[]: a list of `order structures <https://docs.ccxt.com/#/?id=order-structure>`
+        """
+        await self.load_markets()
+        trigger = self.safe_bool_2(params, 'stop', 'trigger', False)
+        topic = 'algoexecutionreportv2' if (trigger) else 'executionreport'
+        params = self.omit(params, ['stop', 'trigger'])
+        messageHash = topic
+        if symbol is not None:
+            market = self.market(symbol)
+            symbol = market['symbol']
+            messageHash += ':' + symbol
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        orders = await self.watch_private(messageHash, message)
+        if self.newUpdates:
+            limit = orders.getLimit(symbol, limit)
+        return self.filter_by_symbol_since_limit(orders, symbol, since, limit, True)
+
+    async def watch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Trade]:
+        """
+        :see: https://docs.woo.org/#executionreport
+        :see: https://docs.woo.org/#algoexecutionreportv2
+        watches information on multiple trades made by the user
+        :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
+        :param bool [params.trigger]: True if trigger order
+        :returns dict[]: a list of `trade structures <https://docs.ccxt.com/#/?id=trade-structure>`
+        """
+        await self.load_markets()
+        trigger = self.safe_bool_2(params, 'stop', 'trigger', False)
+        topic = 'algoexecutionreportv2' if (trigger) else 'executionreport'
+        params = self.omit(params, ['stop', 'trigger'])
+        messageHash = 'myTrades'
+        if symbol is not None:
+            market = self.market(symbol)
+            symbol = market['symbol']
+            messageHash += ':' + symbol
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        trades = await self.watch_private(messageHash, message)
+        if self.newUpdates:
+            limit = trades.getLimit(symbol, limit)
+        return self.filter_by_symbol_since_limit(trades, symbol, since, limit, True)
+
+    def parse_ws_order(self, order, market=None):
+        #
+        #     {
+        #         "symbol": "PERP_BTC_USDT",
+        #         "clientOrderId": 0,
+        #         "orderId": 52952826,
+        #         "type": "LIMIT",
+        #         "side": "SELL",
+        #         "quantity": 0.01,
+        #         "price": 22000,
+        #         "tradeId": 0,
+        #         "executedPrice": 0,
+        #         "executedQuantity": 0,
+        #         "fee": 0,
+        #         "feeAsset": "USDT",
+        #         "totalExecutedQuantity": 0,
+        #         "status": "NEW",
+        #         "reason": '',
+        #         "orderTag": "default",
+        #         "totalFee": 0,
+        #         "visible": 0.01,
+        #         "timestamp": 1657515556799,
+        #         "reduceOnly": False,
+        #         "maker": False
+        #     }
+        #
+        orderId = self.safe_string(order, 'orderId')
+        marketId = self.safe_string(order, 'symbol')
+        market = self.market(marketId)
+        symbol = market['symbol']
+        timestamp = self.safe_integer(order, 'timestamp')
+        fee = {
+            'cost': self.safe_string(order, 'totalFee'),
+            'currency': self.safe_string(order, 'feeAsset'),
+        }
+        price = self.safe_number(order, 'price')
+        avgPrice = self.safe_number(order, 'avgPrice')
+        if (price == 0) and (avgPrice is not None):
+            price = avgPrice
+        amount = self.safe_float(order, 'quantity')
+        side = self.safe_string_lower(order, 'side')
+        type = self.safe_string_lower(order, 'type')
+        filled = self.safe_number(order, 'totalExecutedQuantity')
+        totalExecQuantity = self.safe_float(order, 'totalExecutedQuantity')
+        remaining = amount
+        if amount >= totalExecQuantity:
+            remaining -= totalExecQuantity
+        rawStatus = self.safe_string(order, 'status')
+        status = self.parse_order_status(rawStatus)
+        trades = None
+        clientOrderId = self.safe_string(order, 'clientOrderId')
+        return self.safe_order({
+            'info': order,
+            'symbol': symbol,
+            'id': orderId,
+            'clientOrderId': clientOrderId,
+            'timestamp': timestamp,
+            'datetime': self.iso8601(timestamp),
+            'lastTradeTimestamp': timestamp,
+            'type': type,
+            'timeInForce': None,
+            'postOnly': None,
+            'side': side,
+            'price': price,
+            'stopPrice': None,
+            'triggerPrice': None,
+            'amount': amount,
+            'cost': None,
+            'average': None,
+            'filled': filled,
+            'remaining': remaining,
+            'status': status,
+            'fee': fee,
+            'trades': trades,
+        })
+
+    def handle_order_update(self, client: Client, message):
+        #
+        #     {
+        #         "topic": "executionreport",
+        #         "ts": 1657515556799,
+        #         "data": {
+        #             "symbol": "PERP_BTC_USDT",
+        #             "clientOrderId": 0,
+        #             "orderId": 52952826,
+        #             "type": "LIMIT",
+        #             "side": "SELL",
+        #             "quantity": 0.01,
+        #             "price": 22000,
+        #             "tradeId": 0,
+        #             "executedPrice": 0,
+        #             "executedQuantity": 0,
+        #             "fee": 0,
+        #             "feeAsset": "USDT",
+        #             "totalExecutedQuantity": 0,
+        #             "status": "NEW",
+        #             "reason": '',
+        #             "orderTag": "default",
+        #             "totalFee": 0,
+        #             "visible": 0.01,
+        #             "timestamp": 1657515556799,
+        #             "reduceOnly": False,
+        #             "maker": False
+        #         }
+        #     }
+        #
+        topic = self.safe_string(message, 'topic')
+        data = self.safe_value(message, 'data')
+        if isinstance(data, list):
+            # algoexecutionreportv2
+            for i in range(0, len(data)):
+                order = data[i]
+                tradeId = self.omit_zero(self.safe_string(data, 'tradeId'))
+                if tradeId is not None:
+                    self.handle_my_trade(client, order)
+                self.handle_order(client, order, topic)
+        else:
+            # executionreport
+            tradeId = self.omit_zero(self.safe_string(data, 'tradeId'))
+            if tradeId is not None:
+                self.handle_my_trade(client, data)
+            self.handle_order(client, data, topic)
+
+    def handle_order(self, client: Client, message, topic):
+        parsed = self.parse_ws_order(message)
+        symbol = self.safe_string(parsed, 'symbol')
+        orderId = self.safe_string(parsed, 'id')
+        if symbol is not None:
+            if self.orders is None:
+                limit = self.safe_integer(self.options, 'ordersLimit', 1000)
+                self.orders = ArrayCacheBySymbolById(limit)
+            cachedOrders = self.orders
+            orders = self.safe_value(cachedOrders.hashmap, symbol, {})
+            order = self.safe_value(orders, orderId)
+            if order is not None:
+                fee = self.safe_value(order, 'fee')
+                if fee is not None:
+                    parsed['fee'] = fee
+                fees = self.safe_value(order, 'fees')
+                if fees is not None:
+                    parsed['fees'] = fees
+                parsed['trades'] = self.safe_value(order, 'trades')
+                parsed['timestamp'] = self.safe_integer(order, 'timestamp')
+                parsed['datetime'] = self.safe_string(order, 'datetime')
+            cachedOrders.append(parsed)
+            client.resolve(self.orders, topic)
+            messageHashSymbol = topic + ':' + symbol
+            client.resolve(self.orders, messageHashSymbol)
+
+    def handle_my_trade(self, client: Client, message):
+        #
+        #    {
+        #     "msgType": 0,  # execution report
+        #     "symbol": "SPOT_BTC_USDT",
+        #     "clientOrderId": 0,
+        #     "orderId": 54774393,
+        #     "type": "MARKET",
+        #     "side": "BUY",
+        #     "quantity": 0.0,
+        #     "price": 0.0,
+        #     "tradeId": 56201985,
+        #     "executedPrice": 23534.06,
+        #     "executedQuantity": 0.00040791,
+        #     "fee": 2.1E-7,
+        #     "feeAsset": "BTC",
+        #     "totalExecutedQuantity": 0.00040791,
+        #     "avgPrice": 23534.06,
+        #     "status": "FILLED",
+        #     "reason": "",
+        #     "orderTag": "default",
+        #     "totalFee": 2.1E-7,
+        #     "feeCurrency": "BTC",
+        #     "totalRebate": 0,
+        #     "rebateCurrency": "USDT",
+        #     "visible": 0.0,
+        #     "timestamp": 1675406261689,
+        #     "reduceOnly": False,
+        #     "maker": False
+        #   }
+        #
+        myTrades = self.myTrades
+        if myTrades is None:
+            limit = self.safe_integer(self.options, 'tradesLimit', 1000)
+            myTrades = ArrayCacheBySymbolById(limit)
+        trade = self.parse_ws_trade(message)
+        myTrades.append(trade)
+        messageHash = 'myTrades:' + trade['symbol']
+        client.resolve(myTrades, messageHash)
+        messageHash = 'myTrades'
+        client.resolve(myTrades, messageHash)
+
+    async def watch_positions(self, symbols: Strings = None, since: Int = None, limit: Int = None, params={}) -> List[Position]:
+        """
+        :see: https://docs.woo.org/#position-push
+        watch all open positions
+        :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 `position structure <https://docs.ccxt.com/en/latest/manual.html#position-structure>`
+        """
+        await self.load_markets()
+        messageHashes = []
+        symbols = self.market_symbols(symbols)
+        if not self.is_empty(symbols):
+            for i in range(0, len(symbols)):
+                symbol = symbols[i]
+                messageHashes.append('positions::' + symbol)
+        else:
+            messageHashes.append('positions')
+        url = self.urls['api']['ws']['private'] + '/' + self.uid
+        client = self.client(url)
+        self.set_positions_cache(client, symbols)
+        fetchPositionsSnapshot = self.handle_option('watchPositions', 'fetchPositionsSnapshot', True)
+        awaitPositionsSnapshot = self.safe_bool('watchPositions', 'awaitPositionsSnapshot', True)
+        if fetchPositionsSnapshot and awaitPositionsSnapshot and self.positions is None:
+            snapshot = await client.future('fetchPositionsSnapshot')
+            return self.filter_by_symbols_since_limit(snapshot, symbols, since, limit, True)
+        request: dict = {
+            'event': 'subscribe',
+            'topic': 'position',
+        }
+        newPositions = await self.watch_private_multiple(messageHashes, request, params)
+        if self.newUpdates:
+            return newPositions
+        return self.filter_by_symbols_since_limit(self.positions, symbols, since, limit, True)
+
+    def set_positions_cache(self, client: Client, type, symbols: Strings = None):
+        fetchPositionsSnapshot = self.handle_option('watchPositions', 'fetchPositionsSnapshot', False)
+        if fetchPositionsSnapshot:
+            messageHash = 'fetchPositionsSnapshot'
+            if not (messageHash in client.futures):
+                client.future(messageHash)
+                self.spawn(self.load_positions_snapshot, client, messageHash)
+        else:
+            self.positions = ArrayCacheBySymbolBySide()
+
+    async def load_positions_snapshot(self, client, messageHash):
+        positions = await self.fetch_positions()
+        self.positions = ArrayCacheBySymbolBySide()
+        cache = self.positions
+        for i in range(0, len(positions)):
+            position = positions[i]
+            contracts = self.safe_number(position, 'contracts', 0)
+            if contracts > 0:
+                cache.append(position)
+        # don't remove the future from the .futures cache
+        future = client.futures[messageHash]
+        future.resolve(cache)
+        client.resolve(cache, 'positions')
+
+    def handle_positions(self, client, message):
+        #
+        #    {
+        #        "topic":"position",
+        #        "ts":1705292345255,
+        #        "data":{
+        #           "positions":{
+        #              "PERP_LTC_USDT":{
+        #                 "holding":1,
+        #                 "pendingLongQty":0,
+        #                 "pendingShortQty":0,
+        #                 "averageOpenPrice":71.53,
+        #                 "pnl24H":0,
+        #                 "fee24H":0.07153,
+        #                 "settlePrice":71.53,
+        #                 "markPrice":71.32098452065145,
+        #                 "version":7886,
+        #                 "openingTime":1705292304267,
+        #                 "pnl24HPercentage":0,
+        #                 "adlQuantile":1,
+        #                 "positionSide":"BOTH"
+        #              }
+        #           }
+        #        }
+        #    }
+        #
+        data = self.safe_value(message, 'data', {})
+        rawPositions = self.safe_value(data, 'positions', {})
+        postitionsIds = list(rawPositions.keys())
+        if self.positions is None:
+            self.positions = ArrayCacheBySymbolBySide()
+        cache = self.positions
+        newPositions = []
+        for i in range(0, len(postitionsIds)):
+            marketId = postitionsIds[i]
+            market = self.safe_market(marketId)
+            rawPosition = rawPositions[marketId]
+            position = self.parse_position(rawPosition, market)
+            newPositions.append(position)
+            cache.append(position)
+            messageHash = 'positions::' + market['symbol']
+            client.resolve(position, messageHash)
+        client.resolve(newPositions, 'positions')
+
+    async def watch_balance(self, params={}) -> Balances:
+        """
+        :see: https://docs.woo.org/#balance
+        watch balance and get the amount of funds available for trading or funds locked in orders
+        :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()
+        topic = 'balance'
+        messageHash = topic
+        request: dict = {
+            'event': 'subscribe',
+            'topic': topic,
+        }
+        message = self.extend(request, params)
+        return await self.watch_private(messageHash, message)
+
+    def handle_balance(self, client, message):
+        #
+        #   {
+        #       "topic": "balance",
+        #       "ts": 1695716888789,
+        #       "data": {
+        #          "balances": {
+        #             "USDT": {
+        #                "holding": 266.56059176,
+        #                "frozen": 0,
+        #                "interest": 0,
+        #                "pendingShortQty": 0,
+        #                "pendingExposure": 0,
+        #                "pendingLongQty": 0,
+        #                "pendingLongExposure": 0,
+        #                "version": 37,
+        #                "staked": 0,
+        #                "unbonding": 0,
+        #                "vault": 0,
+        #                "averageOpenPrice": 0,
+        #                "pnl24H": 0,
+        #                "fee24H": 0,
+        #                "markPrice": 1,
+        #                "pnl24HPercentage": 0
+        #             }
+        #          }
+        #
+        #    }
+        #
+        data = self.safe_value(message, 'data')
+        balances = self.safe_value(data, 'balances')
+        keys = list(balances.keys())
+        ts = self.safe_integer(message, 'ts')
+        self.balance['info'] = data
+        self.balance['timestamp'] = ts
+        self.balance['datetime'] = self.iso8601(ts)
+        for i in range(0, len(keys)):
+            key = keys[i]
+            value = balances[key]
+            code = self.safe_currency_code(key)
+            account = self.balance[code] if (code in self.balance) else self.account()
+            total = self.safe_string(value, 'holding')
+            used = self.safe_string(value, 'frozen')
+            account['total'] = total
+            account['used'] = used
+            account['free'] = Precise.string_sub(total, used)
+            self.balance[code] = account
+        self.balance = self.safe_balance(self.balance)
+        client.resolve(self.balance, 'balance')
+
+    def handle_error_message(self, client: Client, message):
+        #
+        # {"id":"1","event":"subscribe","success":false,"ts":1710780997216,"errorMsg":"Auth is needed."}
+        #
+        if not ('success' in message):
+            return False
+        success = self.safe_bool(message, 'success')
+        if success:
+            return False
+        errorMessage = self.safe_string(message, 'errorMsg')
+        try:
+            if errorMessage is not None:
+                feedback = self.id + ' ' + self.json(message)
+                self.throw_exactly_matched_exception(self.exceptions['exact'], errorMessage, feedback)
+            return False
+        except Exception as error:
+            if isinstance(error, AuthenticationError):
+                messageHash = 'authenticated'
+                client.reject(error, messageHash)
+                if messageHash in client.subscriptions:
+                    del client.subscriptions[messageHash]
+            else:
+                client.reject(error)
+            return True
+
+    def handle_message(self, client: Client, message):
+        if self.handle_error_message(client, message):
+            return
+        methods: dict = {
+            'ping': self.handle_ping,
+            'pong': self.handle_pong,
+            'subscribe': self.handle_subscribe,
+            'orderbook': self.handle_order_book,
+            'ticker': self.handle_ticker,
+            'tickers': self.handle_tickers,
+            'kline': self.handle_ohlcv,
+            'auth': self.handle_auth,
+            'executionreport': self.handle_order_update,
+            'algoexecutionreportv2': self.handle_order_update,
+            'trade': self.handle_trade,
+            'balance': self.handle_balance,
+            'position': self.handle_positions,
+        }
+        event = self.safe_string(message, 'event')
+        method = self.safe_value(methods, event)
+        if method is not None:
+            method(client, message)
+            return
+        topic = self.safe_string(message, 'topic')
+        if topic is not None:
+            method = self.safe_value(methods, topic)
+            if method is not None:
+                method(client, message)
+                return
+            splitTopic = topic.split('@')
+            splitLength = len(splitTopic)
+            if splitLength == 2:
+                name = self.safe_string(splitTopic, 1)
+                method = self.safe_value(methods, name)
+                if method is not None:
+                    method(client, message)
+                    return
+                splitName = name.split('_')
+                splitNameLength = len(splitTopic)
+                if splitNameLength == 2:
+                    method = self.safe_value(methods, self.safe_string(splitName, 0))
+                    if method is not None:
+                        method(client, message)
+
+    def ping(self, client: Client):
+        return {'event': 'ping'}
+
+    def handle_ping(self, client: Client, message):
+        return {'event': 'pong'}
+
+    def handle_pong(self, client: Client, message):
+        #
+        # {event: "pong", ts: 1657117026090}
+        #
+        client.lastPong = self.milliseconds()
+        return message
+
+    def handle_subscribe(self, client: Client, message):
+        #
+        #     {
+        #         "id": "666888",
+        #         "event": "subscribe",
+        #         "success": True,
+        #         "ts": 1657117712212
+        #     }
+        #
+        return message
+
+    def handle_auth(self, client: Client, message):
+        #
+        #     {
+        #         "event": "auth",
+        #         "success": True,
+        #         "ts": 1657463158812
+        #     }
+        #
+        messageHash = 'authenticated'
+        success = self.safe_value(message, 'success')
+        if success:
+            # client.resolve(message, messageHash)
+            future = self.safe_value(client.futures, 'authenticated')
+            future.resolve(True)
+        else:
+            error = AuthenticationError(self.json(message))
+            client.reject(error, messageHash)
+            # allows further authentication attempts
+            if messageHash in client.subscriptions:
+                del client.subscriptions['authenticated']