ccxt 4.3.43 → 4.3.45

package/dist/cjs/src/xt.js

@@ -20,7 +20,7 @@ class xt extends xt$1 {
             // futures 1000 times per minute for each single IP -> Otherwise account locked for 10min
             'rateLimit': 100,
             'version': 'v4',
-            'certified': true,
+            'certified': false,
             'pro': false,
             'has': {
                 'CORS': false,
@@ -35,6 +35,8 @@ class xt extends xt$1 {
                 'cancelOrder': true,
                 'cancelOrders': true,
                 'createDepositAddress': false,
+                'createMarketBuyOrderWithCost': true,
+                'createMarketSellOrderWithCost': false,
                 'createOrder': true,
                 'createPostOnlyOrder': false,
                 'createReduceOnlyOrder': true,
@@ -851,7 +853,7 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#market2symbol
          * @see https://doc.xt.com/#futures_quotesgetSymbols
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} an array of objects representing market data
+         * @returns {object[]} an array of objects representing market data
          */
         if (this.options['adjustForTimeDifference']) {
             await this.loadTimeDifference();
@@ -1197,7 +1199,7 @@ class xt extends xt$1 {
                 isActive = true;
             }
         }
-        return {
+        return this.safeMarketStructure({
             'id': id,
             'symbol': symbol,
             'base': base,
@@ -1248,7 +1250,7 @@ class xt extends xt$1 {
                 },
             },
             'info': market,
-        };
+        });
     }
     async fetchOHLCV(symbol, timeframe = '1m', since = undefined, limit = undefined, params = {}) {
         /**
@@ -1259,10 +1261,10 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_quotesgetKLine
          * @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|undefined} since timestamp in ms of the earliest candle to fetch
-         * @param {int|undefined} limit the maximum amount of candles to fetch
+         * @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 xt api endpoint
-         * @returns {[[int]]} A list of candles ordered as timestamp, open, high, low, close, volume
+         * @returns {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume
          */
         await this.loadMarkets();
         const market = this.market(symbol);
@@ -1376,7 +1378,7 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_quotesgetDepth
          * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
          * @param {string} symbol unified market symbol to fetch the order book for
-         * @param {int|undefined} limit the maximum amount of order book entries to return
+         * @param {int} [limit] the maximum amount of order book entries to return
          * @param {object} params extra parameters specific to the xt api endpoint
          * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-book-structure} indexed by market symbols
          */
@@ -1544,7 +1546,7 @@ class xt extends xt$1 {
          * @description fetches price tickers for multiple markets, statistical calculations with the information calculated over the past 24 hours each market
          * @see https://doc.xt.com/#market10ticker24h
          * @see https://doc.xt.com/#futures_quotesgetAggTickers
-         * @param {[string]|undefined} symbols unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned
+         * @param {string} [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 xt api endpoint
          * @returns {object} an array of [ticker structures]{@link https://docs.ccxt.com/en/latest/manual.html#ticker-structure}
          */
@@ -1632,7 +1634,7 @@ class xt extends xt$1 {
          * @name xt#fetchBidsAsks
          * @description fetches the bid and ask price and volume for multiple markets
          * @see https://doc.xt.com/#market9tickerBook
-         * @param {[string]|undefined} symbols unified symbols of the markets to fetch the bids and asks for, all markets are returned if not assigned
+         * @param {string} [symbols] unified symbols of the markets to fetch the bids and asks for, all markets are returned if not assigned
          * @param {object} params extra parameters specific to the xt api endpoint
          * @returns {object} a dictionary of [ticker structures]{@link https://docs.ccxt.com/en/latest/manual.html#ticker-structure}
          */
@@ -1754,10 +1756,10 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#market5tradeRecent
          * @see https://doc.xt.com/#futures_quotesgetDeal
          * @param {string} symbol unified market symbol to fetch trades for
-         * @param {int|undefined} since timestamp in ms of the earliest trade to fetch
-         * @param {int|undefined} limit the maximum amount of trades to fetch
+         * @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 xt api endpoint
-         * @returns {[object]} a list of [trade structures]{@link https://docs.ccxt.com/en/latest/manual.html?#public-trades}
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/en/latest/manual.html?#public-trades}
          */
         await this.loadMarkets();
         const market = this.market(symbol);
@@ -1828,11 +1830,11 @@ class xt extends xt$1 {
          * @description fetch all trades made by the user
          * @see https://doc.xt.com/#tradetradeGet
          * @see https://doc.xt.com/#futures_ordergetTrades
-         * @param {string|undefined} symbol unified market symbol to fetch trades for
-         * @param {int|undefined} since timestamp in ms of the earliest trade to fetch
-         * @param {int|undefined} limit the maximum amount of trades to fetch
+         * @param {string} [symbol] unified market symbol 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 xt api endpoint
-         * @returns {[object]} a list of [trade structures]{@link https://docs.ccxt.com/en/latest/manual.html?#public-trades}
+         * @returns {object[]} a list of [trade structures]{@link https://docs.ccxt.com/en/latest/manual.html?#public-trades}
          */
         await this.loadMarkets();
         const request = {};
@@ -2166,6 +2168,24 @@ class xt extends xt$1 {
         }
         return this.safeBalance(result);
     }
+    async createMarketBuyOrderWithCost(symbol, cost, params = {}) {
+        /**
+         * @method
+         * @name xt#createMarketBuyOrderWithCost
+         * @see https://doc.xt.com/#orderorderPost
+         * @description create a market buy order by providing the symbol and cost
+         * @param {string} symbol unified symbol of the market to create an order in
+         * @param {float} cost how much you want to trade in units of the quote currency
+         * @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);
+        if (!market['spot']) {
+            throw new errors.NotSupported(this.id + ' createMarketBuyOrderWithCost() supports spot orders only');
+        }
+        return await this.createOrder(symbol, 'market', 'buy', cost, 1, params);
+    }
     async createOrder(symbol, type, side, amount, price = undefined, params = {}) {
         /**
          * @method
@@ -2179,14 +2199,14 @@ class xt extends xt$1 {
          * @param {string} type 'market' or 'limit'
          * @param {string} side 'buy' or 'sell'
          * @param {float} amount how much you want to trade in units of the base currency
-         * @param {float|undefined} price the price to fulfill the order, in units of the quote currency, can be ignored in market orders
+         * @param {float} [price] the price to fulfill the order, in units of the quote currency, can be ignored in market orders
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {string|undefined} params.timeInForce 'GTC', 'IOC', 'FOK' or 'GTX'
-         * @param {string|undefined} params.entrustType 'TAKE_PROFIT', 'STOP', 'TAKE_PROFIT_MARKET', 'STOP_MARKET', 'TRAILING_STOP_MARKET', required if stopPrice is defined, currently isn't functioning on xt's side
-         * @param {string|undefined} params.triggerPriceType 'INDEX_PRICE', 'MARK_PRICE', 'LATEST_PRICE', required if stopPrice is defined
-         * @param {float|undefined} params.stopPrice price to trigger a stop order
-         * @param {float|undefined} params.stopLoss price to set a stop-loss on an open position
-         * @param {float|undefined} params.takeProfit price to set a take-profit on an open position
+         * @param {string} [params.timeInForce] 'GTC', 'IOC', 'FOK' or 'GTX'
+         * @param {string} [params.entrustType] 'TAKE_PROFIT', 'STOP', 'TAKE_PROFIT_MARKET', 'STOP_MARKET', 'TRAILING_STOP_MARKET', required if stopPrice is defined, currently isn't functioning on xt's side
+         * @param {string} [params.triggerPriceType] 'INDEX_PRICE', 'MARK_PRICE', 'LATEST_PRICE', required if stopPrice is defined
+         * @param {float} [params.stopPrice] price to trigger a stop order
+         * @param {float} [params.stopLoss] price to set a stop-loss on an open position
+         * @param {float} [params.takeProfit] price to set a take-profit on an open position
          * @returns {object} an [order structure]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         await this.loadMarkets();
@@ -2215,20 +2235,29 @@ class xt extends xt$1 {
         if (type === 'market') {
             timeInForce = this.safeStringUpper(params, 'timeInForce', 'FOK');
             if (side === 'buy') {
-                const createMarketBuyOrderRequiresPrice = this.safeValue(this.options, 'createMarketBuyOrderRequiresPrice', true);
+                const cost = this.safeString(params, 'cost');
+                params = this.omit(params, 'cost');
+                const createMarketBuyOrderRequiresPrice = this.safeBool(this.options, 'createMarketBuyOrderRequiresPrice', true);
                 if (createMarketBuyOrderRequiresPrice) {
-                    if (price === undefined) {
-                        throw new errors.InvalidOrder(this.id + ' createOrder() requires a price argument for market buy orders on spot markets to calculate the total amount to spend (amount * price), alternatively set the createMarketBuyOrderRequiresPrice option to false and pass in the cost to spend into the amount parameter');
+                    if (price === undefined && (cost === undefined)) {
+                        throw new errors.InvalidOrder(this.id + ' createOrder() requires a price argument or cost in params for market buy orders on spot markets to calculate the total amount to spend (amount * price), alternatively set the createMarketBuyOrderRequiresPrice option to false and pass in the cost to spend into the amount parameter');
                     }
                     else {
                         const amountString = this.numberToString(amount);
                         const priceString = this.numberToString(price);
-                        const cost = this.parseNumber(Precise["default"].stringMul(amountString, priceString));
-                        request['quoteQty'] = this.costToPrecision(symbol, cost);
+                        let costCalculated = undefined;
+                        if (price !== undefined) {
+                            costCalculated = Precise["default"].stringMul(amountString, priceString);
+                        }
+                        else {
+                            costCalculated = cost;
+                        }
+                        request['quoteQty'] = this.costToPrecision(symbol, costCalculated);
                     }
                 }
                 else {
-                    request['quoteQty'] = this.amountToPrecision(symbol, amount);
+                    const amountCost = (cost !== undefined) ? cost : amount;
+                    request['quoteQty'] = this.costToPrecision(symbol, amountCost);
                 }
             }
         }
@@ -2346,10 +2375,10 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_entrustgetPlanById
          * @see https://doc.xt.com/#futures_entrustgetProfitById
          * @param {string} id order id
-         * @param {string|undefined} symbol unified symbol of the market the order was made in
+         * @param {string} [symbol] unified symbol of the market the order was made in
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @param {bool|undefined} params.stopLossTakeProfit if the order is a stop-loss or take-profit order
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @param {bool} [params.stopLossTakeProfit] if the order is a stop-loss or take-profit order
          * @returns {object} An [order structure]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         await this.loadMarkets();
@@ -2529,12 +2558,12 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#orderhistoryOrderGet
          * @see https://doc.xt.com/#futures_ordergetHistory
          * @see https://doc.xt.com/#futures_entrustgetPlanHistory
-         * @param {string|undefined} symbol unified market symbol of the market the orders were made in
-         * @param {int|undefined} since timestamp in ms of the earliest order
-         * @param {int|undefined} limit the maximum number of order structures to retrieve
+         * @param {string} [symbol] unified market symbol of the market the orders were made in
+         * @param {int} [since] timestamp in ms of the earliest order
+         * @param {int} [limit] the maximum number of order structures to retrieve
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @returns {[object]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         await this.loadMarkets();
         const request = {};
@@ -2977,13 +3006,13 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_ordergetOrders
          * @see https://doc.xt.com/#futures_entrustgetPlan
          * @see https://doc.xt.com/#futures_entrustgetProfit
-         * @param {string|undefined} symbol unified market symbol of the market the orders were made in
-         * @param {int|undefined} since timestamp in ms of the earliest order
-         * @param {int|undefined} limit the maximum number of open order structures to retrieve
+         * @param {string} [symbol] unified market symbol of the market the orders were made in
+         * @param {int} [since] timestamp in ms of the earliest order
+         * @param {int} [limit] the maximum number of open order structures to retrieve
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @param {bool|undefined} params.stopLossTakeProfit if the order is a stop-loss or take-profit order
-         * @returns {[object]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @param {bool} [params.stopLossTakeProfit] if the order is a stop-loss or take-profit order
+         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         return await this.fetchOrdersByStatus('open', symbol, since, limit, params);
     }
@@ -2996,13 +3025,13 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_ordergetOrders
          * @see https://doc.xt.com/#futures_entrustgetPlan
          * @see https://doc.xt.com/#futures_entrustgetProfit
-         * @param {string|undefined} symbol unified market symbol of the market the orders were made in
-         * @param {int|undefined} since timestamp in ms of the earliest order
-         * @param {int|undefined} limit the maximum number of order structures to retrieve
+         * @param {string} [symbol] unified market symbol of the market the orders were made in
+         * @param {int} [since] timestamp in ms of the earliest order
+         * @param {int} [limit] the maximum number of order structures to retrieve
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @param {bool|undefined} params.stopLossTakeProfit if the order is a stop-loss or take-profit order
-         * @returns {[object]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @param {bool} [params.stopLossTakeProfit] if the order is a stop-loss or take-profit order
+         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         return await this.fetchOrdersByStatus('closed', symbol, since, limit, params);
     }
@@ -3015,12 +3044,12 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_ordergetOrders
          * @see https://doc.xt.com/#futures_entrustgetPlan
          * @see https://doc.xt.com/#futures_entrustgetProfit
-         * @param {string|undefined} symbol unified market symbol of the market the orders were made in
-         * @param {int|undefined} since timestamp in ms of the earliest order
-         * @param {int|undefined} limit the maximum number of order structures to retrieve
+         * @param {string} [symbol] unified market symbol of the market the orders were made in
+         * @param {int} [since] timestamp in ms of the earliest order
+         * @param {int} [limit] the maximum number of order structures to retrieve
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @param {bool|undefined} params.stopLossTakeProfit if the order is a stop-loss or take-profit order
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @param {bool} [params.stopLossTakeProfit] if the order is a stop-loss or take-profit order
          * @returns {object} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         return await this.fetchOrdersByStatus('canceled', symbol, since, limit, params);
@@ -3035,10 +3064,10 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_entrustcancelPlan
          * @see https://doc.xt.com/#futures_entrustcancelProfit
          * @param {string} id order id
-         * @param {string|undefined} symbol unified symbol of the market the order was made in
+         * @param {string} [symbol] unified symbol of the market the order was made in
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @param {bool|undefined} params.stopLossTakeProfit if the order is a stop-loss or take-profit order
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @param {bool} [params.stopLossTakeProfit] if the order is a stop-loss or take-profit order
          * @returns {object} An [order structure]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         await this.loadMarkets();
@@ -3124,11 +3153,11 @@ class xt extends xt$1 {
          * @see https://doc.xt.com/#futures_ordercancelBatch
          * @see https://doc.xt.com/#futures_entrustcancelPlanBatch
          * @see https://doc.xt.com/#futures_entrustcancelProfitBatch
-         * @param {string|undefined} symbol unified market symbol of the market to cancel orders in
+         * @param {string} [symbol] unified market symbol of the market to cancel orders in
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @param {bool|undefined} params.stop if the order is a stop trigger order or not
-         * @param {bool|undefined} params.stopLossTakeProfit if the order is a stop-loss or take-profit order
-         * @returns {[object]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
+         * @param {bool} [params.stop] if the order is a stop trigger order or not
+         * @param {bool} [params.stopLossTakeProfit] if the order is a stop-loss or take-profit order
+         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         await this.loadMarkets();
         const request = {};
@@ -3194,7 +3223,9 @@ class xt extends xt$1 {
         //         "result": true
         //     }
         //
-        return response;
+        return [
+            this.safeOrder(response),
+        ];
     }
     async cancelOrders(ids, symbol = undefined, params = {}) {
         /**
@@ -3202,10 +3233,10 @@ class xt extends xt$1 {
          * @name xt#cancelOrders
          * @description cancel multiple orders
          * @see https://doc.xt.com/#orderbatchOrderDel
-         * @param {[string]} ids order ids
-         * @param {string|undefined} symbol unified market symbol of the market to cancel orders in
+         * @param {string[]} ids order ids
+         * @param {string} [symbol] unified market symbol of the market to cancel orders in
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
+         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
          */
         await this.loadMarkets();
         const request = {
@@ -3231,7 +3262,9 @@ class xt extends xt$1 {
         //         "result": null
         //     }
         //
-        return response;
+        return [
+            this.safeOrder(response),
+        ];
     }
     parseOrder(order, market = undefined) {
         //
@@ -3416,9 +3449,9 @@ class xt extends xt$1 {
          * @name xt#fetchLedger
          * @description fetch the history of changes, actions done by the user or operations that altered the balance of the user
          * @see https://doc.xt.com/#futures_usergetBalanceBill
-         * @param {string|undefined} code unified currency code
-         * @param {int|undefined} since timestamp in ms of the earliest ledger entry
-         * @param {int|undefined} limit max number of ledger entries to return
+         * @param {string} [code] unified currency code
+         * @param {int} [since] timestamp in ms of the earliest ledger entry
+         * @param {int} [limit] max number of ledger entries to return
          * @param {object} params extra parameters specific to the xt api endpoint
          * @returns {object} a [ledger structure]{@link https://docs.ccxt.com/en/latest/manual.html#ledger-structure}
          */
@@ -3585,11 +3618,11 @@ class xt extends xt$1 {
          * @name xt#fetchDeposits
          * @description fetch all deposits made to an account
          * @see https://doc.xt.com/#deposit_withdrawalhistoryDepositGet
-         * @param {string|undefined} code unified currency code
-         * @param {int|undefined} since the earliest time in ms to fetch deposits for
-         * @param {int|undefined} limit the maximum number of transaction structures to retrieve
+         * @param {string} [code] unified currency code
+         * @param {int} [since] the earliest time in ms to fetch deposits for
+         * @param {int} [limit] the maximum number of transaction structures to retrieve
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} a list of [transaction structures]{@link https://docs.ccxt.com/en/latest/manual.html#transaction-structure}
+         * @returns {object[]} a list of [transaction structures]{@link https://docs.ccxt.com/en/latest/manual.html#transaction-structure}
          */
         await this.loadMarkets();
         const request = {};
@@ -3641,11 +3674,11 @@ class xt extends xt$1 {
          * @name xt#fetchWithdrawals
          * @description fetch all withdrawals made from an account
          * @see https://doc.xt.com/#deposit_withdrawalwithdrawHistory
-         * @param {string|undefined} code unified currency code
-         * @param {int|undefined} since the earliest time in ms to fetch withdrawals for
-         * @param {int|undefined} limit the maximum number of transaction structures to retrieve
+         * @param {string} [code] unified currency code
+         * @param {int} [since] the earliest time in ms to fetch withdrawals for
+         * @param {int} [limit] the maximum number of transaction structures to retrieve
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} a list of [transaction structures]{@link https://docs.ccxt.com/en/latest/manual.html#transaction-structure}
+         * @returns {object[]} a list of [transaction structures]{@link https://docs.ccxt.com/en/latest/manual.html#transaction-structure}
          */
         await this.loadMarkets();
         const request = {};
@@ -3700,7 +3733,7 @@ class xt extends xt$1 {
          * @param {string} code unified currency code
          * @param {float} amount the amount to withdraw
          * @param {string} address the address to withdraw to
-         * @param {string|undefined} tag
+         * @param {string} [tag]
          * @param {object} params extra parameters specific to the xt api endpoint
          * @returns {object} a [transaction structure]{@link https://docs.ccxt.com/en/latest/manual.html#transaction-structure}
          */
@@ -3807,6 +3840,7 @@ class xt extends xt$1 {
                 'cost': fee,
                 'rate': undefined,
             },
+            'internal': undefined,
         };
     }
     parseTransactionStatus(status) {
@@ -3833,7 +3867,9 @@ class xt extends xt$1 {
          * @param {string} params.positionSide 'LONG' or 'SHORT'
          * @returns {object} response from the exchange
          */
-        this.checkRequiredSymbol('setLeverage', symbol);
+        if (symbol === undefined) {
+            throw new errors.ArgumentsRequired(this.id + ' setLeverage() requires a symbol argument');
+        }
         const positionSide = this.safeString(params, 'positionSide');
         this.checkRequiredArgument('setLeverage', positionSide, 'positionSide', ['LONG', 'SHORT']);
         if ((leverage < 1) || (leverage > 125)) {
@@ -3934,6 +3970,10 @@ class xt extends xt$1 {
             'code': undefined,
             'symbol': this.safeSymbol(undefined, market),
             'status': undefined,
+            'marginMode': undefined,
+            'total': undefined,
+            'timestamp': undefined,
+            'datetime': undefined,
         };
     }
     async fetchLeverageTiers(symbols = undefined, params = {}) {
@@ -3942,7 +3982,7 @@ class xt extends xt$1 {
          * @name xt#fetchLeverageTiers
          * @see https://doc.xt.com/#futures_quotesgetLeverageBrackets
          * @description retrieve information on the maximum leverage for different trade sizes
-         * @param {[string]|undefined} symbols a list of unified market symbols
+         * @param {string} [symbols] a list of unified market symbols
          * @param {object} params extra parameters specific to the xt api endpoint
          * @returns {object} a dictionary of [leverage tiers structures]{@link https://docs.ccxt.com/#/?id=leverage-tiers-structure}
          */
@@ -4110,13 +4150,15 @@ class xt extends xt$1 {
          * @name xt#fetchFundingRateHistory
          * @description fetches historical funding rates
          * @see https://doc.xt.com/#futures_quotesgetFundingRateRecord
-         * @param {string|undefined} symbol unified symbol of the market to fetch the funding rate history for
-         * @param {int|undefined} since timestamp in ms of the earliest funding rate to fetch
-         * @param {int|undefined} limit the maximum amount of [funding rate structures] to fetch
+         * @param {string} [symbol] unified symbol of the market to fetch the funding rate history for
+         * @param {int} [since] timestamp in ms of the earliest funding rate to fetch
+         * @param {int} [limit] the maximum amount of [funding rate structures] to fetch
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} a list of [funding rate structures]{@link https://docs.ccxt.com/en/latest/manual.html?#funding-rate-history-structure}
+         * @returns {object[]} a list of [funding rate structures]{@link https://docs.ccxt.com/en/latest/manual.html?#funding-rate-history-structure}
          */
-        this.checkRequiredSymbol('fetchFundingRateHistory', symbol);
+        if (symbol === undefined) {
+            throw new errors.ArgumentsRequired(this.id + ' fetchFundingRateHistory() requires a symbol argument');
+        }
         await this.loadMarkets();
         const market = this.market(symbol);
         if (!market['swap']) {
@@ -4251,17 +4293,17 @@ class xt extends xt$1 {
             'previousFundingDatetime': undefined,
         };
     }
-    async fetchFundingHistory(symbol, since = undefined, limit = undefined, params = {}) {
+    async fetchFundingHistory(symbol = undefined, since = undefined, limit = undefined, params = {}) {
         /**
          * @method
          * @name xt#fetchFundingHistory
          * @description fetch the funding history
          * @see https://doc.xt.com/#futures_usergetFunding
          * @param {string} symbol unified market symbol
-         * @param {int|undefined} since the starting timestamp in milliseconds
-         * @param {int|undefined} limit the number of entries to return
+         * @param {int} [since] the starting timestamp in milliseconds
+         * @param {int} [limit] the number of entries to return
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} a list of [funding history structures]{@link https://docs.ccxt.com/#/?id=funding-history-structure}
+         * @returns {object[]} a list of [funding history structures]{@link https://docs.ccxt.com/#/?id=funding-history-structure}
          */
         await this.loadMarkets();
         const market = this.market(symbol);
@@ -4410,14 +4452,11 @@ class xt extends xt$1 {
          * @name xt#fetchPositions
          * @description fetch all open positions
          * @see https://doc.xt.com/#futures_usergetPosition
-         * @param {[string]|undefined} symbols list of unified market symbols, not supported with xt
+         * @param {string} [symbols] list of unified market symbols, not supported with xt
          * @param {object} params extra parameters specific to the xt api endpoint
-         * @returns {[object]} a list of [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
+         * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
          */
         await this.loadMarkets();
-        if (symbols !== undefined) {
-            throw new errors.BadRequest(this.id + ' fetchPositions() only supports the symbols argument as undefined');
-        }
         let subType = undefined;
         [subType, params] = this.handleSubTypeAndParams('fetchPositions', undefined, params);
         let response = undefined;
@@ -4460,7 +4499,7 @@ class xt extends xt$1 {
             const marketInner = this.safeMarket(marketId, undefined, undefined, 'contract');
             result.push(this.parsePosition(entry, marketInner));
         }
-        return this.filterByArray(result, 'symbol', undefined, false);
+        return this.filterByArrayPositions(result, 'symbol', symbols, false);
     }
     parsePosition(position, market = undefined) {
         //

package/js/ccxt.d.ts

@@ -4,7 +4,7 @@ import * as functions from './src/base/functions.js';
 import * as errors from './src/base/errors.js';
 import type { Int, int, Str, Strings, Num, Bool, IndexType, OrderSide, OrderType, MarketType, SubType, Dict, NullableDict, List, NullableList, Fee, OHLCV, OHLCVC, implicitReturnType, Market, Currency, Dictionary, MinMax, FeeInterface, TradingFeeInterface, MarketInterface, Trade, Order, OrderBook, Ticker, Transaction, Tickers, CurrencyInterface, Balance, BalanceAccount, Account, PartialBalances, Balances, DepositAddress, WithdrawalResponse, DepositAddressResponse, FundingRate, FundingRates, Position, BorrowInterest, LeverageTier, LedgerEntry, DepositWithdrawFeeNetwork, DepositWithdrawFee, TransferEntry, CrossBorrowRate, IsolatedBorrowRate, FundingRateHistory, OpenInterest, Liquidation, OrderRequest, CancellationRequest, FundingHistory, MarginMode, Greeks, Conversion, Option, LastPrice, Leverage, MarginModification, Leverages, LastPrices, Currencies, TradingFees, MarginModes, OptionChain, IsolatedBorrowRates, CrossBorrowRates, TransferEntries, LeverageTiers } from './src/base/types.js';
 import { BaseError, ExchangeError, AuthenticationError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, OperationRejected, NoChange, MarginModeAlreadySet, MarketClosed, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, AddressPending, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, ContractUnavailable, NotSupported, ProxyError, ExchangeClosedByUser, OperationFailed, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout } from './src/base/errors.js';
-declare const version = "4.3.42";
+declare const version = "4.3.44";
 import ace from './src/ace.js';
 import alpaca from './src/alpaca.js';
 import ascendex from './src/ascendex.js';
@@ -92,6 +92,7 @@ import oceanex from './src/oceanex.js';
 import okcoin from './src/okcoin.js';
 import okx from './src/okx.js';
 import onetrading from './src/onetrading.js';
+import oxfun from './src/oxfun.js';
 import p2b from './src/p2b.js';
 import paymium from './src/paymium.js';
 import phemex from './src/phemex.js';
@@ -107,6 +108,7 @@ import wazirx from './src/wazirx.js';
 import whitebit from './src/whitebit.js';
 import woo from './src/woo.js';
 import woofipro from './src/woofipro.js';
+import xt from './src/xt.js';
 import yobit from './src/yobit.js';
 import zaif from './src/zaif.js';
 import zonda from './src/zonda.js';
@@ -165,6 +167,7 @@ import ndaxPro from './src/pro/ndax.js';
 import okcoinPro from './src/pro/okcoin.js';
 import okxPro from './src/pro/okx.js';
 import onetradingPro from './src/pro/onetrading.js';
+import oxfunPro from './src/pro/oxfun.js';
 import p2bPro from './src/pro/p2b.js';
 import phemexPro from './src/pro/phemex.js';
 import poloniexPro from './src/pro/poloniex.js';
@@ -263,6 +266,7 @@ declare const exchanges: {
     okcoin: typeof okcoin;
     okx: typeof okx;
     onetrading: typeof onetrading;
+    oxfun: typeof oxfun;
     p2b: typeof p2b;
     paymium: typeof paymium;
     phemex: typeof phemex;
@@ -278,6 +282,7 @@ declare const exchanges: {
     whitebit: typeof whitebit;
     woo: typeof woo;
     woofipro: typeof woofipro;
+    xt: typeof xt;
     yobit: typeof yobit;
     zaif: typeof zaif;
     zonda: typeof zonda;
@@ -338,6 +343,7 @@ declare const pro: {
     okcoin: typeof okcoinPro;
     okx: typeof okxPro;
     onetrading: typeof onetradingPro;
+    oxfun: typeof oxfunPro;
     p2b: typeof p2bPro;
     phemex: typeof phemexPro;
     poloniex: typeof poloniexPro;
@@ -410,6 +416,7 @@ declare const ccxt: {
         okcoin: typeof okcoinPro;
         okx: typeof okxPro;
         onetrading: typeof onetradingPro;
+        oxfun: typeof oxfunPro;
         p2b: typeof p2bPro;
         phemex: typeof phemexPro;
         poloniex: typeof poloniexPro;
@@ -509,6 +516,7 @@ declare const ccxt: {
     okcoin: typeof okcoin;
     okx: typeof okx;
     onetrading: typeof onetrading;
+    oxfun: typeof oxfun;
     p2b: typeof p2b;
     paymium: typeof paymium;
     phemex: typeof phemex;
@@ -524,9 +532,10 @@ declare const ccxt: {
     whitebit: typeof whitebit;
     woo: typeof woo;
     woofipro: typeof woofipro;
+    xt: typeof xt;
     yobit: typeof yobit;
     zaif: typeof zaif;
     zonda: typeof zonda;
 } & typeof functions & typeof errors;
-export { version, Exchange, exchanges, pro, Precise, functions, errors, BaseError, ExchangeError, AuthenticationError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, OperationRejected, NoChange, MarginModeAlreadySet, MarketClosed, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, AddressPending, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, ContractUnavailable, NotSupported, ProxyError, ExchangeClosedByUser, OperationFailed, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout, Int, int, Str, Strings, Num, Bool, IndexType, OrderSide, OrderType, MarketType, SubType, Dict, NullableDict, List, NullableList, Fee, OHLCV, OHLCVC, implicitReturnType, Market, Currency, Dictionary, MinMax, FeeInterface, TradingFeeInterface, MarketInterface, Trade, Order, OrderBook, Ticker, Transaction, Tickers, CurrencyInterface, Balance, BalanceAccount, Account, PartialBalances, Balances, DepositAddress, WithdrawalResponse, DepositAddressResponse, FundingRate, FundingRates, Position, BorrowInterest, LeverageTier, LedgerEntry, DepositWithdrawFeeNetwork, DepositWithdrawFee, TransferEntry, CrossBorrowRate, IsolatedBorrowRate, FundingRateHistory, OpenInterest, Liquidation, OrderRequest, CancellationRequest, FundingHistory, MarginMode, Greeks, Conversion, Option, LastPrice, Leverage, MarginModification, Leverages, LastPrices, Currencies, TradingFees, MarginModes, OptionChain, IsolatedBorrowRates, CrossBorrowRates, TransferEntries, LeverageTiers, ace, alpaca, ascendex, bequant, bigone, binance, binancecoinm, binanceus, binanceusdm, bingx, bit2c, bitbank, bitbay, bitbns, bitcoincom, bitfinex, bitfinex2, bitflyer, bitget, bithumb, bitmart, bitmex, bitopro, bitpanda, bitrue, bitso, bitstamp, bitteam, bitvavo, bl3p, blockchaincom, blofin, btcalpha, btcbox, btcmarkets, btcturk, bybit, cex, coinbase, coinbaseadvanced, coinbaseexchange, coinbaseinternational, coincheck, coinex, coinlist, coinmate, coinmetro, coinone, coinsph, coinspot, cryptocom, currencycom, delta, deribit, digifinex, exmo, fmfwio, gate, gateio, gemini, hitbtc, hitbtc3, hollaex, htx, huobi, huobijp, hyperliquid, idex, independentreserve, indodax, kraken, krakenfutures, kucoin, kucoinfutures, kuna, latoken, lbank, luno, lykke, mercado, mexc, ndax, novadax, oceanex, okcoin, okx, onetrading, p2b, paymium, phemex, poloniex, poloniexfutures, probit, timex, tokocrypto, tradeogre, upbit, wavesexchange, wazirx, whitebit, woo, woofipro, yobit, zaif, zonda, };
+export { version, Exchange, exchanges, pro, Precise, functions, errors, BaseError, ExchangeError, AuthenticationError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, OperationRejected, NoChange, MarginModeAlreadySet, MarketClosed, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, AddressPending, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, ContractUnavailable, NotSupported, ProxyError, ExchangeClosedByUser, OperationFailed, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout, Int, int, Str, Strings, Num, Bool, IndexType, OrderSide, OrderType, MarketType, SubType, Dict, NullableDict, List, NullableList, Fee, OHLCV, OHLCVC, implicitReturnType, Market, Currency, Dictionary, MinMax, FeeInterface, TradingFeeInterface, MarketInterface, Trade, Order, OrderBook, Ticker, Transaction, Tickers, CurrencyInterface, Balance, BalanceAccount, Account, PartialBalances, Balances, DepositAddress, WithdrawalResponse, DepositAddressResponse, FundingRate, FundingRates, Position, BorrowInterest, LeverageTier, LedgerEntry, DepositWithdrawFeeNetwork, DepositWithdrawFee, TransferEntry, CrossBorrowRate, IsolatedBorrowRate, FundingRateHistory, OpenInterest, Liquidation, OrderRequest, CancellationRequest, FundingHistory, MarginMode, Greeks, Conversion, Option, LastPrice, Leverage, MarginModification, Leverages, LastPrices, Currencies, TradingFees, MarginModes, OptionChain, IsolatedBorrowRates, CrossBorrowRates, TransferEntries, LeverageTiers, ace, alpaca, ascendex, bequant, bigone, binance, binancecoinm, binanceus, binanceusdm, bingx, bit2c, bitbank, bitbay, bitbns, bitcoincom, bitfinex, bitfinex2, bitflyer, bitget, bithumb, bitmart, bitmex, bitopro, bitpanda, bitrue, bitso, bitstamp, bitteam, bitvavo, bl3p, blockchaincom, blofin, btcalpha, btcbox, btcmarkets, btcturk, bybit, cex, coinbase, coinbaseadvanced, coinbaseexchange, coinbaseinternational, coincheck, coinex, coinlist, coinmate, coinmetro, coinone, coinsph, coinspot, cryptocom, currencycom, delta, deribit, digifinex, exmo, fmfwio, gate, gateio, gemini, hitbtc, hitbtc3, hollaex, htx, huobi, huobijp, hyperliquid, idex, independentreserve, indodax, kraken, krakenfutures, kucoin, kucoinfutures, kuna, latoken, lbank, luno, lykke, mercado, mexc, ndax, novadax, oceanex, okcoin, okx, onetrading, oxfun, p2b, paymium, phemex, poloniex, poloniexfutures, probit, timex, tokocrypto, tradeogre, upbit, wavesexchange, wazirx, whitebit, woo, woofipro, xt, yobit, zaif, zonda, };
 export default ccxt;