ccxt 4.3.73 → 4.3.75

package/js/src/pro/alpaca.js

@@ -52,6 +52,7 @@ export default class alpaca extends alpacaRest {
          * @method
          * @name alpaca#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.alpaca.markets/docs/real-time-crypto-pricing-data#quotes
          * @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}
@@ -127,6 +128,7 @@ export default class alpaca extends alpacaRest {
          * @method
          * @name alpaca#watchOHLCV
          * @description watches historical candlestick data containing the open, high, low, and close price, and the volume of a market
+         * @see https://docs.alpaca.markets/docs/real-time-crypto-pricing-data#bars
          * @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
@@ -183,6 +185,7 @@ export default class alpaca extends alpacaRest {
          * @method
          * @name alpaca#watchOrderBook
          * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+         * @see https://docs.alpaca.markets/docs/real-time-crypto-pricing-data#orderbooks
          * @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
@@ -262,6 +265,7 @@ export default class alpaca extends alpacaRest {
          * @method
          * @name alpaca#watchTrades
          * @description watches information on multiple trades made in a market
+         * @see https://docs.alpaca.markets/docs/real-time-crypto-pricing-data#trades
          * @param {string} symbol unified market symbol of the market trades were made in
          * @param {int} [since] the earliest time in ms to fetch orders for
          * @param {int} [limit] the maximum number of trade structures to retrieve
@@ -314,6 +318,7 @@ export default class alpaca extends alpacaRest {
          * @method
          * @name alpaca#watchMyTrades
          * @description watches information on multiple trades made by the user
+         * @see https://docs.alpaca.markets/docs/websocket-streaming#trade-updates
          * @param {string} symbol unified market symbol of the market trades were made in
          * @param {int} [since] the earliest time in ms to fetch trades for
          * @param {int} [limit] the maximum number of trade structures to retrieve

package/js/src/pro/binance.js

@@ -934,10 +934,15 @@ export default class binance extends binanceRest {
          * @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();
@@ -950,8 +955,9 @@ export default class binance extends binanceRest {
             }
             streamHash += '::' + symbols.join(',');
         }
-        const options = this.safeValue(this.options, 'watchTradesForSymbols', {});
-        const name = this.safeString(options, 'name', 'trade');
+        let name = undefined;
+        [name, params] = this.handleOptionAndParams(params, 'watchTradesForSymbols', 'name', 'trade');
+        params = this.omit(params, 'callerMethodName');
         const firstMarket = this.market(symbols[0]);
         let type = firstMarket['type'];
         if (firstMarket['contract']) {
@@ -991,12 +997,18 @@ export default class binance extends binanceRest {
          * @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);
     }
     parseWsTrade(trade, market = undefined) {
@@ -1258,6 +1270,7 @@ export default class binance extends binanceRest {
         const subscribe = {
             'id': requestId,
         };
+        params = this.omit(params, 'callerMethodName');
         const [symbol, timeframe, candles] = await this.watchMultiple(url, messageHashes, this.extend(request, params), messageHashes, subscribe);
         if (this.newUpdates) {
             limit = candles.getLimit(symbol, limit);

package/js/src/pro/bitfinex.js

@@ -60,6 +60,7 @@ export default class bitfinex extends bitfinexRest {
          * @method
          * @name bitfinex#watchTrades
          * @description get the list of most recent trades for a particular symbol
+         * @see https://docs.bitfinex.com/v1/reference/ws-public-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
@@ -79,6 +80,7 @@ export default class bitfinex extends bitfinexRest {
          * @method
          * @name bitfinex#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.bitfinex.com/v1/reference/ws-public-ticker
          * @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}
@@ -251,6 +253,7 @@ export default class bitfinex extends bitfinexRest {
          * @method
          * @name bitfinex#watchOrderBook
          * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
+         * @see https://docs.bitfinex.com/v1/reference/ws-public-order-books
          * @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
@@ -461,6 +464,8 @@ export default class bitfinex extends bitfinexRest {
          * @method
          * @name bitfinex#watchOrders
          * @description watches information on multiple orders made by the user
+         * @see https://docs.bitfinex.com/v1/reference/ws-auth-order-updates
+         * @see https://docs.bitfinex.com/v1/reference/ws-auth-order-snapshots
          * @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

package/js/src/whitebit.js

@@ -807,8 +807,23 @@ export default class whitebit extends Exchange {
         //        "change": "2.12" // in percent
         //    }
         //
+        // WS market_update
+        //
+        //     {
+        //         "open": "52853.04",
+        //         "close": "55913.88",
+        //         "high": "56272",
+        //         "low": "49549.67",
+        //         "volume": "57331.067185",
+        //         "deal": "3063860382.42985338",
+        //         "last": "55913.88",
+        //         "period": 86400
+        //     }
         market = this.safeMarket(undefined, market);
-        const last = this.safeString(ticker, 'last_price');
+        // last price is provided as "last" or "last_price"
+        const last = this.safeString2(ticker, 'last', 'last_price');
+        // if "close" is provided, use it, otherwise use <last>
+        const close = this.safeString(ticker, 'close', last);
         return this.safeTicker({
             'symbol': market['symbol'],
             'timestamp': undefined,
@@ -821,7 +836,7 @@ export default class whitebit extends Exchange {
             'askVolume': undefined,
             'vwap': undefined,
             'open': this.safeString(ticker, 'open'),
-            'close': last,
+            'close': close,
             'last': last,
             'previousClose': undefined,
             'change': undefined,

package/js/src/woo.js

@@ -147,7 +147,7 @@ export default class woo extends Exchange {
                     'https://support.woo.org/hc/en-001/articles/4404611795353--Trading-Fees',
                 ],
                 'referral': {
-                    'url': 'https://x.woo.org/register?ref=YWOWC96B',
+                    'url': 'https://x.woo.org/register?ref=DIJT0CNL',
                     'discount': 0.35,
                 },
             },

package/js/src/yobit.d.ts

@@ -12,6 +12,7 @@ export default class yobit extends Exchange {
     fetchOrderBook(symbol: string, limit?: Int, params?: {}): Promise<OrderBook>;
     fetchOrderBooks(symbols?: Strings, limit?: Int, params?: {}): Promise<Dictionary<OrderBook>>;
     parseTicker(ticker: Dict, market?: Market): Ticker;
+    fetchTickersHelper(idsString: string, params?: {}): Promise<Tickers>;
     fetchTickers(symbols?: Strings, params?: {}): Promise<Tickers>;
     fetchTicker(symbol: string, params?: {}): Promise<Ticker>;
     parseTrade(trade: Dict, market?: Market): Trade;

package/js/src/yobit.js

@@ -550,6 +550,22 @@ export default class yobit extends Exchange {
             'info': ticker,
         }, market);
     }
+    async fetchTickersHelper(idsString, params = {}) {
+        const request = {
+            'pair': idsString,
+        };
+        const tickers = await this.publicGetTickerPair(this.extend(request, params));
+        const result = {};
+        const keys = Object.keys(tickers);
+        for (let k = 0; k < keys.length; k++) {
+            const id = keys[k];
+            const ticker = tickers[id];
+            const market = this.safeMarket(id);
+            const symbol = market['symbol'];
+            result[symbol] = this.parseTicker(ticker, market);
+        }
+        return result;
+    }
     async fetchTickers(symbols = undefined, params = {}) {
         /**
          * @method
@@ -558,43 +574,53 @@ export default class yobit extends Exchange {
          * @description fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market
          * @param {string[]|undefined} symbols unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned
          * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @param {object} [params.all] you can set to `true` for convenience to fetch all tickers from this exchange by sending multiple requests
          * @returns {object} a dictionary of [ticker structures]{@link https://docs.ccxt.com/#/?id=ticker-structure}
          */
-        if (symbols === undefined) {
-            throw new ArgumentsRequired(this.id + ' fetchTickers() requires "symbols" argument');
+        let allSymbols = undefined;
+        [allSymbols, params] = this.handleParamBool(params, 'all', false);
+        if (symbols === undefined && !allSymbols) {
+            throw new ArgumentsRequired(this.id + ' fetchTickers() requires "symbols" argument or use `params["all"] = true` to send multiple requests for all markets');
         }
         await this.loadMarkets();
-        symbols = this.marketSymbols(symbols);
-        let ids = undefined;
-        if (symbols === undefined) {
-            ids = this.ids;
-        }
-        else {
-            ids = this.marketIds(symbols);
-        }
-        const idsLength = ids.length;
-        const idsString = ids.join('-');
+        const promises = [];
         const maxLength = this.safeInteger(this.options, 'maxUrlLength', 2048);
         // max URL length is 2048 symbols, including http schema, hostname, tld, etc...
-        const lenghtOfBaseUrl = 30; // the url including api-base and endpoint dir is 30 chars
-        const actualLength = idsString.length + lenghtOfBaseUrl;
-        if (actualLength > maxLength) {
-            throw new ArgumentsRequired(this.id + ' fetchTickers() is being requested for ' + idsLength.toString() + ' markets (which has an URL length of ' + actualLength.toString() + ' characters), but it exceedes max URL length (' + maxLength.toString() + '), please pass limisted symbols array to fetchTickers to fit in one request');
+        const lenghtOfBaseUrl = 40; // safe space for the url including api-base and endpoint dir is 30 chars
+        if (allSymbols) {
+            symbols = this.symbols;
+            let ids = '';
+            for (let i = 0; i < this.ids.length; i++) {
+                const id = this.ids[i];
+                const prefix = (ids === '') ? '' : '-';
+                ids += prefix + id;
+                if (ids.length > maxLength) {
+                    promises.push(this.fetchTickersHelper(ids, params));
+                    ids = '';
+                }
+            }
+            if (ids !== '') {
+                promises.push(this.fetchTickersHelper(ids, params));
+            }
         }
-        const request = {
-            'pair': idsString,
-        };
-        const tickers = await this.publicGetTickerPair(this.extend(request, params));
-        const result = {};
-        const keys = Object.keys(tickers);
-        for (let k = 0; k < keys.length; k++) {
-            const id = keys[k];
-            const ticker = tickers[id];
-            const market = this.safeMarket(id);
-            const symbol = market['symbol'];
-            result[symbol] = this.parseTicker(ticker, market);
+        else {
+            symbols = this.marketSymbols(symbols);
+            const ids = this.marketIds(symbols);
+            const idsLength = ids.length;
+            const idsString = ids.join('-');
+            const actualLength = idsString.length + lenghtOfBaseUrl;
+            if (actualLength > maxLength) {
+                throw new ArgumentsRequired(this.id + ' fetchTickers() is being requested for ' + idsLength.toString() + ' markets (which has an URL length of ' + actualLength.toString() + ' characters), but it exceedes max URL length (' + maxLength.toString() + '), please pass limisted symbols array to fetchTickers to fit in one request');
+            }
+            promises.push(this.fetchTickersHelper(idsString, params));
+        }
+        const resultAll = await Promise.all(promises);
+        let finalResult = {};
+        for (let i = 0; i < resultAll.length; i++) {
+            const result = this.filterByArrayTickers(resultAll[i], 'symbol', symbols);
+            finalResult = this.extend(finalResult, result);
         }
-        return this.filterByArrayTickers(result, 'symbol', symbols);
+        return finalResult;
     }
     async fetchTicker(symbol, params = {}) {
         /**

package/package.json

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