ccxt 4.4.30 → 4.4.32

package/js/src/pro/binance.js

@@ -200,34 +200,34 @@ export default class binance extends binanceRest {
         }
         return stream;
     }
+    /**
+     * @method
+     * @name binance#watchLiquidations
+     * @description watch the public liquidations of a trading pair
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Liquidation-Order-Streams
+     * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Liquidation-Order-Streams
+     * @param {string} symbol unified CCXT market symbol
+     * @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
+     * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
+     */
     async watchLiquidations(symbol, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchLiquidations
-         * @description watch the public liquidations of a trading pair
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Liquidation-Order-Streams
-         * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/Liquidation-Order-Streams
-         * @param {string} symbol unified CCXT market symbol
-         * @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
-         * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
-         */
         return await this.watchLiquidationsForSymbols([symbol], since, limit, params);
     }
+    /**
+     * @method
+     * @name binance#watchLiquidationsForSymbols
+     * @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 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
+     * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
+     */
     async watchLiquidationsForSymbols(symbols = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchLiquidationsForSymbols
-         * @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} symbol unified CCXT market symbol
-         * @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
-         * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
-         */
         await this.loadMarkets();
         const subscriptionHashes = [];
         const messageHashes = [];
@@ -421,34 +421,34 @@ export default class binance extends binanceRest {
             'datetime': this.iso8601(timestamp),
         });
     }
+    /**
+     * @method
+     * @name binance#watchMyLiquidations
+     * @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 {string} symbol unified CCXT market symbol
+     * @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
+     * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
+     */
     async watchMyLiquidations(symbol, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchMyLiquidations
-         * @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 {string} symbol unified CCXT market symbol
-         * @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
-         * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
-         */
         return this.watchMyLiquidationsForSymbols([symbol], since, limit, params);
     }
+    /**
+     * @method
+     * @name binance#watchMyLiquidationsForSymbols
+     * @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 {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
+     * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
+     */
     async watchMyLiquidationsForSymbols(symbols, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchMyLiquidationsForSymbols
-         * @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 {string} symbol unified CCXT market symbol
-         * @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
-         * @returns {object} an array of [liquidation structures]{@link https://github.com/ccxt/ccxt/wiki/Manual#liquidation-structure}
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, undefined, true, true, true);
         const market = this.getMarketFromSymbols(symbols);
@@ -541,22 +541,22 @@ export default class binance extends binanceRest {
         client.resolve([liquidation], 'myLiquidations');
         client.resolve([liquidation], 'myLiquidations::' + symbol);
     }
+    /**
+     * @method
+     * @name binance#watchOrderBook
+     * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
+     * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+     * @param {string} 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 {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
+     */
     async watchOrderBook(symbol, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchOrderBook
-         * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
-         * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
-         * @param {string} 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 {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
-         */
         //
         // todo add support for <levels>-snapshots (depth)
         // https://github.com/binance-exchange/binance-official-api-docs/blob/master/web-socket-streams.md#partial-book-depth-streams        // <symbol>@depth<levels>@100ms or <symbol>@depth<levels> (1000ms)
@@ -596,22 +596,22 @@ export default class binance extends binanceRest {
         //
         return await this.watchOrderBookForSymbols([symbol], limit, params);
     }
+    /**
+     * @method
+     * @name binance#watchOrderBookForSymbols
+     * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
+     * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+     * @param {string[]} symbols unified array of symbols
+     * @param {int} [limit] the maximum amount of order book entries to return
+     * @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
+     */
     async watchOrderBookForSymbols(symbols, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchOrderBookForSymbols
-         * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
-         * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
-         * @param {string[]} symbols unified array of symbols
-         * @param {int} [limit] the maximum amount of order book entries to return
-         * @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
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, undefined, false, true, true);
         const firstMarket = this.market(symbols[0]);
@@ -659,21 +659,21 @@ export default class binance extends binanceRest {
         const orderbook = await this.watchMultiple(url, messageHashes, this.extend(request, params), messageHashes, subscription);
         return orderbook.limit();
     }
+    /**
+     * @method
+     * @name binance#unWatchOrderBookForSymbols
+     * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
+     * @description unWatches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+     * @param {string[]} symbols unified array of symbols
+     * @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
+     */
     async unWatchOrderBookForSymbols(symbols, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchOrderBookForSymbols
-         * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
-         * @description unWatches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
-         * @param {string[]} symbols unified array of symbols
-         * @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
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, undefined, false, true, true);
         const firstMarket = this.market(symbols[0]);
@@ -717,35 +717,35 @@ export default class binance extends binanceRest {
         };
         return await this.watchMultiple(url, messageHashes, this.extend(request, params), messageHashes, subscription);
     }
+    /**
+     * @method
+     * @name binance#unWatchOrderBook
+     * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
+     * @description unWatches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+     * @param {string} symbol unified array of symbols
+     * @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
+     */
     async unWatchOrderBook(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchOrderBook
-         * @see https://binance-docs.github.io/apidocs/spot/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#diff-depth-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#diff-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#partial-book-depth-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#diff-book-depth-streams
-         * @description unWatches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
-         * @param {string} symbol unified array of symbols
-         * @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
-         */
         return await this.unWatchOrderBookForSymbols([symbol], params);
     }
+    /**
+     * @method
+     * @name binance#fetchOrderBookWs
+     * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#order-book
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/websocket-api/Order-Book
+     * @param {string} 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 {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
+     */
     async fetchOrderBookWs(symbol, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchOrderBookWs
-         * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#order-book
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/websocket-api/Order-Book
-         * @param {string} 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 {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
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const payload = {
@@ -1037,22 +1037,22 @@ export default class binance extends binanceRest {
         }
         this.cleanCache(subscription);
     }
+    /**
+     * @method
+     * @name binance#watchTradesForSymbols
+     * @description get the list of most recent trades for a list of symbols
+     * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
+     * @param {string[]} symbols unified symbol of the market to fetch trades for
+     * @param {int} [since] timestamp in ms of the earliest trade to fetch
+     * @param {int} [limit] the maximum amount of trades to fetch
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+     */
     async watchTradesForSymbols(symbols, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchTradesForSymbols
-         * @description get the list of most recent trades for a list of symbols
-         * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
-         * @param {string[]} symbols unified symbol of the market to fetch trades for
-         * @param {int} [since] timestamp in ms of the earliest trade to fetch
-         * @param {int} [limit] the maximum amount of trades to fetch
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, undefined, false, true, true);
         let streamHash = 'multipleTrades';
@@ -1100,20 +1100,20 @@ export default class binance extends binanceRest {
         }
         return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
     }
+    /**
+     * @method
+     * @name binance#unWatchTradesForSymbols
+     * @description unsubscribes from the trades channel
+     * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
+     * @param {string[]} symbols unified symbol of the market to fetch trades for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+     */
     async unWatchTradesForSymbols(symbols, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchTradesForSymbols
-         * @description unsubscribes from the trades channel
-         * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
-         * @param {string[]} symbols unified symbol of the market to fetch trades for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, undefined, false, true, true);
         let streamHash = 'multipleTrades';
@@ -1162,39 +1162,39 @@ export default class binance extends binanceRest {
         };
         return await this.watchMultiple(url, messageHashes, this.extend(request, query), messageHashes, subscription);
     }
+    /**
+     * @method
+     * @name binance#unWatchTrades
+     * @description unsubscribes from the trades channel
+     * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
+     * @param {string} symbol unified symbol of the market to fetch trades for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+     */
     async unWatchTrades(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchTrades
-         * @description unsubscribes from the trades channel
-         * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
-         * @param {string} symbol unified symbol of the market to fetch trades for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
-         */
         await this.loadMarkets();
         return await this.unWatchTradesForSymbols([symbol], params);
     }
+    /**
+     * @method
+     * @name binance#watchTrades
+     * @description get the list of most recent trades for a particular symbol
+     * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
+     * @param {string} symbol unified symbol of the market to fetch trades for
+     * @param {int} [since] timestamp in ms of the earliest trade to fetch
+     * @param {int} [limit] the maximum amount of trades to fetch
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+     */
     async watchTrades(symbol, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchTrades
-         * @description get the list of most recent trades for a particular symbol
-         * @see https://binance-docs.github.io/apidocs/spot/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/spot/en/#trade-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#aggregate-trade-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#aggregate-trade-streams
-         * @param {string} symbol unified symbol of the market to fetch trades for
-         * @param {int} [since] timestamp in ms of the earliest trade to fetch
-         * @param {int} [limit] the maximum amount of trades to fetch
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string} [params.name] the name of the method to call, 'trade' or 'aggTrade', default is 'trade'
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
-         */
         params['callerMethodName'] = 'watchTrades';
         return await this.watchTradesForSymbols([symbol], since, limit, params);
     }
@@ -1379,22 +1379,22 @@ export default class binance extends binanceRest {
         this.trades[symbol] = tradesArray;
         client.resolve(tradesArray, messageHash);
     }
+    /**
+     * @method
+     * @name binance#watchOHLCV
+     * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+     * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
+     * @param {string} symbol unified symbol of the market to fetch OHLCV data for
+     * @param {string} 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 {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
+     * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
+     */
     async watchOHLCV(symbol, timeframe = '1m', since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchOHLCV
-         * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
-         * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
-         * @param {string} symbol unified symbol of the market to fetch OHLCV data for
-         * @param {string} 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 {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
-         * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         symbol = market['symbol'];
@@ -1402,21 +1402,21 @@ export default class binance extends binanceRest {
         const result = await this.watchOHLCVForSymbols([[symbol, timeframe]], since, limit, params);
         return result[symbol][timeframe];
     }
+    /**
+     * @method
+     * @name binance#watchOHLCVForSymbols
+     * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+     * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
+     * @param {string[][]} symbolsAndTimeframes array of arrays containing unified symbols and timeframes to fetch OHLCV data for, example [['BTC/USDT', '1m'], ['LTC/USDT', '5m']]
+     * @param {int} [since] timestamp in ms of the earliest candle to fetch
+     * @param {int} [limit] the maximum amount of candles to fetch
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
+     * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
+     */
     async watchOHLCVForSymbols(symbolsAndTimeframes, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchOHLCVForSymbols
-         * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
-         * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
-         * @param {string[][]} symbolsAndTimeframes array of arrays containing unified symbols and timeframes to fetch OHLCV data for, example [['BTC/USDT', '1m'], ['LTC/USDT', '5m']]
-         * @param {int} [since] timestamp in ms of the earliest candle to fetch
-         * @param {int} [limit] the maximum amount of candles to fetch
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
-         * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
-         */
         await this.loadMarkets();
         let klineType = undefined;
         [klineType, params] = this.handleParamString2(params, 'channel', 'name', 'kline');
@@ -1468,19 +1468,19 @@ export default class binance extends binanceRest {
         const filtered = this.filterBySinceLimit(candles, since, limit, 0, true);
         return this.createOHLCVObject(symbol, timeframe, filtered);
     }
+    /**
+     * @method
+     * @name binance#unWatchOHLCVForSymbols
+     * @description unWatches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+     * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
+     * @param {string[][]} symbolsAndTimeframes array of arrays containing unified symbols and timeframes to fetch OHLCV data for, example [['BTC/USDT', '1m'], ['LTC/USDT', '5m']]
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
+     * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
+     */
     async unWatchOHLCVForSymbols(symbolsAndTimeframes, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchOHLCVForSymbols
-         * @description unWatches historical candlestick data containing the open, high, low, and close price, and the volume of a market
-         * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
-         * @param {string[][]} symbolsAndTimeframes array of arrays containing unified symbols and timeframes to fetch OHLCV data for, example [['BTC/USDT', '1m'], ['LTC/USDT', '5m']]
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
-         * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
-         */
         await this.loadMarkets();
         let klineType = undefined;
         [klineType, params] = this.handleParamString2(params, 'channel', 'name', 'kline');
@@ -1535,20 +1535,20 @@ export default class binance extends binanceRest {
         params = this.omit(params, 'callerMethodName');
         return await this.watchMultiple(url, messageHashes, this.extend(request, params), messageHashes, subscribe);
     }
+    /**
+     * @method
+     * @name binance#unWatchOHLCV
+     * @description unWatches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+     * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
+     * @param {string} symbol unified symbol of the market to fetch OHLCV data for
+     * @param {string} timeframe the length of time each candle represents
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
+     * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
+     */
     async unWatchOHLCV(symbol, timeframe = '1m', params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchOHLCV
-         * @description unWatches historical candlestick data containing the open, high, low, and close price, and the volume of a market
-         * @see https://binance-docs.github.io/apidocs/spot/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/futures/en/#kline-candlestick-data
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#kline-candlestick-data
-         * @param {string} symbol unified symbol of the market to fetch OHLCV data for
-         * @param {string} timeframe the length of time each candle represents
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {object} [params.timezone] if provided, kline intervals are interpreted in that timezone instead of UTC, example '+08:00'
-         * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         symbol = market['symbol'];
@@ -1620,17 +1620,17 @@ export default class binance extends binanceRest {
         const resolveData = [symbol, unifiedTimeframe, stored];
         client.resolve(resolveData, messageHash);
     }
+    /**
+     * @method
+     * @name binance#fetchTickerWs
+     * @description fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+     * @param {string} symbol unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.method] method to use can be ticker.price or ticker.book
+     * @param {boolean} [params.returnRateLimits] return the rate limits for the exchange
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async fetchTickerWs(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchTickerWs
-         * @description fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
-         * @param {string} symbol unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string} [params.method] method to use can be ticker.price or ticker.book
-         * @param {boolean} [params.returnRateLimits] return the rate limits for the exchange
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const payload = {
@@ -1660,23 +1660,23 @@ export default class binance extends binanceRest {
         const ticker = await this.watch(url, messageHash, message, messageHash, subscription);
         return ticker;
     }
+    /**
+     * @method
+     * @name binance#fetchOHLCVWs
+     * @description query historical candlestick data containing the open, high, low, and close price, and the volume of a market
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#klines
+     * @param {string} symbol unified symbol of the market to query OHLCV data for
+     * @param {string} 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 {object} params extra parameters specific to the exchange API endpoint
+     * @param {int} params.until timestamp in ms of the earliest candle to fetch
+     *
+     * EXCHANGE SPECIFIC PARAMETERS
+     * @param {string} params.timeZone default=0 (UTC)
+     * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
+     */
     async fetchOHLCVWs(symbol, timeframe = '1m', since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchOHLCVWs
-         * @description query historical candlestick data containing the open, high, low, and close price, and the volume of a market
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#klines
-         * @param {string} symbol unified symbol of the market to query OHLCV data for
-         * @param {string} 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 {object} params extra parameters specific to the exchange API endpoint
-         * @param {int} params.until timestamp in ms of the earliest candle to fetch
-         *
-         * EXCHANGE SPECIFIC PARAMETERS
-         * @param {string} params.timeZone default=0 (UTC)
-         * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const marketType = this.getMarketType('fetchOHLCVWs', market, params);
@@ -1752,54 +1752,54 @@ export default class binance extends binanceRest {
         const messageHash = this.safeString(message, 'id');
         client.resolve(parsed, messageHash);
     }
+    /**
+     * @method
+     * @name binance#watchTicker
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
+     * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+     * @param {string} symbol unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.name] stream to use can be ticker or miniTicker
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async watchTicker(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#watchTicker
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
-         * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
-         * @param {string} symbol unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string} [params.name] stream to use can be ticker or miniTicker
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         await this.loadMarkets();
         symbol = this.symbol(symbol);
         const tickers = await this.watchTickers([symbol], this.extend(params, { 'callerMethodName': 'watchTicker' }));
         return tickers[symbol];
     }
+    /**
+     * @method
+     * @name binance#watchMarkPrice
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream
+     * @description watches a mark price for a specific market
+     * @param {string} symbol unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.use1sFreq] *default is true* if set to true, the mark price will be updated every second, otherwise every 3 seconds
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async watchMarkPrice(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#watchMarkPrice
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream
-         * @description watches a mark price for a specific market
-         * @param {string} symbol unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {boolean} [params.use1sFreq] *default is true* if set to true, the mark price will be updated every second, otherwise every 3 seconds
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         await this.loadMarkets();
         symbol = this.symbol(symbol);
         const tickers = await this.watchMarkPrices([symbol], this.extend(params, { 'callerMethodName': 'watchMarkPrice' }));
         return tickers[symbol];
     }
+    /**
+     * @method
+     * @name binance#watchMarkPrices
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream-for-All-market
+     * @description watches the mark price for all markets
+     * @param {string[]} symbols unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.use1sFreq] *default is true* if set to true, the mark price will be updated every second, otherwise every 3 seconds
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async watchMarkPrices(symbols = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchMarkPrices
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/Mark-Price-Stream-for-All-market
-         * @description watches the mark price for all markets
-         * @param {string[]} symbols unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {boolean} [params.use1sFreq] *default is true* if set to true, the mark price will be updated every second, otherwise every 3 seconds
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         let channelName = undefined;
         // for now watchmarkPrice uses the same messageHash as watchTicker
         // so it's impossible to watch both at the same time
@@ -1811,21 +1811,21 @@ export default class binance extends binanceRest {
         }
         return this.filterByArray(this.tickers, 'symbol', symbols);
     }
+    /**
+     * @method
+     * @name binance#watchTickers
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
+     * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
+     * @param {string[]} symbols unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async watchTickers(symbols = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchTickers
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
-         * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
-         * @param {string[]} symbols unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         let channelName = undefined;
         [channelName, params] = this.handleOptionAndParams(params, 'watchTickers', 'name', 'ticker');
         if (channelName === 'bookTicker') {
@@ -1837,21 +1837,21 @@ export default class binance extends binanceRest {
         }
         return this.filterByArray(this.tickers, 'symbol', symbols);
     }
+    /**
+     * @method
+     * @name binance#unWatchTickers
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
+     * @description unWatches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
+     * @param {string[]} symbols unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async unWatchTickers(symbols = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchTickers
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
-         * @description unWatches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
-         * @param {string[]} symbols unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         let channelName = undefined;
         [channelName, params] = this.handleOptionAndParams(params, 'watchTickers', 'name', 'ticker');
         if (channelName === 'bookTicker') {
@@ -1929,35 +1929,35 @@ export default class binance extends binanceRest {
         };
         return await this.watchMultiple(url, subMessageHashes, this.extend(request, params), subMessageHashes, subscription);
     }
+    /**
+     * @method
+     * @name binance#unWatchTicker
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
+     * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
+     * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
+     * @description unWatches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
+     * @param {string} symbol unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async unWatchTicker(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#unWatchTicker
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-mini-ticker-stream
-         * @see https://binance-docs.github.io/apidocs/spot/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/futures/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/futures/en/#individual-symbol-ticker-streams
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#all-market-mini-tickers-stream
-         * @see https://binance-docs.github.io/apidocs/delivery/en/#individual-symbol-ticker-streams
-         * @description unWatches a price ticker, a statistical calculation with the information calculated over the past 24 hours for all markets of a specific list
-         * @param {string} symbol unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         return await this.unWatchTickers([symbol], params);
     }
+    /**
+     * @method
+     * @name binance#watchBidsAsks
+     * @description watches best bid & ask for symbols
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#symbol-order-book-ticker
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Book-Tickers-Stream
+     * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream
+     * @param {string[]} symbols unified symbol of the market to fetch the ticker for
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
+     */
     async watchBidsAsks(symbols = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchBidsAsks
-         * @description watches best bid & ask for symbols
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#symbol-order-book-ticker
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Book-Tickers-Stream
-         * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Book-Tickers-Stream
-         * @param {string[]} symbols unified symbol of the market to fetch the ticker for
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @returns {object} a [ticker structure]{@link https://docs.ccxt.com/#/?id=ticker-structure}
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, undefined, true, false, true);
         const result = await this.watchMultiTickerHelper('watchBidsAsks', 'bookTicker', symbols, params);
@@ -2502,20 +2502,20 @@ export default class binance extends binanceRest {
         future.resolve();
         client.resolve(this.balance[type], type + ':balance');
     }
+    /**
+     * @method
+     * @name binance#fetchBalanceWs
+     * @description fetch balance and get the amount of funds available for trading or funds locked in orders
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/account/websocket-api/Futures-Account-Balance
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#account-information-user_data
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string|undefined} [params.type] 'future', 'delivery', 'savings', 'funding', or 'spot'
+     * @param {string|undefined} [params.marginMode] 'cross' or 'isolated', for margin trading, uses this.options.defaultMarginMode if not passed, defaults to undefined/None/null
+     * @param {string[]|undefined} [params.symbols] unified market symbols, only used in isolated margin mode
+     * @param {string|undefined} [params.method] method to use. Can be account.balance, account.status, v2/account.balance or v2/account.status
+     * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
+     */
     async fetchBalanceWs(params = {}) {
-        /**
-         * @method
-         * @name binance#fetchBalanceWs
-         * @description fetch balance and get the amount of funds available for trading or funds locked in orders
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/account/websocket-api/Futures-Account-Balance
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#account-information-user_data
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string|undefined} [params.type] 'future', 'delivery', 'savings', 'funding', or 'spot'
-         * @param {string|undefined} [params.marginMode] 'cross' or 'isolated', for margin trading, uses this.options.defaultMarginMode if not passed, defaults to undefined/None/null
-         * @param {string[]|undefined} [params.symbols] unified market symbols, only used in isolated margin mode
-         * @param {string|undefined} [params.method] method to use. Can be account.balance, account.status, v2/account.balance or v2/account.status
-         * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
-         */
         await this.loadMarkets();
         const type = this.getMarketType('fetchBalanceWs', undefined, params);
         if (type !== 'spot' && type !== 'future') {
@@ -2610,30 +2610,30 @@ export default class binance extends binanceRest {
         const parsedBalances = this.parseBalanceCustom(result);
         client.resolve(parsedBalances, messageHash);
     }
+    /**
+     * @method
+     * @name binance#fetchPositionWs
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Position-Information
+     * @description fetch data on an open position
+     * @param {string} symbol unified market symbol of the market the position is held in
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} a [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
+     */
     async fetchPositionWs(symbol, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchPositionWs
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Position-Information
-         * @description fetch data on an open position
-         * @param {string} symbol unified market symbol of the market the position is held in
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @returns {object} a [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
-         */
         return await this.fetchPositionsWs([symbol], params);
     }
+    /**
+     * @method
+     * @name binance#fetchPositionsWs
+     * @description fetch all open positions
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Position-Information
+     * @param {string[]} [symbols] list of unified market symbols
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.returnRateLimits] set to true to return rate limit informations, defaults to false.
+     * @param {string|undefined} [params.method] method to use. Can be account.position or v2/account.position
+     * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
+     */
     async fetchPositionsWs(symbols = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchPositionsWs
-         * @description fetch all open positions
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Position-Information
-         * @param {string[]} [symbols] list of unified market symbols
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {boolean} [params.returnRateLimits] set to true to return rate limit informations, defaults to false.
-         * @param {string|undefined} [params.method] method to use. Can be account.position or v2/account.position
-         * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
-         */
         await this.loadMarkets();
         symbols = this.marketSymbols(symbols, 'swap', true, true, true);
         const url = this.urls['api']['ws']['ws-api']['future'];
@@ -2705,15 +2705,15 @@ export default class binance extends binanceRest {
         }
         client.resolve(positions, messageHash);
     }
+    /**
+     * @method
+     * @name binance#watchBalance
+     * @description watch balance and get the amount of funds available for trading or funds locked in orders
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.portfolioMargin] set to true if you would like to watch the balance of a portfolio margin account
+     * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
+     */
     async watchBalance(params = {}) {
-        /**
-         * @method
-         * @name binance#watchBalance
-         * @description watch balance and get the amount of funds available for trading or funds locked in orders
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {boolean} [params.portfolioMargin] set to true if you would like to watch the balance of a portfolio margin account
-         * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
-         */
         await this.loadMarkets();
         await this.authenticate(params);
         const defaultType = this.safeString(this.options, 'defaultType', 'spot');
@@ -2865,23 +2865,23 @@ export default class binance extends binanceRest {
         }
         return type;
     }
+    /**
+     * @method
+     * @name binance#createOrderWs
+     * @description create a trade order
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#place-new-order-trade
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/New-Order
+     * @param {string} symbol unified symbol of the market to create an order in
+     * @param {string} type 'market' or 'limit'
+     * @param {string} side 'buy' or 'sell'
+     * @param {float} amount how much of currency you want to trade in units of base currency
+     * @param {float|undefined} [price] the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} params.test test order, default false
+     * @param {boolean} params.returnRateLimits set to true to return rate limit information, default false
+     * @returns {object} an [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
     async createOrderWs(symbol, type, side, amount, price = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#createOrderWs
-         * @description create a trade order
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#place-new-order-trade
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/New-Order
-         * @param {string} symbol unified symbol of the market to create an order in
-         * @param {string} type 'market' or 'limit'
-         * @param {string} side 'buy' or 'sell'
-         * @param {float} amount how much of currency you want to trade in units of base currency
-         * @param {float|undefined} [price] the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {boolean} params.test test order, default false
-         * @param {boolean} params.returnRateLimits set to true to return rate limit information, default false
-         * @returns {object} an [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const marketType = this.getMarketType('createOrderWs', market, params);
@@ -3013,22 +3013,22 @@ export default class binance extends binanceRest {
         const orders = this.parseOrders(result);
         client.resolve(orders, messageHash);
     }
+    /**
+     * @method
+     * @name binance#editOrderWs
+     * @description edit a trade order
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#cancel-and-replace-order-trade
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Modify-Order
+     * @param {string} id order id
+     * @param {string} symbol unified symbol of the market to create an order in
+     * @param {string} type 'market' or 'limit'
+     * @param {string} side 'buy' or 'sell'
+     * @param {float} amount how much of the currency you want to trade in units of the base currency
+     * @param {float|undefined} [price] the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
+     * @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 editOrderWs(id, symbol, type, side, amount = undefined, price = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#editOrderWs
-         * @description edit a trade order
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#cancel-and-replace-order-trade
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Modify-Order
-         * @param {string} id order id
-         * @param {string} symbol unified symbol of the market to create an order in
-         * @param {string} type 'market' or 'limit'
-         * @param {string} side 'buy' or 'sell'
-         * @param {float} amount how much of the currency you want to trade in units of the base currency
-         * @param {float|undefined} [price] the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @returns {object} an [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const marketType = this.getMarketType('editOrderWs', market, params);
@@ -3169,19 +3169,19 @@ export default class binance extends binanceRest {
         }
         client.resolve(order, messageHash);
     }
+    /**
+     * @method
+     * @name binance#cancelOrderWs
+     * @description cancel multiple orders
+     * @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 {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}
+     */
     async cancelOrderWs(id, symbol = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#cancelOrderWs
-         * @description cancel multiple orders
-         * @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 {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}
-         */
         await this.loadMarkets();
         if (symbol === undefined) {
             throw new BadRequest(this.id + ' cancelOrderWs requires a symbol');
@@ -3215,16 +3215,16 @@ export default class binance extends binanceRest {
         };
         return await this.watch(url, messageHash, message, messageHash, subscription);
     }
+    /**
+     * @method
+     * @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 {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}
+     */
     async cancelAllOrdersWs(symbol = undefined, params = {}) {
-        /**
-         * @method
-         * @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 {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}
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const type = this.getMarketType('cancelAllOrdersWs', market, params);
@@ -3250,17 +3250,18 @@ export default class binance extends binanceRest {
         };
         return await this.watch(url, messageHash, message, messageHash, subscription);
     }
+    /**
+     * @method
+     * @name binance#fetchOrderWs
+     * @description fetches information on an order made by the user
+     * @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
+     * @returns {object} An [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
     async fetchOrderWs(id, symbol = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchOrderWs
-         * @description fetches information on an order made by the user
-         * @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} 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}
-         */
         await this.loadMarkets();
         if (symbol === undefined) {
             throw new BadRequest(this.id + ' cancelOrderWs requires a symbol');
@@ -3296,22 +3297,22 @@ export default class binance extends binanceRest {
         };
         return await this.watch(url, messageHash, message, messageHash, subscription);
     }
+    /**
+     * @method
+     * @name binance#fetchOrdersWs
+     * @description fetches information on multiple orders made by the user
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#query-order-list-user_data
+     * @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
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {int} [params.orderId] order id to begin at
+     * @param {int} [params.startTime] earliest time in ms to retrieve orders for
+     * @param {int} [params.endTime] latest time in ms to retrieve orders for
+     * @param {int} [params.limit] the maximum number of order structures to retrieve
+     * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
     async fetchOrdersWs(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchOrdersWs
-         * @description fetches information on multiple orders made by the user
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#query-order-list-user_data
-         * @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
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {int} [params.orderId] order id to begin at
-         * @param {int} [params.startTime] earliest time in ms to retrieve orders for
-         * @param {int} [params.endTime] latest time in ms to retrieve orders for
-         * @param {int} [params.limit] the maximum number of order structures to retrieve
-         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
-         */
         await this.loadMarkets();
         if (symbol === undefined) {
             throw new BadRequest(this.id + ' fetchOrdersWs requires a symbol');
@@ -3341,18 +3342,18 @@ export default class binance extends binanceRest {
         const orders = await this.watch(url, messageHash, message, messageHash, subscription);
         return this.filterBySymbolSinceLimit(orders, symbol, since, limit);
     }
+    /**
+     * @method
+     * @name binance#fetchClosedOrdersWs
+     * @description fetch closed orders
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#query-order-list-user_data
+     * @param {string} symbol unified market symbol
+     * @param {int} [since] the earliest time in ms to fetch open orders for
+     * @param {int} [limit] the maximum number of open orders structures to retrieve
+     * @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}
+     */
     async fetchClosedOrdersWs(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchClosedOrdersWs
-         * @description fetch closed orders
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#query-order-list-user_data
-         * @param {string} symbol unified market symbol
-         * @param {int} [since] the earliest time in ms to fetch open orders for
-         * @param {int} [limit] the maximum number of open orders structures to retrieve
-         * @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}
-         */
         const orders = await this.fetchOrdersWs(symbol, since, limit, params);
         const closedOrders = [];
         for (let i = 0; i < orders.length; i++) {
@@ -3363,18 +3364,18 @@ export default class binance extends binanceRest {
         }
         return closedOrders;
     }
+    /**
+     * @method
+     * @name binance#fetchOpenOrdersWs
+     * @description fetch all unfilled currently open orders
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#current-open-orders-user_data
+     * @param {string} symbol unified market symbol
+     * @param {int|undefined} [since] the earliest time in ms to fetch open orders for
+     * @param {int|undefined} [limit] the maximum number of open orders structures to retrieve
+     * @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}
+     */
     async fetchOpenOrdersWs(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchOpenOrdersWs
-         * @description fetch all unfilled currently open orders
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#current-open-orders-user_data
-         * @param {string} symbol unified market symbol
-         * @param {int|undefined} [since] the earliest time in ms to fetch open orders for
-         * @param {int|undefined} [limit] the maximum number of open orders structures to retrieve
-         * @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}
-         */
         await this.loadMarkets();
         const market = this.market(symbol);
         const type = this.getMarketType('fetchOpenOrdersWs', market, params);
@@ -3403,22 +3404,22 @@ export default class binance extends binanceRest {
         const orders = await this.watch(url, messageHash, message, messageHash, subscription);
         return this.filterBySymbolSinceLimit(orders, symbol, since, limit);
     }
+    /**
+     * @method
+     * @name binance#watchOrders
+     * @description watches information on multiple orders made by the user
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/user-data-stream#order-update
+     * @see https://developers.binance.com/docs/margin_trading/trade-data-stream/Event-Order-Update
+     * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/user-data-streams/Event-Order-Update
+     * @param {string} symbol unified market symbol of the market the 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 {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string|undefined} [params.marginMode] 'cross' or 'isolated', for spot margin
+     * @param {boolean} [params.portfolioMargin] set to true if you would like to watch portfolio margin account orders
+     * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
+     */
     async watchOrders(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchOrders
-         * @description watches information on multiple orders made by the user
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/user-data-stream#order-update
-         * @see https://developers.binance.com/docs/margin_trading/trade-data-stream/Event-Order-Update
-         * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/user-data-streams/Event-Order-Update
-         * @param {string} symbol unified market symbol of the market the 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 {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {string|undefined} [params.marginMode] 'cross' or 'isolated', for spot margin
-         * @param {boolean} [params.portfolioMargin] set to true if you would like to watch portfolio margin account orders
-         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
-         */
         await this.loadMarkets();
         let messageHash = 'orders';
         let market = undefined;
@@ -3702,16 +3703,18 @@ export default class binance extends binanceRest {
         this.handleOrder(client, message);
         this.handleMyLiquidation(client, message);
     }
+    /**
+     * @method
+     * @name binance#watchPositions
+     * @description watch all open positions
+     * @param {string[]|undefined} symbols list of unified market symbols
+     * @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}
+     */
     async watchPositions(symbols = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchPositions
-         * @description watch all open positions
-         * @param {string[]|undefined} symbols list of unified market symbols
-         * @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}
-         */
         await this.loadMarkets();
         let market = undefined;
         let messageHash = '';
@@ -3924,20 +3927,20 @@ export default class binance extends binanceRest {
             'marginRatio': undefined,
         });
     }
+    /**
+     * @method
+     * @name binance#fetchMyTradesWs
+     * @description fetch all trades made by the user
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#account-trade-history-user_data
+     * @param {string} symbol unified market symbol
+     * @param {int|undefined} [since] the earliest time in ms to fetch trades for
+     * @param {int|undefined} [limit] the maximum number of trades structures to retrieve
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {int} [params.endTime] the latest time in ms to fetch trades for
+     * @param {int} [params.fromId] first trade Id to fetch
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
+     */
     async fetchMyTradesWs(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchMyTradesWs
-         * @description fetch all trades made by the user
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#account-trade-history-user_data
-         * @param {string} symbol unified market symbol
-         * @param {int|undefined} [since] the earliest time in ms to fetch trades for
-         * @param {int|undefined} [limit] the maximum number of trades structures to retrieve
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {int} [params.endTime] the latest time in ms to fetch trades for
-         * @param {int} [params.fromId] first trade Id to fetch
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
-         */
         await this.loadMarkets();
         if (symbol === undefined) {
             throw new BadRequest(this.id + ' fetchMyTradesWs requires a symbol');
@@ -3977,21 +3980,21 @@ export default class binance extends binanceRest {
         const trades = await this.watch(url, messageHash, message, messageHash, subscription);
         return this.filterBySymbolSinceLimit(trades, symbol, since, limit);
     }
+    /**
+     * @method
+     * @name binance#fetchTradesWs
+     * @description fetch all trades made by the user
+     * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#recent-trades
+     * @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, default=500, max=1000
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     *
+     * EXCHANGE SPECIFIC PARAMETERS
+     * @param {int} [params.fromId] trade ID to begin at
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
+     */
     async fetchTradesWs(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#fetchTradesWs
-         * @description fetch all trades made by the user
-         * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#recent-trades
-         * @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, default=500, max=1000
-         * @param {object} [params] extra parameters specific to the exchange API endpoint
-         *
-         * EXCHANGE SPECIFIC PARAMETERS
-         * @param {int} [params.fromId] trade ID to begin at
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
-         */
         await this.loadMarkets();
         if (symbol === undefined) {
             throw new BadRequest(this.id + ' fetchTradesWs () requires a symbol argument');
@@ -4075,18 +4078,18 @@ export default class binance extends binanceRest {
         const trades = this.parseTrades(result);
         client.resolve(trades, messageHash);
     }
+    /**
+     * @method
+     * @name binance#watchMyTrades
+     * @description watches information on multiple trades made by the user
+     * @param {string} 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 {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.portfolioMargin] set to true if you would like to watch trades in a portfolio margin account
+     * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
+     */
     async watchMyTrades(symbol = undefined, since = undefined, limit = undefined, params = {}) {
-        /**
-         * @method
-         * @name binance#watchMyTrades
-         * @description watches information on multiple trades made by the user
-         * @param {string} 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 {object} [params] extra parameters specific to the exchange API endpoint
-         * @param {boolean} [params.portfolioMargin] set to true if you would like to watch trades in a portfolio margin account
-         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=trade-structure}
-         */
         await this.loadMarkets();
         let type = undefined;
         let market = undefined;