ccxt 4.4.31 → 4.4.33

package/js/src/pro/binance.js

@@ -221,7 +221,7 @@ export default class binance extends binanceRest {
      * @description watch the public liquidations of a trading pair
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams
      * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams
-     * @param {string[]} symbols
+     * @param {string[]} symbols list of unified market symbols
      * @param {int} [since] the earliest time in ms to fetch liquidations for
      * @param {int} [limit] the maximum number of liquidation structures to retrieve
      * @param {object} [params] exchange specific parameters for the bitmex api endpoint
@@ -442,7 +442,7 @@ export default class binance extends binanceRest {
      * @description watch the private liquidations of a trading pair
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/user-data-streams/Event-Order-Update
      * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update
-     * @param symbols
+     * @param {string[]} symbols list of unified market symbols
      * @param {int} [since] the earliest time in ms to fetch liquidations for
      * @param {int} [limit] the maximum number of liquidation structures to retrieve
      * @param {object} [params] exchange specific parameters for the bitmex api endpoint
@@ -3176,7 +3176,7 @@ export default class binance extends binanceRest {
      * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#cancel-order-trade
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Cancel-Order
      * @param {string} id order id
-     * @param {string} symbol unified market symbol, default is undefined
+     * @param {string} [symbol] unified market symbol, default is undefined
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @param {string|undefined} [params.cancelRestrictions] Supported values: ONLY_NEW - Cancel will succeed if the order status is NEW. ONLY_PARTIALLY_FILLED - Cancel will succeed if order status is PARTIALLY_FILLED.
      * @returns {object} an list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
@@ -3220,7 +3220,7 @@ export default class binance extends binanceRest {
      * @name binance#cancelAllOrdersWs
      * @description cancel all open orders in a market
      * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#cancel-open-orders-trade
-     * @param {string} symbol unified market symbol of the market to cancel orders in
+     * @param {string} [symbol] unified market symbol of the market to cancel orders in
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
@@ -3257,8 +3257,8 @@ export default class binance extends binanceRest {
      * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#query-order-user_data
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Query-Order
      * @param {string} id order id
-     * @param {string} symbol unified symbol of the market the order was made in
-     * @param {object} params extra parameters specific to the exchange API endpoint
+     * @param {string} [symbol] unified symbol of the market the order was made in
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} An [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
     async fetchOrderWs(id, symbol = undefined, params = {}) {
@@ -3708,8 +3708,8 @@ export default class binance extends binanceRest {
      * @name binance#watchPositions
      * @description watch all open positions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {number} [since] since timestamp
+     * @param {number} [limit] limit
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @param {boolean} [params.portfolioMargin] set to true if you would like to watch positions in a portfolio margin account
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}

package/js/src/pro/bitget.d.ts

@@ -78,7 +78,7 @@ export default class bitget extends bitgetRest {
      * @see https://www.bitget.com/api-doc/spot/websocket/public/Candlesticks-Channel
      * @see https://www.bitget.com/api-doc/contract/websocket/public/Candlesticks-Channel
      * @param {string} symbol unified symbol of the market to unwatch the ohlcv for
-     * @param {string} timeframe
+     * @param {string} [timeframe] the period for the ratio, default is 1 minute
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
      */
@@ -171,8 +171,8 @@ export default class bitget extends bitgetRest {
      * @description watch all open positions
      * @see https://www.bitget.com/api-doc/contract/websocket/private/Positions-Channel
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @param {string} [params.instType] one of 'USDT-FUTURES', 'USDC-FUTURES', 'COIN-FUTURES', 'SUSDT-FUTURES', 'SUSDC-FUTURES' or 'SCOIN-FUTURES', default is 'USDT-FUTURES'
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}

package/js/src/pro/bitget.js

@@ -433,7 +433,7 @@ export default class bitget extends bitgetRest {
      * @see https://www.bitget.com/api-doc/spot/websocket/public/Candlesticks-Channel
      * @see https://www.bitget.com/api-doc/contract/websocket/public/Candlesticks-Channel
      * @param {string} symbol unified symbol of the market to unwatch the ohlcv for
-     * @param {string} timeframe
+     * @param {string} [timeframe] the period for the ratio, default is 1 minute
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
      */
@@ -675,7 +675,7 @@ export default class bitget extends bitgetRest {
             this.handleDeltas(storedOrderBook['bids'], bids);
             storedOrderBook['timestamp'] = timestamp;
             storedOrderBook['datetime'] = this.iso8601(timestamp);
-            const checksum = this.safeBool(this.options, 'checksum', true);
+            const checksum = this.handleOption('watchOrderBook', 'checksum', true);
             const isSnapshot = this.safeString(message, 'action') === 'snapshot'; // snapshot does not have a checksum
             if (!isSnapshot && checksum) {
                 const storedAsks = storedOrderBook['asks'];
@@ -941,8 +941,8 @@ export default class bitget extends bitgetRest {
      * @description watch all open positions
      * @see https://www.bitget.com/api-doc/contract/websocket/private/Positions-Channel
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @param {string} [params.instType] one of 'USDT-FUTURES', 'USDC-FUTURES', 'COIN-FUTURES', 'SUSDT-FUTURES', 'SUSDC-FUTURES' or 'SCOIN-FUTURES', default is 'USDT-FUTURES'
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}

package/js/src/pro/bitmart.d.ts

@@ -102,8 +102,8 @@ export default class bitmart extends bitmartRest {
      * @see https://developer-pro.bitmart.com/en/futures/#private-position-channel
      * @description watch all open positions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/bitmart.js

@@ -731,8 +731,8 @@ export default class bitmart extends bitmartRest {
      * @see https://developer-pro.bitmart.com/en/futures/#private-position-channel
      * @description watch all open positions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/bitmex.d.ts

@@ -80,8 +80,8 @@ export default class bitmex extends bitmexRest {
      * @description watch all open positions
      * @see https://www.bitmex.com/app/wsAPI#Subscriptions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to watch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/bitmex.js

@@ -731,8 +731,8 @@ export default class bitmex extends bitmexRest {
      * @description watch all open positions
      * @see https://www.bitmex.com/app/wsAPI#Subscriptions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to watch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/bitvavo.d.ts

@@ -189,6 +189,7 @@ export default class bitvavo extends bitvavoRest {
      * @returns {Order[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
     fetchOrdersWs(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Order[]>;
+    requestId(): number;
     watchRequest(action: any, request: any): Promise<any>;
     /**
      * @method
@@ -308,7 +309,6 @@ export default class bitvavo extends bitvavoRest {
     handleSingleOrder(client: Client, message: any): void;
     handleMarkets(client: Client, message: any): void;
     buildMessageHash(action: any, params?: {}): any;
-    checkMessageHashDoesNotExist(messageHash: any): void;
     actionAndMarketMessageHash(action: any, params?: {}): string;
     actionAndOrderIdMessageHash(action: any, params?: {}): string;
     handleOrder(client: Client, message: any): void;

package/js/src/pro/bitvavo.js

@@ -311,10 +311,9 @@ export default class bitvavo extends bitvavoRest {
         //        ]
         //    }
         //
-        const action = this.safeString(message, 'action');
         const response = this.safeValue(message, 'response');
         const ohlcv = this.parseOHLCVs(response, undefined, undefined, undefined);
-        const messageHash = this.buildMessageHash(action);
+        const messageHash = this.safeString(message, 'requestId');
         client.resolve(ohlcv, messageHash);
     }
     handleOHLCV(client, message) {
@@ -717,14 +716,15 @@ export default class bitvavo extends bitvavoRest {
         //        }]
         //    }
         //
-        const action = this.safeString(message, 'action');
-        const response = this.safeValue(message, 'response');
-        const firstRawOrder = this.safeValue(response, 0, {});
-        const marketId = this.safeString(firstRawOrder, 'market');
+        // const action = this.safeString (message, 'action');
+        const response = this.safeList(message, 'response');
+        // const firstRawOrder = this.safeValue (response, 0, {});
+        // const marketId = this.safeString (firstRawOrder, 'market');
         const orders = this.parseOrders(response);
-        let messageHash = this.buildMessageHash(action, { 'market': marketId });
-        client.resolve(orders, messageHash);
-        messageHash = this.buildMessageHash(action, message);
+        // let messageHash = this.buildMessageHash (action, { 'market': marketId });
+        // client.resolve (orders, messageHash);
+        // messageHash = this.buildMessageHash (action, message);
+        const messageHash = this.safeString(message, 'requestId');
         client.resolve(orders, messageHash);
     }
     /**
@@ -771,13 +771,19 @@ export default class bitvavo extends bitvavoRest {
         const orders = await this.watchRequest('privateGetOrders', request);
         return this.filterBySymbolSinceLimit(orders, symbol, since, limit);
     }
+    requestId() {
+        const ts = this.milliseconds().toString();
+        const randomNumber = this.randNumber(4);
+        const randomPart = randomNumber.toString();
+        return parseInt(ts + randomPart);
+    }
     async watchRequest(action, request) {
+        const messageHash = this.requestId();
+        const messageHashStr = messageHash.toString();
         request['action'] = action;
-        const messageHash = this.buildMessageHash(action, request);
-        this.checkMessageHashDoesNotExist(messageHash);
+        request['requestId'] = messageHash;
         const url = this.urls['api']['ws'];
-        const randomSubHash = this.randNumber(5).toString() + ':' + messageHash;
-        return await this.watch(url, messageHash, request, randomSubHash);
+        return await this.watch(url, messageHashStr, request, messageHashStr);
     }
     /**
      * @method
@@ -846,12 +852,12 @@ export default class bitvavo extends bitvavoRest {
         //    }
         //
         //
-        const action = this.safeString(message, 'action');
-        const response = this.safeValue(message, 'response');
-        const firstRawTrade = this.safeValue(response, 0, {});
-        const marketId = this.safeString(firstRawTrade, 'market');
+        // const action = this.safeString (message, 'action');
+        const response = this.safeList(message, 'response');
+        // const marketId = this.safeString (firstRawTrade, 'market');
         const trades = this.parseTrades(response, undefined, undefined, undefined);
-        const messageHash = this.buildMessageHash(action, { 'market': marketId });
+        // const messageHash = this.buildMessageHash (action, { 'market': marketId });
+        const messageHash = this.safeString(message, 'requestId');
         client.resolve(trades, messageHash);
     }
     /**
@@ -884,8 +890,9 @@ export default class bitvavo extends bitvavoRest {
         //        }
         //    }
         //
-        const action = this.safeString(message, 'action');
-        const messageHash = this.buildMessageHash(action, message);
+        // const action = this.safeString (message, 'action');
+        // const messageHash = this.buildMessageHash (action, message);
+        const messageHash = this.safeString(message, 'requestId');
         const response = this.safeValue(message, 'response');
         const withdraw = this.parseTransaction(response);
         client.resolve(withdraw, messageHash);
@@ -924,9 +931,10 @@ export default class bitvavo extends bitvavoRest {
         //        ]
         //    }
         //
-        const action = this.safeString(message, 'action');
-        const messageHash = this.buildMessageHash(action, message);
-        const response = this.safeValue(message, 'response');
+        // const action = this.safeString (message, 'action');
+        // const messageHash = this.buildMessageHash (action, message);
+        const response = this.safeList(message, 'response');
+        const messageHash = this.safeString(message, 'requestId');
         const withdrawals = this.parseTransactions(response, undefined, undefined, undefined, { 'type': 'withdrawal' });
         client.resolve(withdrawals, messageHash);
     }
@@ -983,10 +991,9 @@ export default class bitvavo extends bitvavoRest {
         //        ]
         //    }
         //
-        const action = this.safeString(message, 'action');
-        const messageHash = this.buildMessageHash(action, message);
         const response = this.safeValue(message, 'response');
         const deposits = this.parseTransactions(response, undefined, undefined, undefined, { 'type': 'deposit' });
+        const messageHash = this.safeString(message, 'requestId');
         client.resolve(deposits, messageHash);
     }
     /**
@@ -1046,8 +1053,7 @@ export default class bitvavo extends bitvavoRest {
         //        ]
         //    }
         //
-        const action = this.safeString(message, 'action');
-        const messageHash = this.buildMessageHash(action, message);
+        const messageHash = this.safeString(message, 'requestId');
         const response = this.safeValue(message, 'response');
         const currencies = this.parseCurrencies(response);
         client.resolve(currencies, messageHash);
@@ -1065,8 +1071,7 @@ export default class bitvavo extends bitvavoRest {
         //        }
         //    }
         //
-        const action = this.safeString(message, 'action');
-        const messageHash = this.buildMessageHash(action, message);
+        const messageHash = this.safeString(message, 'requestId');
         const response = this.safeValue(message, 'response');
         const fees = this.parseTradingFees(response);
         client.resolve(fees, messageHash);
@@ -1097,8 +1102,7 @@ export default class bitvavo extends bitvavoRest {
         //        ]
         //    }
         //
-        const action = this.safeString(message, 'action', 'privateGetBalance');
-        const messageHash = this.buildMessageHash(action, message);
+        const messageHash = this.safeString(message, 'requestId');
         const response = this.safeValue(message, 'response', []);
         const balance = this.parseBalance(response);
         client.resolve(balance, messageHash);
@@ -1132,10 +1136,9 @@ export default class bitvavo extends bitvavoRest {
         //        }
         //    }
         //
-        const action = this.safeString(message, 'action');
         const response = this.safeValue(message, 'response', {});
         const order = this.parseOrder(response);
-        const messageHash = this.buildMessageHash(action, response);
+        const messageHash = this.safeString(message, 'requestId');
         client.resolve(order, messageHash);
     }
     handleMarkets(client, message) {
@@ -1158,10 +1161,9 @@ export default class bitvavo extends bitvavoRest {
         //        ]
         //    }
         //
-        const action = this.safeString(message, 'action');
         const response = this.safeValue(message, 'response', {});
         const markets = this.parseMarkets(response);
-        const messageHash = this.buildMessageHash(action, response);
+        const messageHash = this.safeString(message, 'requestId');
         client.resolve(markets, messageHash);
     }
     buildMessageHash(action, params = {}) {
@@ -1179,18 +1181,6 @@ export default class bitvavo extends bitvavoRest {
         }
         return messageHash;
     }
-    checkMessageHashDoesNotExist(messageHash) {
-        const supressMultipleWsRequestsError = this.safeBool(this.options, 'supressMultipleWsRequestsError', false);
-        if (!supressMultipleWsRequestsError) {
-            const client = this.safeValue(this.clients, this.urls['api']['ws']);
-            if (client !== undefined) {
-                const future = this.safeValue(client.futures, messageHash);
-                if (future !== undefined) {
-                    throw new ExchangeError(this.id + ' a similar request with messageHash ' + messageHash + ' is already pending, you must wait for a response, or turn off this error by setting supressMultipleWsRequestsError in the options to true');
-                }
-            }
-        }
-    }
     actionAndMarketMessageHash(action, params = {}) {
         const symbol = this.safeString(params, 'market', '');
         return action + symbol;
@@ -1343,11 +1333,19 @@ export default class bitvavo extends bitvavoRest {
         //        errorCode: 217,
         //        error: 'Minimum order size in quote currency is 5 EUR or 0.001 BTC.'
         //    }
+        //    {
+        //        action: 'privateCreateOrder',
+        //        requestId: '17317539426571916',
+        //        market: 'USDT-EUR',
+        //        errorCode: 216,
+        //        error: 'You do not have sufficient balance to complete this operation.'
+        //    }
         //
         const error = this.safeString(message, 'error');
         const code = this.safeInteger(error, 'errorCode');
         const action = this.safeString(message, 'action');
-        const messageHash = this.buildMessageHash(action, message);
+        const buildMessage = this.buildMessageHash(action, message);
+        const messageHash = this.safeString(message, 'requestId', buildMessage);
         let rejected = false;
         try {
             this.handleErrors(code, error, client.url, undefined, undefined, error, message, undefined, undefined);

package/js/src/pro/blofin.d.ts

@@ -156,8 +156,8 @@ export default class blofin extends blofinRest {
      * @see https://docs.blofin.com/index.html#ws-positions-channel
      * @description watch all open positions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/blofin.js

@@ -546,8 +546,8 @@ export default class blofin extends blofinRest {
      * @see https://docs.blofin.com/index.html#ws-positions-channel
      * @description watch all open positions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/bybit.d.ts

@@ -311,8 +311,8 @@ export default class bybit extends bybitRest {
      * @see https://bybit-exchange.github.io/docs/v5/websocket/private/position
      * @description watch all open positions
      * @param {string[]} [symbols] list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/bybit.js

@@ -1381,8 +1381,8 @@ export default class bybit extends bybitRest {
      * @see https://bybit-exchange.github.io/docs/v5/websocket/private/position
      * @description watch all open positions
      * @param {string[]} [symbols] list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/coincatch.d.ts

@@ -27,7 +27,7 @@ export default class coincatch extends coincatchRest {
     watchTicker(symbol: string, params?: {}): Promise<Ticker>;
     /**
      * @method
-     * @name coinctach#unWatchTicker
+     * @name coincatch#unWatchTicker
      * @description unsubscribe from the ticker channel
      * @see https://coincatch.github.io/github.io/en/mix/#tickers-channel
      * @param {string} symbol unified symbol of the market to unwatch the ticker for

package/js/src/pro/coincatch.js

@@ -252,7 +252,7 @@ export default class coincatch extends coincatchRest {
     }
     /**
      * @method
-     * @name coinctach#unWatchTicker
+     * @name coincatch#unWatchTicker
      * @description unsubscribe from the ticker channel
      * @see https://coincatch.github.io/github.io/en/mix/#tickers-channel
      * @param {string} symbol unified symbol of the market to unwatch the ticker for

package/js/src/pro/cryptocom.d.ts

@@ -97,7 +97,7 @@ export default class cryptocom extends cryptocomRest {
      * @name cryptocom#unWatchTradesForSymbols
      * @description get the list of most recent trades for a particular symbol
      * @see https://exchange-docs.crypto.com/exchange/v1/rest-ws/index.html#trade-instrument_name
-     * @param symbols
+     * @param {string[]} [symbols] list of unified market symbols to unwatch trades for
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
      */
@@ -212,9 +212,9 @@ export default class cryptocom extends cryptocomRest {
      * @name cryptocom#watchPositions
      * @description watch all open positions
      * @see https://exchange-docs.crypto.com/exchange/v1/rest-ws/index.html#user-position_balance
-     * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {string[]} [symbols] list of unified market symbols to watch positions for
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/cryptocom.js

@@ -357,7 +357,7 @@ export default class cryptocom extends cryptocomRest {
      * @name cryptocom#unWatchTradesForSymbols
      * @description get the list of most recent trades for a particular symbol
      * @see https://exchange-docs.crypto.com/exchange/v1/rest-ws/index.html#trade-instrument_name
-     * @param symbols
+     * @param {string[]} [symbols] list of unified market symbols to unwatch trades for
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
      */
@@ -843,9 +843,9 @@ export default class cryptocom extends cryptocomRest {
      * @name cryptocom#watchPositions
      * @description watch all open positions
      * @see https://exchange-docs.crypto.com/exchange/v1/rest-ws/index.html#user-position_balance
-     * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {string[]} [symbols] list of unified market symbols to watch positions for
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/gate.d.ts

@@ -129,7 +129,7 @@ export default class gate extends gateRest {
      * @name gate#fetchOrdersWs
      * @see https://www.gate.io/docs/developers/futures/ws/en/#order-list
      * @description fetches information on multiple orders made by the user by status
-     * @param status
+     * @param {string} status requested order status
      * @param {string} symbol unified market symbol of the market orders were made in
      * @param {int|undefined} [since] the earliest time in ms to fetch orders for
      * @param {int|undefined} [limit] the maximum number of order structures to retrieve
@@ -280,9 +280,9 @@ export default class gate extends gateRest {
      * @see https://www.gate.io/docs/developers/delivery/ws/en/#positions-subscription
      * @see https://www.gate.io/docs/developers/options/ws/en/#positions-channel
      * @description watch all open positions
-     * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {string[]} [symbols] list of unified market symbols to watch positions for
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/gate.js

@@ -327,7 +327,7 @@ export default class gate extends gateRest {
      * @name gate#fetchOrdersWs
      * @see https://www.gate.io/docs/developers/futures/ws/en/#order-list
      * @description fetches information on multiple orders made by the user by status
-     * @param status
+     * @param {string} status requested order status
      * @param {string} symbol unified market symbol of the market orders were made in
      * @param {int|undefined} [since] the earliest time in ms to fetch orders for
      * @param {int|undefined} [limit] the maximum number of order structures to retrieve
@@ -1120,9 +1120,9 @@ export default class gate extends gateRest {
      * @see https://www.gate.io/docs/developers/delivery/ws/en/#positions-subscription
      * @see https://www.gate.io/docs/developers/options/ws/en/#positions-channel
      * @description watch all open positions
-     * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {string[]} [symbols] list of unified market symbols to watch positions for
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/hashkey.d.ts

@@ -93,9 +93,9 @@ export default class hashkey extends hashkeyRest {
      * @name hashkey#watchPositions
      * @see https://hashkeyglobal-apidoc.readme.io/reference/websocket-api#private-stream
      * @description watch all open positions
-     * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {string[]} [symbols] list of unified market symbols to watch positions for
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/hashkey.js

@@ -588,9 +588,9 @@ export default class hashkey extends hashkeyRest {
      * @name hashkey#watchPositions
      * @see https://hashkeyglobal-apidoc.readme.io/reference/websocket-api#private-stream
      * @description watch all open positions
-     * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {string[]} [symbols] list of unified market symbols to watch positions for
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
      */

package/js/src/pro/mexc.js

@@ -1308,8 +1308,7 @@ export default class mexc extends mexcRest {
             '2': 'closed',
             '3': 'open',
             '4': 'canceled',
-            '5': 'open',
-            '6': 'closed',
+            '5': 'closed',
             'NEW': 'open',
             'CANCELED': 'canceled',
             'EXECUTED': 'closed',

package/js/src/pro/okx.js

@@ -2257,6 +2257,7 @@ export default class okx extends okxRest {
         //
         //     { event: 'error', msg: "Illegal request: {"op":"subscribe","args":["spot/ticker:BTC-USDT"]}", code: "60012" }
         //     { event: 'error", msg: "channel:ticker,instId:BTC-USDT doesn"t exist", code: "60018" }
+        //     {"event":"error","msg":"Illegal request: {\\"id\\":\\"17321173472466905\\",\\"op\\":\\"amend-order\\",\\"args\\":[{\\"instId\\":\\"ETH-USDC\\",\\"ordId\\":\\"2000345622407479296\\",\\"newSz\\":\\"0.050857\\",\\"newPx\\":\\"2949.4\\",\\"postOnly\\":true}],\\"postOnly\\":true}","code":"60012","connId":"0808af6c"}
         //
         let errorCode = this.safeString(message, 'code');
         try {
@@ -2289,7 +2290,16 @@ export default class okx extends okxRest {
         catch (e) {
             // if the message contains an id, it means it is a response to a request
             // so we only reject that promise, instead of deleting all futures, destroying the authentication future
-            const id = this.safeString(message, 'id');
+            let id = this.safeString(message, 'id');
+            if (id === undefined) {
+                // try to parse it from the stringified json inside msg
+                const msg = this.safeString(message, 'msg');
+                if (msg !== undefined && msg.startsWith('Illegal request: {')) {
+                    const stringifiedJson = msg.replace('Illegal request: ', '');
+                    const parsedJson = this.parseJson(stringifiedJson);
+                    id = this.safeString(parsedJson, 'id');
+                }
+            }
             if (id !== undefined) {
                 client.reject(e, id);
                 return false;

package/js/src/wavesexchange.d.ts

@@ -193,6 +193,7 @@ export default class wavesexchange extends Exchange {
      * @method
      * @name wavesexchange#fetchMyTrades
      * @description fetch all trades made by the user
+     * @see https://api.wavesplatform.com/v0/docs/#/transactions/searchTxsExchange
      * @param {string} symbol unified market symbol
      * @param {int} [since] the earliest time in ms to fetch trades for
      * @param {int} [limit] the maximum number of trades structures to retrieve