ccxt 4.2.73 → 4.2.74

package/js/src/bitget.js

@@ -1343,10 +1343,10 @@ export default class bitget extends Exchange {
                 },
                 'fetchOHLCV': {
                     'spot': {
-                        'method': 'publicSpotGetV2SpotMarketCandles', // or publicSpotGetV2SpotMarketHistoryCandles
+                        'method': 'publicSpotGetV2SpotMarketCandles', // publicSpotGetV2SpotMarketCandles or publicSpotGetV2SpotMarketHistoryCandles
                     },
                     'swap': {
-                        'method': 'publicMixGetV2MixMarketCandles', // or publicMixGetV2MixMarketHistoryCandles or publicMixGetV2MixMarketHistoryIndexCandles or publicMixGetV2MixMarketHistoryMarkCandles
+                        'method': 'publicMixGetV2MixMarketCandles', // publicMixGetV2MixMarketCandles or publicMixGetV2MixMarketHistoryCandles or publicMixGetV2MixMarketHistoryIndexCandles or publicMixGetV2MixMarketHistoryMarkCandles
                     },
                     'maxDaysPerTimeframe': {
                         '1m': 30,
@@ -3316,11 +3316,13 @@ export default class bitget extends Exchange {
          * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
          */
         await this.loadMarkets();
-        const maxLimit = 1000; // max 1000
+        const defaultLimit = 100; // default 100, max 1000
+        const maxLimitForRecentEndpoint = 1000;
+        const maxLimitForHistoryEndpoint = 200; // note, max 1000 bars are supported for "recent-candles" endpoint, but "historical-candles" support only max 200
         let paginate = false;
         [paginate, params] = this.handleOptionAndParams(params, 'fetchOHLCV', 'paginate');
         if (paginate) {
-            return await this.fetchPaginatedCallDeterministic('fetchOHLCV', symbol, since, limit, timeframe, params, maxLimit);
+            return await this.fetchPaginatedCallDeterministic('fetchOHLCV', symbol, since, limit, timeframe, params, maxLimitForHistoryEndpoint);
         }
         const sandboxMode = this.safeBool(this.options, 'sandboxMode', false);
         let market = undefined;
@@ -3333,32 +3335,17 @@ export default class bitget extends Exchange {
         }
         const marketType = market['spot'] ? 'spot' : 'swap';
         const timeframes = this.options['timeframes'][marketType];
-        const selectedTimeframe = this.safeString(timeframes, timeframe, timeframe);
+        const msInDay = 86400000;
         const duration = this.parseTimeframe(timeframe) * 1000;
         const request = {
             'symbol': market['id'],
-            'granularity': selectedTimeframe,
+            'granularity': this.safeString(timeframes, timeframe, timeframe),
         };
-        const defaultLimit = 100; // by default, exchange returns 100 items
-        const msInDay = 1000 * 60 * 60 * 24;
-        if (limit !== undefined) {
-            limit = Math.min(limit, maxLimit);
-            request['limit'] = limit;
-        }
         const until = this.safeInteger2(params, 'until', 'till');
+        const limitDefined = limit !== undefined;
+        const sinceDefined = since !== undefined;
+        const untilDefined = until !== undefined;
         params = this.omit(params, ['until', 'till']);
-        if (until !== undefined) {
-            request['endTime'] = until;
-        }
-        if (since !== undefined) {
-            request['startTime'] = since;
-            if (market['spot'] && (until === undefined)) {
-                // for spot we need to send "entTime" too
-                const limitForEnd = (limit !== undefined) ? limit : defaultLimit;
-                const calculatedEnd = this.sum(since, duration * limitForEnd);
-                request['endTime'] = calculatedEnd;
-            }
-        }
         let response = undefined;
         const now = this.milliseconds();
         // retrievable periods listed here:
@@ -3366,21 +3353,47 @@ export default class bitget extends Exchange {
         // - https://www.bitget.com/api-doc/contract/market/Get-Candle-Data#description
         const ohlcOptions = this.safeDict(this.options, 'fetchOHLCV', {});
         const retrievableDaysMap = this.safeDict(ohlcOptions, 'maxDaysPerTimeframe', {});
-        const maxRetrievableDaysForNonHistory = this.safeInteger(retrievableDaysMap, timeframe, 30); // default to safe minimum
-        const endpointTsBoundary = now - maxRetrievableDaysForNonHistory * msInDay;
-        // checks if we need history endpoint
-        let needsHistoryEndpoint = false;
-        const displaceByLimit = (limit === undefined) ? 0 : limit * duration;
-        if (since !== undefined && since < endpointTsBoundary) {
-            // if since it earlier than the allowed diapason
-            needsHistoryEndpoint = true;
-        }
-        else if (until !== undefined && until - displaceByLimit < endpointTsBoundary) {
-            // if until is earlier than the allowed diapason
-            needsHistoryEndpoint = true;
+        const maxRetrievableDaysForRecent = this.safeInteger(retrievableDaysMap, timeframe, 30); // default to safe minimum
+        const endpointTsBoundary = now - maxRetrievableDaysForRecent * msInDay;
+        if (limitDefined) {
+            limit = Math.min(limit, maxLimitForRecentEndpoint);
+            request['limit'] = limit;
         }
+        else {
+            limit = defaultLimit;
+        }
+        const limitMultipliedDuration = limit * duration;
+        // exchange aligns from endTime, so it's important, not startTime
+        // startTime is supported only on "recent" endpoint, not on "historical" endpoint
+        let calculatedStartTime = undefined;
+        let calculatedEndTime = undefined;
+        if (sinceDefined) {
+            calculatedStartTime = since;
+            request['startTime'] = since;
+            if (!untilDefined) {
+                calculatedEndTime = this.sum(calculatedStartTime, limitMultipliedDuration);
+                request['endTime'] = calculatedEndTime;
+            }
+        }
+        if (untilDefined) {
+            calculatedEndTime = until;
+            request['endTime'] = calculatedEndTime;
+            if (!sinceDefined) {
+                calculatedStartTime = calculatedEndTime - limitMultipliedDuration;
+                // we do not need to set "startTime" here
+            }
+        }
+        const historicalEndpointNeeded = (calculatedStartTime !== undefined) && (calculatedStartTime <= endpointTsBoundary);
+        if (historicalEndpointNeeded) {
+            // only for "historical-candles" - ensure we use correct max limit
+            if (limitDefined) {
+                request['limit'] = Math.min(limit, maxLimitForHistoryEndpoint);
+            }
+        }
+        // make request
         if (market['spot']) {
-            if (needsHistoryEndpoint) {
+            // checks if we need history endpoint
+            if (historicalEndpointNeeded) {
                 response = await this.publicSpotGetV2SpotMarketHistoryCandles(this.extend(request, params));
             }
             else {
@@ -3388,19 +3401,18 @@ export default class bitget extends Exchange {
             }
         }
         else {
-            const maxDistanceDaysForContracts = 90; // maximum 90 days allowed between start-end times
-            let distanceError = false;
-            if (limit !== undefined && limit * duration > maxDistanceDaysForContracts * msInDay) {
-                distanceError = true;
-            }
-            else if (since !== undefined && until !== undefined && until - since > maxDistanceDaysForContracts * msInDay) {
-                distanceError = true;
-            }
-            if (distanceError) {
-                throw new BadRequest(this.id + ' fetchOHLCV() between start and end must be less than ' + maxDistanceDaysForContracts.toString() + ' days');
+            const maxDistanceDaysForContracts = 90; // for contract, maximum 90 days allowed between start-end times
+            // only correct the request to fix 90 days if until was auto-calculated
+            if (sinceDefined) {
+                if (!untilDefined) {
+                    request['endTime'] = Math.min(calculatedEndTime, this.sum(since, maxDistanceDaysForContracts * msInDay));
+                }
+                else if (calculatedEndTime - calculatedStartTime > maxDistanceDaysForContracts * msInDay) {
+                    throw new BadRequest(this.id + ' fetchOHLCV() between start and end must be less than ' + maxDistanceDaysForContracts.toString() + ' days');
+                }
             }
-            const priceType = this.safeString(params, 'price');
-            params = this.omit(params, ['price']);
+            let priceType = undefined;
+            [priceType, params] = this.handleParamString(params, 'price');
             let productType = undefined;
             [productType, params] = this.handleProductTypeAndParams(market, params);
             request['productType'] = productType;
@@ -3413,7 +3425,7 @@ export default class bitget extends Exchange {
                 response = await this.publicMixGetV2MixMarketHistoryIndexCandles(extended);
             }
             else {
-                if (needsHistoryEndpoint) {
+                if (historicalEndpointNeeded) {
                     response = await this.publicMixGetV2MixMarketHistoryCandles(extended);
                 }
                 else {

package/js/src/bybit.d.ts

@@ -191,7 +191,6 @@ export default class bybit extends Exchange {
     };
     fetchDerivativesMarketLeverageTiers(symbol: string, params?: {}): Promise<any[]>;
     fetchMarketLeverageTiers(symbol: string, params?: {}): Promise<any[]>;
-    parseMarketLeverageTiers(info: any, market?: Market): any[];
     parseTradingFee(fee: any, market?: Market): {
         info: any;
         symbol: string;
@@ -254,6 +253,9 @@ export default class bybit extends Exchange {
     };
     fetchMyLiquidations(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Liquidation[]>;
     parseLiquidation(liquidation: any, market?: Market): Liquidation;
+    fetchLeverageTiers(symbols?: Strings, params?: {}): Promise<{}>;
+    parseLeverageTiers(response: any, symbols?: Strings, marketIdKey?: any): {};
+    parseMarketLeverageTiers(info: any, market?: Market): any[];
     sign(path: any, api?: string, method?: string, params?: {}, headers?: any, body?: any): {
         url: string;
         method: string;

package/js/src/bybit.js

@@ -82,6 +82,7 @@ export default class bybit extends Exchange {
                 'fetchIsolatedBorrowRates': false,
                 'fetchLedger': true,
                 'fetchLeverage': true,
+                'fetchLeverageTiers': true,
                 'fetchMarketLeverageTiers': true,
                 'fetchMarkets': true,
                 'fetchMarkOHLCV': true,
@@ -7272,36 +7273,6 @@ export default class bybit extends Exchange {
         request['symbol'] = market['id'];
         return await this.fetchDerivativesMarketLeverageTiers(symbol, params);
     }
-    parseMarketLeverageTiers(info, market = undefined) {
-        //
-        //     {
-        //         "id": 1,
-        //         "symbol": "BTCUSD",
-        //         "riskLimitValue": "150",
-        //         "maintenanceMargin": "0.5",
-        //         "initialMargin": "1",
-        //         "isLowestRisk": 1,
-        //         "maxLeverage": "100.00"
-        //     }
-        //
-        let minNotional = 0;
-        const tiers = [];
-        for (let i = 0; i < info.length; i++) {
-            const item = info[i];
-            const maxNotional = this.safeNumber(item, 'riskLimitValue');
-            tiers.push({
-                'tier': this.sum(i, 1),
-                'currency': market['base'],
-                'minNotional': minNotional,
-                'maxNotional': maxNotional,
-                'maintenanceMarginRate': this.safeNumber(item, 'maintenanceMargin'),
-                'maxLeverage': this.safeNumber(item, 'maxLeverage'),
-                'info': item,
-            });
-            minNotional = maxNotional;
-        }
-        return tiers;
-    }
     parseTradingFee(fee, market = undefined) {
         //
         //     {
@@ -8006,6 +7977,95 @@ export default class bybit extends Exchange {
             'datetime': this.iso8601(timestamp),
         });
     }
+    async fetchLeverageTiers(symbols = undefined, params = {}) {
+        /**
+         * @method
+         * @name bybit#fetchLeverageTiers
+         * @see https://bybit-exchange.github.io/docs/v5/market/risk-limit
+         * @description retrieve information on the maximum leverage, for different trade sizes
+         * @param {string[]} [symbols] a list of unified market symbols
+         * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @param {string} [params.subType] market subType, ['linear', 'inverse'], default is 'linear'
+         * @returns {object} a dictionary of [leverage tiers structures]{@link https://docs.ccxt.com/#/?id=leverage-tiers-structure}, indexed by market symbols
+         */
+        await this.loadMarkets();
+        let market = undefined;
+        if (symbols !== undefined) {
+            market = this.market(symbols[0]);
+            if (market['spot']) {
+                throw new NotSupported(this.id + ' fetchLeverageTiers() is not supported for spot market');
+            }
+        }
+        let subType = undefined;
+        [subType, params] = this.handleSubTypeAndParams('fetchTickers', market, params, 'linear');
+        const request = {
+            'category': subType,
+        };
+        const response = await this.publicGetV5MarketRiskLimit(this.extend(request, params));
+        const result = this.safeDict(response, 'result', {});
+        const data = this.safeList(result, 'list', []);
+        symbols = this.marketSymbols(symbols);
+        return this.parseLeverageTiers(data, symbols, 'symbol');
+    }
+    parseLeverageTiers(response, symbols = undefined, marketIdKey = undefined) {
+        //
+        //  [
+        //      {
+        //          "id": 1,
+        //          "symbol": "BTCUSD",
+        //          "riskLimitValue": "150",
+        //          "maintenanceMargin": "0.5",
+        //          "initialMargin": "1",
+        //          "isLowestRisk": 1,
+        //          "maxLeverage": "100.00"
+        //      }
+        //  ]
+        //
+        const tiers = {};
+        const marketIds = this.marketIds(symbols);
+        const filteredResults = this.filterByArray(response, marketIdKey, marketIds, false);
+        const grouped = this.groupBy(filteredResults, marketIdKey);
+        const keys = Object.keys(grouped);
+        for (let i = 0; i < keys.length; i++) {
+            const marketId = keys[i];
+            const entry = grouped[marketId];
+            const market = this.safeMarket(marketId, undefined, undefined, 'contract');
+            const symbol = market['symbol'];
+            tiers[symbol] = this.parseMarketLeverageTiers(entry, market);
+        }
+        return tiers;
+    }
+    parseMarketLeverageTiers(info, market = undefined) {
+        //
+        //  [
+        //      {
+        //          "id": 1,
+        //          "symbol": "BTCUSD",
+        //          "riskLimitValue": "150",
+        //          "maintenanceMargin": "0.5",
+        //          "initialMargin": "1",
+        //          "isLowestRisk": 1,
+        //          "maxLeverage": "100.00"
+        //      }
+        //  ]
+        //
+        const tiers = [];
+        for (let i = 0; i < info.length; i++) {
+            const tier = info[i];
+            const marketId = this.safeString(info, 'symbol');
+            market = this.safeMarket(marketId);
+            tiers.push({
+                'tier': this.safeInteger(tier, 'id'),
+                'currency': market['settle'],
+                'minNotional': undefined,
+                'maxNotional': undefined,
+                'maintenanceMarginRate': this.safeNumber(tier, 'maintenanceMargin'),
+                'maxLeverage': this.safeNumber(tier, 'maxLeverage'),
+                'info': tier,
+            });
+        }
+        return tiers;
+    }
     sign(path, api = 'public', method = 'GET', params = {}, headers = undefined, body = undefined) {
         let url = this.implodeHostname(this.urls['api'][api]) + '/' + path;
         if (api === 'public') {

package/js/src/coinbaseinternational.js

@@ -118,7 +118,7 @@ export default class coinbaseinternational extends Exchange {
                 'test': {
                     'rest': 'https://api-n5e1.coinbase.com/api',
                 },
-                'www': 'https://www.coinbaseinternational.com/international-exchange',
+                'www': 'https://international.coinbase.com',
                 'doc': [
                     'https://docs.cloud.coinbaseinternational.com/intx/docs',
                 ],

package/js/src/htx.js

@@ -952,6 +952,9 @@ export default class htx extends Exchange {
                         },
                     },
                 },
+                'fetchOHLCV': {
+                    'useHistoricalEndpointForSpot': true,
+                },
                 'withdraw': {
                     'includeFee': false,
                 },
@@ -2959,6 +2962,7 @@ export default class htx extends Exchange {
          * @param {int} [limit] the maximum amount of candles to fetch
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
+         * @param {string} [params.useHistoricalEndpointForSpot] true/false - whether use the historical candles endpoint for spot markets or default klines endpoint
          * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
          */
         await this.loadMarkets();
@@ -3065,19 +3069,22 @@ export default class htx extends Exchange {
             }
         }
         else {
-            if (since !== undefined) {
-                request['from'] = this.parseToInt(since / 1000);
-            }
-            if (limit !== undefined) {
-                request['size'] = limit; // max 2000
-            }
             request['symbol'] = market['id'];
-            if (timeframe === '1M' || timeframe === '1y') {
-                // for some reason 1M and 1Y does not work with the regular endpoint
-                // https://github.com/ccxt/ccxt/issues/18006
+            let useHistorical = undefined;
+            [useHistorical, params] = this.handleOptionAndParams(params, 'fetchOHLCV', 'useHistoricalEndpointForSpot', true);
+            if (!useHistorical) {
+                // `limit` only available for the this endpoint
+                if (limit !== undefined) {
+                    request['size'] = limit; // max 2000
+                }
                 response = await this.spotPublicGetMarketHistoryKline(this.extend(request, params));
             }
             else {
+                // `since` only available for the this endpoint
+                if (since !== undefined) {
+                    // default 150 bars
+                    request['from'] = this.parseToInt(since / 1000);
+                }
                 response = await this.spotPublicGetMarketHistoryCandles(this.extend(request, params));
             }
         }

package/js/src/hyperliquid.js

@@ -368,7 +368,7 @@ export default class hyperliquid extends Exchange {
             'optionType': undefined,
             'precision': {
                 'amount': this.parseNumber(this.parsePrecision(this.safeString(market, 'szDecimals'))),
-                'price': this.parseNumber('5'), // significant digits
+                'price': 5, // significant digits
             },
             'limits': {
                 'leverage': {
@@ -850,6 +850,7 @@ export default class hyperliquid extends Exchange {
                     throw new ArgumentsRequired(this.id + '  market orders require price to calculate the max slippage price. Default slippage can be set in options (default is 5%).');
                 }
                 px = (isBuy) ? Precise.stringMul(price, Precise.stringAdd('1', slippage)) : Precise.stringMul(price, Precise.stringSub('1', slippage));
+                px = this.priceToPrecision(symbol, px); // round after adding slippage
             }
             else {
                 px = this.priceToPrecision(symbol, price);

package/js/src/pro/krakenfutures.js

@@ -470,16 +470,17 @@ export default class krakenfutures extends krakenfuturesRest {
             const market = this.market(marketId);
             const symbol = market['symbol'];
             const messageHash = 'trade:' + symbol;
-            let tradesArray = this.safeValue(this.trades, symbol);
-            if (tradesArray === undefined) {
+            if (this.safeList(this.trades, symbol) === undefined) {
                 const tradesLimit = this.safeInteger(this.options, 'tradesLimit', 1000);
-                tradesArray = new ArrayCache(tradesLimit);
-                this.trades[symbol] = tradesArray;
+                this.trades[symbol] = new ArrayCache(tradesLimit);
             }
+            const tradesArray = this.trades[symbol];
             if (channel === 'trade_snapshot') {
-                const trades = this.safeValue(message, 'trades', []);
-                for (let i = 0; i < trades.length; i++) {
-                    const item = trades[i];
+                const trades = this.safeList(message, 'trades', []);
+                const length = trades.length;
+                for (let i = 0; i < length; i++) {
+                    const index = length - 1 - i; // need reverse to correct chronology
+                    const item = trades[index];
                     const trade = this.parseWsTrade(item);
                     tradesArray.append(trade);
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccxt",
-  "version": "4.2.73",
+  "version": "4.2.74",
   "description": "A JavaScript / TypeScript / Python / C# / PHP cryptocurrency trading library with support for 100+ exchanges",
   "unpkg": "dist/ccxt.browser.js",
   "type": "module",
@@ -10,6 +10,9 @@
       "require": "./dist/ccxt.cjs"
     }
   },
+  "bin": {
+    "ccxt": "examples/js/cli.js"
+  },
   "engines": {
     "node": ">=15.0.0"
   },