ccxt 4.3.86 → 4.3.88

package/js/src/pro/ndax.js

@@ -15,6 +15,7 @@ export default class ndax extends ndaxRest {
                 'ws': true,
                 'watchOrderBook': true,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchTicker': true,
                 'watchOHLCV': true,
             },
@@ -43,6 +44,7 @@ export default class ndax extends ndaxRest {
          * @method
          * @name ndax#watchTicker
          * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+         * @see https://apidoc.ndax.io/#subscribelevel1
          * @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}
@@ -108,6 +110,7 @@ export default class ndax extends ndaxRest {
          * @method
          * @name ndax#watchTrades
          * @description get the list of most recent trades for a particular symbol
+         * @see https://apidoc.ndax.io/#subscribetrades
          * @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
@@ -189,6 +192,7 @@ export default class ndax extends ndaxRest {
          * @method
          * @name ndax#watchOHLCV
          * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+         * @see https://apidoc.ndax.io/#subscribeticker
          * @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
@@ -321,6 +325,7 @@ export default class ndax extends ndaxRest {
          * @method
          * @name ndax#watchOrderBook
          * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+         * @see https://apidoc.ndax.io/#subscribelevel2
          * @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

package/js/src/pro/okcoin.js

@@ -20,6 +20,7 @@ export default class okcoin extends okcoinRest {
                 'watchOrderBook': true,
                 'watchOrders': true,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchBalance': true,
                 'watchOHLCV': true,
             },
@@ -70,6 +71,7 @@ export default class okcoin extends okcoinRest {
          * @method
          * @name okcoin#watchTrades
          * @description get the list of most recent trades for a particular symbol
+         * @see https://www.okcoin.com/docs-v5/en/#websocket-api-public-channel-trades-channel
          * @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
@@ -89,6 +91,7 @@ export default class okcoin extends okcoinRest {
          * @method
          * @name okcoin#watchOrders
          * @description watches information on multiple orders made by the user
+         * @see https://www.okcoin.com/docs-v5/en/#websocket-api-private-channel-order-channel
          * @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
@@ -175,6 +178,7 @@ export default class okcoin extends okcoinRest {
          * @method
          * @name okcoin#watchTicker
          * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+         * @see https://www.okcoin.com/docs-v5/en/#websocket-api-public-channel-tickers-channel
          * @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}
@@ -255,6 +259,7 @@ export default class okcoin extends okcoinRest {
          * @method
          * @name okcoin#watchOHLCV
          * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+         * @see https://www.okcoin.com/docs-v5/en/#websocket-api-public-channel-candlesticks-channel
          * @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
@@ -322,6 +327,7 @@ export default class okcoin extends okcoinRest {
          * @method
          * @name okcoin#watchOrderBook
          * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+         * @see https://www.okcoin.com/docs-v5/en/#websocket-api-public-channel-order-book-channel
          * @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
@@ -485,6 +491,7 @@ export default class okcoin extends okcoinRest {
          * @method
          * @name okcoin#watchBalance
          * @description watch balance and get the amount of funds available for trading or funds locked in orders
+         * @see https://www.okcoin.com/docs-v5/en/#websocket-api-private-channel-account-channel
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
          */

package/js/src/pro/onetrading.js

@@ -19,6 +19,7 @@ export default class onetrading extends onetradingRest {
                 'watchTicker': true,
                 'watchTickers': true,
                 'watchTrades': false,
+                'watchTradesForSymbols': false,
                 'watchMyTrades': true,
                 'watchOrders': true,
                 'watchOrderBook': true,

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

@@ -7,6 +7,7 @@ export default class p2b extends p2bRest {
     watchOHLCV(symbol: string, timeframe?: string, since?: Int, limit?: Int, params?: {}): Promise<OHLCV[]>;
     watchTicker(symbol: string, params?: {}): Promise<Ticker>;
     watchTrades(symbol: string, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
+    watchTradesForSymbols(symbols: string[], since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
     watchOrderBook(symbol: string, limit?: Int, params?: {}): Promise<OrderBook>;
     handleOHLCV(client: Client, message: any): any;
     handleTrade(client: Client, message: any): any;

package/js/src/pro/p2b.js

@@ -32,6 +32,7 @@ export default class p2b extends p2bRest {
                 'watchTicker': true,
                 'watchTickers': false,
                 'watchTrades': true,
+                'watchTradesForSymbols': true,
             },
             'urls': {
                 'api': {
@@ -147,15 +148,41 @@ export default class p2b extends p2bRest {
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
          */
+        return await this.watchTradesForSymbols([symbol], since, limit, params);
+    }
+    async watchTradesForSymbols(symbols, since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name p2b#watchTradesForSymbols
+         * @description get the list of most recent trades for a list of symbols
+         * @see https://github.com/P2B-team/P2B-WSS-Public/blob/main/wss_documentation.md#deals
+         * @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
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+         */
         await this.loadMarkets();
-        const market = this.market(symbol);
-        const request = [
-            market['id'],
-        ];
-        const messageHash = 'deals::' + market['symbol'];
-        const trades = await this.subscribe('deals.subscribe', messageHash, request, params);
+        symbols = this.marketSymbols(symbols, undefined, false, true, true);
+        const messageHashes = [];
+        if (symbols !== undefined) {
+            for (let i = 0; i < symbols.length; i++) {
+                messageHashes.push('deals::' + symbols[i]);
+            }
+        }
+        const marketIds = this.marketIds(symbols);
+        const url = this.urls['api']['ws'];
+        const subscribe = {
+            'method': 'deals.subscribe',
+            'params': marketIds,
+            'id': this.milliseconds(),
+        };
+        const query = this.extend(subscribe, params);
+        const trades = await this.watchMultiple(url, messageHashes, query, messageHashes);
         if (this.newUpdates) {
-            limit = trades.getLimit(symbol, limit);
+            const first = this.safeValue(trades, 0);
+            const tradeSymbol = this.safeString(first, 'symbol');
+            limit = trades.getLimit(tradeSymbol, limit);
         }
         return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
     }

package/js/src/pro/paradex.js

@@ -18,6 +18,7 @@ export default class paradex extends paradexRest {
                 'watchOrderBook': true,
                 'watchOrders': false,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchBalance': false,
                 'watchOHLCV': false,
             },

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

@@ -15,6 +15,7 @@ export default class poloniex extends poloniexRest {
     watchTicker(symbol: string, params?: {}): Promise<Ticker>;
     watchTickers(symbols?: Strings, params?: {}): Promise<Tickers>;
     watchTrades(symbol: string, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
+    watchTradesForSymbols(symbols: string[], since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
     watchOrderBook(symbol: string, limit?: Int, params?: {}): Promise<OrderBook>;
     watchOrders(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Order[]>;
     watchMyTrades(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;

package/js/src/pro/poloniex.js

@@ -21,6 +21,7 @@ export default class poloniex extends poloniexRest {
                 'watchTicker': true,
                 'watchTickers': true,
                 'watchTrades': true,
+                'watchTradesForSymbols': true,
                 'watchBalance': true,
                 'watchStatus': false,
                 'watchOrders': true,
@@ -398,12 +399,44 @@ export default class poloniex extends poloniexRest {
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
          */
+        return await this.watchTradesForSymbols([symbol], since, limit, params);
+    }
+    async watchTradesForSymbols(symbols, since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name poloniex#watchTradesForSymbols
+         * @description get the list of most recent trades for a list of symbols
+         * @see https://api-docs.poloniex.com/spot/websocket/market-data#trades
+         * @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
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+         */
         await this.loadMarkets();
-        symbol = this.symbol(symbol);
+        symbols = this.marketSymbols(symbols, undefined, false, true, true);
         const name = 'trades';
-        const trades = await this.subscribe(name, name, false, [symbol], params);
+        const url = this.urls['api']['ws']['public'];
+        const marketIds = this.marketIds(symbols);
+        const subscribe = {
+            'event': 'subscribe',
+            'channel': [
+                name,
+            ],
+            'symbols': marketIds,
+        };
+        const request = this.extend(subscribe, params);
+        const messageHashes = [];
+        if (symbols !== undefined) {
+            for (let i = 0; i < symbols.length; i++) {
+                messageHashes.push(name + '::' + symbols[i]);
+            }
+        }
+        const trades = await this.watchMultiple(url, messageHashes, request, messageHashes);
         if (this.newUpdates) {
-            limit = trades.getLimit(symbol, limit);
+            const first = this.safeValue(trades, 0);
+            const tradeSymbol = this.safeString(first, 'symbol');
+            limit = trades.getLimit(tradeSymbol, limit);
         }
         return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
     }

package/js/src/pro/poloniexfutures.js

@@ -28,6 +28,7 @@ export default class poloniexfutures extends poloniexfuturesRest {
                 'watchTicker': true,
                 'watchTickers': false,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchBalance': true,
                 'watchOrders': true,
                 'watchMyTrades': false,

package/js/src/pro/probit.js

@@ -18,6 +18,7 @@ export default class probit extends probitRest {
                 'watchTicker': true,
                 'watchTickers': false,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchMyTrades': true,
                 'watchOrders': true,
                 'watchOrderBook': true,
@@ -225,6 +226,7 @@ export default class probit extends probitRest {
          * @method
          * @name probit#watchMyTrades
          * @description get the list of trades associated with the user
+         * @see https://docs-en.probit.com/reference/trade_history
          * @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

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

@@ -6,6 +6,7 @@ export default class upbit extends upbitRest {
     watchPublic(symbol: string, channel: any, params?: {}): Promise<any>;
     watchTicker(symbol: string, params?: {}): Promise<Ticker>;
     watchTrades(symbol: string, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
+    watchTradesForSymbols(symbols: string[], since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
     watchOrderBook(symbol: string, limit?: Int, params?: {}): Promise<OrderBook>;
     handleTicker(client: Client, message: any): void;
     handleOrderBook(client: Client, message: any): void;

package/js/src/pro/upbit.js

@@ -18,6 +18,7 @@ export default class upbit extends upbitRest {
                 'watchOrderBook': true,
                 'watchTicker': true,
                 'watchTrades': true,
+                'watchTradesForSymbols': true,
                 'watchOrders': true,
                 'watchMyTrades': true,
                 'watchBalance': true,
@@ -82,11 +83,55 @@ export default class upbit extends upbitRest {
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
          */
+        return await this.watchTradesForSymbols([symbol], since, limit, params);
+    }
+    async watchTradesForSymbols(symbols, since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name upbit#watchTradesForSymbols
+         * @description get the list of most recent trades for a list of symbols
+         * @see https://global-docs.upbit.com/reference/websocket-trade
+         * @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
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/#/?id=public-trades}
+         */
         await this.loadMarkets();
-        symbol = this.symbol(symbol);
-        const trades = await this.watchPublic(symbol, 'trade');
+        symbols = this.marketSymbols(symbols, undefined, false, true, true);
+        const channel = 'trade';
+        const messageHashes = [];
+        const url = this.implodeParams(this.urls['api']['ws'], {
+            'hostname': this.hostname,
+        });
+        if (symbols !== undefined) {
+            for (let i = 0; i < symbols.length; i++) {
+                const market = this.market(symbols[i]);
+                const marketId = market['id'];
+                const symbol = market['symbol'];
+                this.options[channel] = this.safeValue(this.options, channel, {});
+                this.options[channel][symbol] = true;
+                messageHashes.push(channel + ':' + marketId);
+            }
+        }
+        const optionSymbols = Object.keys(this.options[channel]);
+        const marketIds = this.marketIds(optionSymbols);
+        const request = [
+            {
+                'ticket': this.uuid(),
+            },
+            {
+                'type': channel,
+                'codes': marketIds,
+                // 'isOnlySnapshot': false,
+                // 'isOnlyRealtime': false,
+            },
+        ];
+        const trades = await this.watchMultiple(url, messageHashes, request, messageHashes);
         if (this.newUpdates) {
-            limit = trades.getLimit(symbol, limit);
+            const first = this.safeValue(trades, 0);
+            const tradeSymbol = this.safeString(first, 'symbol');
+            limit = trades.getLimit(tradeSymbol, limit);
         }
         return this.filterBySinceLimit(trades, since, limit, 'timestamp', true);
     }

package/js/src/pro/vertex.js

@@ -23,6 +23,7 @@ export default class vertex extends vertexRest {
                 'watchTicker': true,
                 'watchTickers': false,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchPositions': true,
             },
             'urls': {

package/js/src/pro/wazirx.js

@@ -18,6 +18,7 @@ export default class wazirx extends wazirxRest {
                 'watchTicker': true,
                 'watchTickers': true,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
                 'watchMyTrades': true,
                 'watchOrders': true,
                 'watchOrderBook': true,
@@ -287,6 +288,7 @@ export default class wazirx extends wazirxRest {
          * @method
          * @name wazirx#watchTrades
          * @description get the list of most recent trades for a particular symbol
+         * @see https://docs.wazirx.com/#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
@@ -384,6 +386,7 @@ export default class wazirx extends wazirxRest {
          * @method
          * @name wazirx#watchOHLCV
          * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+         * @see https://docs.wazirx.com/#kline-candlestick-stream
          * @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

package/js/src/pro/whitebit.js

@@ -22,6 +22,7 @@ export default class whitebit extends whitebitRest {
                 'watchOrders': true,
                 'watchTicker': true,
                 'watchTrades': true,
+                'watchTradesForSymbols': false,
             },
             'urls': {
                 'api': {
@@ -64,6 +65,7 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchOHLCV
          * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+         * @see https://docs.whitebit.com/public/websocket/#kline
          * @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
@@ -138,6 +140,7 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchOrderBook
          * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+         * @see https://docs.whitebit.com/public/websocket/#market-depth
          * @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
@@ -243,6 +246,7 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchTicker
          * @description watches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+         * @see https://docs.whitebit.com/public/websocket/#market-statistics
          * @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}
@@ -309,6 +313,7 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchTrades
          * @description get the list of most recent trades for a particular symbol
+         * @see https://docs.whitebit.com/public/websocket/#market-trades
          * @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
@@ -375,6 +380,7 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchMyTrades
          * @description watches trades made by the user
+         * @see https://docs.whitebit.com/private/websocket/#deals
          * @param {str} symbol unified market symbol
          * @param {int} [since] the earliest time in ms to fetch trades for
          * @param {int} [limit] the maximum number of trades structures to retrieve
@@ -474,6 +480,7 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchOrders
          * @description watches information on multiple orders made by the user
+         * @see https://docs.whitebit.com/private/websocket/#orders-pending
          * @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
@@ -649,6 +656,8 @@ export default class whitebit extends whitebitRest {
          * @method
          * @name whitebit#watchBalance
          * @description watch balance and get the amount of funds available for trading or funds locked in orders
+         * @see https://docs.whitebit.com/private/websocket/#balance-spot
+         * @see https://docs.whitebit.com/private/websocket/#balance-margin
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @param {str} [params.type] spot or contract if not provided this.options['defaultType'] is used
          * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}

package/js/src/upbit.js

@@ -2004,7 +2004,7 @@ export default class upbit extends Exchange {
                 headers['Content-Type'] = 'application/json';
             }
             if (hasQuery) {
-                auth = this.urlencode(query);
+                auth = this.rawencode(query);
             }
             if (auth !== undefined) {
                 const hash = this.hash(this.encode(auth), sha512);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccxt",
-  "version": "4.3.86",
+  "version": "4.3.88",
   "description": "A JavaScript / TypeScript / Python / C# / PHP cryptocurrency trading library with support for 100+ exchanges",
   "unpkg": "dist/ccxt.browser.min.js",
   "type": "module",