ccxt 4.4.31 → 4.4.32

package/dist/cjs/ccxt.js

@@ -197,7 +197,7 @@ var xt$1 = require('./src/pro/xt.js');
 
 //-----------------------------------------------------------------------------
 // this is updated by vss.js when building
-const version = '4.4.31';
+const version = '4.4.32';
 Exchange["default"].ccxtVersion = version;
 const exchanges = {
     'ace': ace,

package/dist/cjs/src/binance.js

@@ -13393,6 +13393,7 @@ class binance extends binance$1 {
     }
     /**
      * @method
+     * @name binance#fetchMarginAdjustmentHistory
      * @description fetches the history of margin added or reduced from contract isolated positions
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/rest-api/Get-Position-Margin-Change-History
      * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/Get-Position-Margin-Change-History

package/dist/cjs/src/bitvavo.js

@@ -1114,10 +1114,6 @@ class bitvavo extends bitvavo$1 {
         if (postOnly) {
             request['postOnly'] = true;
         }
-        const clientOrderId = this.safeString(params, 'clientOrderId');
-        if (clientOrderId === undefined) {
-            request['clientOrderId'] = this.uuid22();
-        }
         return this.extend(request, params);
     }
     /**

package/dist/cjs/src/cex.js

@@ -860,7 +860,7 @@ class cex extends cex$1 {
      * @name cex#fetchOrders
      * @description fetches information on multiple orders made by the user
      * @see https://trade.cex.io/docs/#rest-private-api-calls-orders
-     * @param status
+     * @param {string} status order status to fetch for
      * @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/dist/cjs/src/coincatch.js

@@ -2272,7 +2272,7 @@ class coincatch extends coincatch$1 {
         /**
          * @method
          * @ignore
-         * @name hashkey#createSpotOrderRequest
+         * @name coincatch#createSpotOrderRequest
          * @description helper function to build request
          * @param {string} symbol unified symbol of the market to create an order in
          * @param {string} type 'market' or 'limit'
@@ -2452,7 +2452,7 @@ class coincatch extends coincatch$1 {
         /**
          * @method
          * @ignore
-         * @name hashkey#createSwapOrderRequest
+         * @name coincatch#createSwapOrderRequest
          * @description helper function to build request
          * @param {string} symbol unified symbol of the market to create an order in
          * @param {string} type 'market' or 'limit'
@@ -4619,7 +4619,7 @@ class coincatch extends coincatch$1 {
     }
     /**
      * @method
-     * @name hashkey#setLeverage
+     * @name coincatch#setLeverage
      * @description set the level of leverage for a market
      * @see https://hashkeyglobal-apidoc.readme.io/reference/change-futures-leverage-trade
      * @param {float} leverage the rate of leverage

package/dist/cjs/src/coinex.js

@@ -3390,7 +3390,7 @@ class coinex extends coinex$1 {
      * @see https://docs.coinex.com/api/v2/spot/order/http/list-finished-stop-order
      * @see https://docs.coinex.com/api/v2/futures/order/http/list-finished-order
      * @see https://docs.coinex.com/api/v2/futures/order/http/list-finished-stop-order
-     * @param status
+     * @param {string} status order status to fetch for
      * @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/dist/cjs/src/deribit.js

@@ -3058,8 +3058,8 @@ class deribit extends deribit$1 {
      * @description fetch the current funding rate
      * @see https://docs.deribit.com/#public-get_funding_rate_history
      * @param {string} symbol unified market symbol
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch funding rate history for
+     * @param {int} [limit] the maximum number of entries to retrieve
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @param {int} [params.end_timestamp] fetch funding rate ending at this timestamp
      * @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)

package/dist/cjs/src/gate.js

@@ -897,9 +897,9 @@ class gate extends gate$1 {
         this.options['sandboxMode'] = enable;
     }
     /**
-     * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @method
      * @name gate#isUnifiedEnabled
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @description returns unifiedAccount so the user can check if the unified account is enabled
      * @see https://www.gate.io/docs/developers/apiv4/#get-account-detail
      * @returns {boolean} true or false if the enabled unified account is enabled or not and sets the unifiedAccount option if it is undefined
@@ -3138,6 +3138,8 @@ class gate extends gate$1 {
      * @param {int} [since] timestamp in ms of the earliest funding rate to fetch
      * @param {int} [limit] the maximum amount of [funding rate structures]{@link https://docs.ccxt.com/#/?id=funding-rate-history-structure} to fetch
      * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {int} [params.until] timestamp in ms of the latest funding rate to fetch
+     * @param {boolean} [params.paginate] default false, when true will automatically paginate by calling this endpoint multiple times. See in the docs all the [available parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
      * @returns {object[]} a list of [funding rate structures]{@link https://docs.ccxt.com/#/?id=funding-rate-history-structure}
      */
     async fetchFundingRateHistory(symbol = undefined, since = undefined, limit = undefined, params = {}) {
@@ -3145,15 +3147,29 @@ class gate extends gate$1 {
             throw new errors.ArgumentsRequired(this.id + ' fetchFundingRateHistory() requires a symbol argument');
         }
         await this.loadMarkets();
+        let paginate = false;
+        [paginate, params] = this.handleOptionAndParams(params, 'fetchFundingRateHistory', 'paginate');
+        if (paginate) {
+            return await this.fetchPaginatedCallDeterministic('fetchFundingRateHistory', symbol, since, limit, '8h', params);
+        }
         const market = this.market(symbol);
         if (!market['swap']) {
             throw new errors.BadSymbol(this.id + ' fetchFundingRateHistory() supports swap contracts only');
         }
-        const [request, query] = this.prepareRequest(market, undefined, params);
+        let request = {};
+        [request, params] = this.prepareRequest(market, undefined, params);
         if (limit !== undefined) {
             request['limit'] = limit;
         }
-        const response = await this.publicFuturesGetSettleFundingRate(this.extend(request, query));
+        if (since !== undefined) {
+            request['from'] = this.parseToInt(since / 1000);
+        }
+        const until = this.safeInteger(params, 'until');
+        if (until !== undefined) {
+            params = this.omit(params, 'until');
+            request['to'] = this.parseToInt(until / 1000);
+        }
+        const response = await this.publicFuturesGetSettleFundingRate(this.extend(request, params));
         //
         //     {
         //         "r": "0.00063521",

package/dist/cjs/src/hitbtc.js

@@ -1556,7 +1556,7 @@ class hitbtc extends hitbtc$1 {
      * @name hitbtc#fetchOrderBooks
      * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data for multiple markets
      * @see https://api.hitbtc.com/#order-books
-     * @param {string[]|undefined} symbols list of unified market symbols, all symbols fetched if undefined, default is undefined
+     * @param {string[]} [symbols] list of unified market symbols, all symbols fetched if undefined, default is undefined
      * @param {int} [limit] max number of entries per orderbook to return, default is undefined
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} a dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbol
@@ -3577,8 +3577,8 @@ class hitbtc extends hitbtc$1 {
      * @name hitbtc#closePosition
      * @description closes open positions for a market
      * @see https://api.hitbtc.com/#close-all-futures-margin-positions
-     * @param symbol
-     * @param side
+     * @param {string} symbol unified ccxt market symbol
+     * @param {string} side 'buy' or 'sell'
      * @param {object} [params] extra parameters specific to the okx api endpoint
      * @param {string} [params.symbol] *required* unified market symbol
      * @param {string} [params.marginMode] 'cross' or 'isolated', default is 'cross'

package/dist/cjs/src/htx.js

@@ -3212,7 +3212,7 @@ class htx extends htx$1 {
      * @see https://huobiapi.github.io/docs/spot/v1/en/#get-all-accounts-of-the-current-user
      * @param {string} type 'spot', 'swap' or 'future
      * @param {string} [marginMode] 'cross' or 'isolated'
-     * @param symbol
+     * @param {string} [symbol] unified ccxt market symbol
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} a dictionary of [account structures]{@link https://docs.ccxt.com/#/?id=account-structure} indexed by the account type
      */

package/dist/cjs/src/indodax.js

@@ -20,7 +20,7 @@ class indodax extends indodax$1 {
             'countries': ['ID'],
             // 10 requests per second for making trades => 1000ms / 10 = 100ms
             // 180 requests per minute (public endpoints) = 2 requests per second => cost = (1000ms / rateLimit) / 2 = 5
-            'rateLimit': 100,
+            'rateLimit': 50,
             'has': {
                 'CORS': undefined,
                 'spot': true,

package/dist/cjs/src/kraken.js

@@ -2144,8 +2144,8 @@ class kraken extends kraken$1 {
      * @name kraken#fetchOrdersByIds
      * @description fetch orders by the list of order id
      * @see https://docs.kraken.com/rest/#tag/Account-Data/operation/getClosedOrders
-     * @param {string[]|undefined} ids list of order id
-     * @param symbol
+     * @param {string[]} [ids] list of order id
+     * @param {string} [symbol] unified ccxt market symbol
      * @param {object} [params] extra parameters specific to the kraken api endpoint
      * @returns {object[]} a list of [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
@@ -3068,6 +3068,8 @@ class kraken extends kraken$1 {
         return this.safeString(accountByType, account, account);
     }
     /**
+     * @method
+     * @name kraken#transferOut
      * @description transfer from spot wallet to futures wallet
      * @see https://docs.kraken.com/rest/#tag/User-Funding/operation/walletTransfer
      * @param {str} code Unified currency code

package/dist/cjs/src/krakenfutures.js

@@ -2574,6 +2574,8 @@ class krakenfutures extends krakenfutures$1 {
         }
     }
     /**
+     * @method
+     * @name krakenfutures#transferOut
      * @description transfer from futures wallet to spot wallet
      * @param {str} code Unified currency code
      * @param {float} amount Size of the transfer

package/dist/cjs/src/kucoin.js

@@ -571,6 +571,8 @@ class kucoin extends kucoin$1 {
                     '400303': errors.PermissionDenied,
                     '500000': errors.ExchangeNotAvailable,
                     '260220': errors.InvalidAddress,
+                    '600100': errors.InsufficientFunds,
+                    '600101': errors.InvalidOrder,
                     '900014': errors.BadRequest, // {"code":"900014","msg":"Invalid chainId"}
                 },
                 'broad': {
@@ -1228,9 +1230,9 @@ class kucoin extends kucoin$1 {
         return result;
     }
     /**
-     * @param force
      * @method
      * @name kucoin#loadMigrationStatus
+     * @param {boolean} force load account state for non hf
      * @description loads the migration status for the account (hf or not)
      * @see https://www.kucoin.com/docs/rest/spot-trading/spot-hf-trade-pro-account/get-user-type
      */
@@ -4947,8 +4949,8 @@ class kucoin extends kucoin$1 {
      * @name kucoin#setLeverage
      * @description set the level of leverage for a market
      * @see https://www.kucoin.com/docs/rest/margin-trading/margin-trading-v3-/modify-leverage-multiplier
-     * @param leverage
-     * @param {string} symbol unified market symbol
+     * @param {int } [leverage] New leverage multiplier. Must be greater than 1 and up to two decimal places, and cannot be less than the user's current debt leverage or greater than the system's maximum leverage
+     * @param {string} [symbol] unified market symbol
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} response from the exchange
      */

package/dist/cjs/src/kucoinfutures.js

@@ -1223,8 +1223,8 @@ class kucoinfutures extends kucoinfutures$1 {
      * @description fetches historical positions
      * @see https://www.kucoin.com/docs/rest/futures-trading/positions/get-positions-history
      * @param {string[]} [symbols] list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch position history for
+     * @param {int} [limit] the maximum number of entries to retrieve
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @param {int} [params.until] closing end time
      * @param {int} [params.pageId] page id
@@ -1426,7 +1426,7 @@ class kucoinfutures extends kucoinfutures$1 {
      * @method
      * @name kucoinfutures#createOrder
      * @description Create an order on the exchange
-     * @see https://docs.kucoin.com/futures/#place-an-order
+     * @see https://www.kucoin.com/docs/rest/futures-trading/orders/place-order
      * @see https://www.kucoin.com/docs/rest/futures-trading/orders/place-take-profit-and-stop-loss-order#http-request
      * @param {string} symbol Unified CCXT market symbol
      * @param {string} type 'limit' or 'market'
@@ -1442,6 +1442,7 @@ class kucoinfutures extends kucoinfutures$1 {
      * @param {bool} [params.reduceOnly] A mark to reduce the position size only. Set to false by default. Need to set the position size when reduceOnly is true.
      * @param {string} [params.timeInForce] GTC, GTT, IOC, or FOK, default is GTC, limit orders only
      * @param {string} [params.postOnly] Post only flag, invalid when timeInForce is IOC or FOK
+     * @param {float} [params.cost] the cost of the order in units of USDT
      * ----------------- Exchange Specific Parameters -----------------
      * @param {float} [params.leverage] Leverage size of the order
      * @param {string} [params.clientOid] client order id, defaults to uuid if not passed
@@ -1537,18 +1538,24 @@ class kucoinfutures extends kucoinfutures$1 {
         // required param, cannot be used twice
         const clientOrderId = this.safeString2(params, 'clientOid', 'clientOrderId', this.uuid());
         params = this.omit(params, ['clientOid', 'clientOrderId']);
-        if (amount < 1) {
-            throw new errors.InvalidOrder(this.id + ' createOrder() minimum contract order amount is 1');
-        }
-        const preciseAmount = parseInt(this.amountToPrecision(symbol, amount));
         const request = {
             'clientOid': clientOrderId,
             'side': side,
             'symbol': market['id'],
             'type': type,
-            'size': preciseAmount,
             'leverage': 1,
         };
+        const cost = this.safeString(params, 'cost');
+        params = this.omit(params, 'cost');
+        if (cost !== undefined) {
+            request['valueQty'] = this.costToPrecision(symbol, cost);
+        }
+        else {
+            if (amount < 1) {
+                throw new errors.InvalidOrder(this.id + ' createOrder() minimum contract order amount is 1');
+            }
+            request['size'] = parseInt(this.amountToPrecision(symbol, amount));
+        }
         const [triggerPrice, stopLossPrice, takeProfitPrice] = this.handleTriggerPrices(params);
         const stopLoss = this.safeDict(params, 'stopLoss');
         const takeProfit = this.safeDict(params, 'takeProfit');
@@ -2423,6 +2430,8 @@ class kucoinfutures extends kucoinfutures$1 {
      * @method
      * @name kucoinfutures#transfer
      * @description transfer currency internally between wallets on the same account
+     * @see https://www.kucoin.com/docs/rest/funding/transfer/transfer-to-main-or-trade-account
+     * @see https://www.kucoin.com/docs/rest/funding/transfer/transfer-to-futures-account
      * @param {string} code unified currency code
      * @param {float} amount amount to transfer
      * @param {string} fromAccount account to transfer from
@@ -2431,9 +2440,6 @@ class kucoinfutures extends kucoinfutures$1 {
      * @returns {object} a [transfer structure]{@link https://docs.ccxt.com/#/?id=transfer-structure}
      */
     async transfer(code, amount, fromAccount, toAccount, params = {}) {
-        if ((toAccount !== 'main' && toAccount !== 'funding') || (fromAccount !== 'futures' && fromAccount !== 'future' && fromAccount !== 'contract')) {
-            throw new errors.BadRequest(this.id + ' transfer() only supports transfers from contract(future) account to main(funding) account');
-        }
         await this.loadMarkets();
         const currency = this.currency(code);
         const amountToPrecision = this.currencyToPrecision(code, amount);
@@ -2441,38 +2447,95 @@ class kucoinfutures extends kucoinfutures$1 {
             'currency': this.safeString(currency, 'id'),
             'amount': amountToPrecision,
         };
-        // transfer from usdm futures wallet to spot wallet
-        const response = await this.futuresPrivatePostTransferOut(this.extend(request, params));
-        //
-        //    {
-        //        "code": "200000",
-        //        "data": {
-        //            "applyId": "5bffb63303aa675e8bbe18f9" // Transfer-out request ID
-        //        }
-        //    }
-        //
-        const data = this.safeValue(response, 'data');
+        const toAccountString = this.parseTransferType(toAccount);
+        let response = undefined;
+        if (toAccountString === 'TRADE' || toAccountString === 'MAIN') {
+            request['recAccountType'] = toAccountString;
+            response = await this.futuresPrivatePostTransferOut(this.extend(request, params));
+            //
+            //     {
+            //         "code": "200000",
+            //         "data": {
+            //             "applyId": "6738754373ceee00011ec3f8",
+            //             "bizNo": "6738754373ceee00011ec3f7",
+            //             "payAccountType": "CONTRACT",
+            //             "payTag": "DEFAULT",
+            //             "remark": "",
+            //             "recAccountType": "MAIN",
+            //             "recTag": "DEFAULT",
+            //             "recRemark": "",
+            //             "recSystem": "KUCOIN",
+            //             "status": "PROCESSING",
+            //             "currency": "USDT",
+            //             "amount": "5",
+            //             "fee": "0",
+            //             "sn": 1519769124846692,
+            //             "reason": "",
+            //             "createdAt": 1731753283000,
+            //             "updatedAt": 1731753283000
+            //         }
+            //     }
+            //
+        }
+        else if (toAccount === 'future' || toAccount === 'swap' || toAccount === 'contract') {
+            request['payAccountType'] = this.parseTransferType(fromAccount);
+            response = await this.futuresPrivatePostTransferIn(this.extend(request, params));
+            //
+            //    {
+            //        "code": "200000",
+            //        "data": {
+            //            "applyId": "5bffb63303aa675e8bbe18f9" // Transfer-out request ID
+            //        }
+            //    }
+            //
+        }
+        else {
+            throw new errors.BadRequest(this.id + ' transfer() only supports transfers between future/swap, spot and funding accounts');
+        }
+        const data = this.safeDict(response, 'data', {});
         return this.extend(this.parseTransfer(data, currency), {
             'amount': this.parseNumber(amountToPrecision),
-            'fromAccount': 'future',
-            'toAccount': 'spot',
+            'fromAccount': fromAccount,
+            'toAccount': toAccount,
         });
     }
     parseTransfer(transfer, currency = undefined) {
         //
-        // transfer
+        // transfer to spot or funding account
         //
         //     {
         //            "applyId": "5bffb63303aa675e8bbe18f9" // Transfer-out request ID
         //     }
         //
+        // transfer to future account
+        //
+        //     {
+        //         "applyId": "6738754373ceee00011ec3f8",
+        //         "bizNo": "6738754373ceee00011ec3f7",
+        //         "payAccountType": "CONTRACT",
+        //         "payTag": "DEFAULT",
+        //         "remark": "",
+        //         "recAccountType": "MAIN",
+        //         "recTag": "DEFAULT",
+        //         "recRemark": "",
+        //         "recSystem": "KUCOIN",
+        //         "status": "PROCESSING",
+        //         "currency": "USDT",
+        //         "amount": "5",
+        //         "fee": "0",
+        //         "sn": 1519769124846692,
+        //         "reason": "",
+        //         "createdAt": 1731753283000,
+        //         "updatedAt": 1731753283000
+        //     }
+        //
         const timestamp = this.safeInteger(transfer, 'updatedAt');
         return {
             'id': this.safeString(transfer, 'applyId'),
             'timestamp': timestamp,
             'datetime': this.iso8601(timestamp),
             'currency': this.safeCurrencyCode(undefined, currency),
-            'amount': undefined,
+            'amount': this.safeNumber(transfer, 'amount'),
             'fromAccount': undefined,
             'toAccount': undefined,
             'status': this.safeString(transfer, 'status'),
@@ -2485,6 +2548,13 @@ class kucoinfutures extends kucoinfutures$1 {
         };
         return this.safeString(statuses, status, status);
     }
+    parseTransferType(transferType) {
+        const transferTypes = {
+            'spot': 'TRADE',
+            'funding': 'MAIN',
+        };
+        return this.safeStringUpper(transferTypes, transferType, transferType);
+    }
     /**
      * @method
      * @name kucoinfutures#fetchMyTrades
@@ -2886,6 +2956,7 @@ class kucoinfutures extends kucoinfutures$1 {
         /**
          * @ignore
          * @method
+         * @name kucoinfutures#parseMarketLeverageTiers
          * @param {object} info Exchange market response for 1 market
          * @param {object} market CCXT market
          */
@@ -3127,7 +3198,7 @@ class kucoinfutures extends kucoinfutures$1 {
     }
     /**
      * @method
-     * @name kucoin#fetchLeverage
+     * @name kucoinfutures#fetchLeverage
      * @description fetch the set leverage for a market
      * @see https://www.kucoin.com/docs/rest/futures-trading/positions/get-cross-margin-leverage
      * @param {string} symbol unified market symbol

package/dist/cjs/src/okx.js

@@ -8329,8 +8329,8 @@ class okx extends okx$1 {
      * @see https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-bills-details-last-3-months
      * @param {string} [symbol] not used by okx fetchMarginAdjustmentHistory
      * @param {string} [type] "add" or "reduce"
-     * @param since
-     * @param limit
+     * @param {int} [since] the earliest time in ms to fetch margin adjustment history for
+     * @param {int} [limit] the maximum number of entries to retrieve
      * @param {object} params extra parameters specific to the exchange api endpoint
      * @param {boolean} [params.auto] true if fetching auto margin increases
      * @returns {object[]} a list of [margin structures]{@link https://docs.ccxt.com/#/?id=margin-loan-structure}

package/dist/cjs/src/phemex.js

@@ -488,6 +488,13 @@ class phemex extends phemex$1 {
                 'transfer': {
                     'fillResponseFromRequest': true,
                 },
+                'triggerPriceTypesMap': {
+                    'last': 'ByLastPrice',
+                    'mark': 'ByMarkPrice',
+                    'index': 'ByIndexPrice',
+                    'ask': 'ByAskPrice',
+                    'bid': 'ByBidPrice',
+                },
             },
         });
     }
@@ -2137,6 +2144,7 @@ class phemex extends phemex$1 {
             'PartiallyFilled': 'open',
             'Filled': 'closed',
             'Canceled': 'canceled',
+            'Suspended': 'canceled',
             '1': 'open',
             '2': 'canceled',
             '3': 'closed',
@@ -2643,17 +2651,11 @@ class phemex extends phemex$1 {
                     }
                     const stopLossTriggerPriceType = this.safeString2(stopLoss, 'triggerPriceType', 'slTrigger');
                     if (stopLossTriggerPriceType !== undefined) {
-                        if (market['settle'] === 'USDT') {
-                            if ((stopLossTriggerPriceType !== 'ByMarkPrice') && (stopLossTriggerPriceType !== 'ByLastPrice') && (stopLossTriggerPriceType !== 'ByIndexPrice') && (stopLossTriggerPriceType !== 'ByAskPrice') && (stopLossTriggerPriceType !== 'ByBidPrice') && (stopLossTriggerPriceType !== 'ByMarkPriceLimit') && (stopLossTriggerPriceType !== 'ByLastPriceLimit')) {
-                                throw new errors.InvalidOrder(this.id + ' createOrder() take profit trigger price type must be one of "ByMarkPrice", "ByIndexPrice", "ByAskPrice", "ByBidPrice", "ByMarkPriceLimit", "ByLastPriceLimit" or "ByLastPrice"');
-                            }
-                        }
-                        else {
-                            if ((stopLossTriggerPriceType !== 'ByMarkPrice') && (stopLossTriggerPriceType !== 'ByLastPrice')) {
-                                throw new errors.InvalidOrder(this.id + ' createOrder() take profit trigger price type must be one of "ByMarkPrice", or "ByLastPrice"');
-                            }
-                        }
-                        request['slTrigger'] = stopLossTriggerPriceType;
+                        request['slTrigger'] = this.safeString(this.options['triggerPriceTypesMap'], stopLossTriggerPriceType, stopLossTriggerPriceType);
+                    }
+                    const slLimitPrice = this.safeString(stopLoss, 'price');
+                    if (slLimitPrice !== undefined) {
+                        request['slPxRp'] = this.priceToPrecision(symbol, slLimitPrice);
                     }
                 }
                 if (takeProfitDefined) {
@@ -2667,19 +2669,13 @@ class phemex extends phemex$1 {
                     else {
                         request['takeProfitEp'] = this.toEp(takeProfitTriggerPrice, market);
                     }
-                    const takeProfitTriggerPriceType = this.safeString2(stopLoss, 'triggerPriceType', 'tpTrigger');
+                    const takeProfitTriggerPriceType = this.safeString2(takeProfit, 'triggerPriceType', 'tpTrigger');
                     if (takeProfitTriggerPriceType !== undefined) {
-                        if (market['settle'] === 'USDT') {
-                            if ((takeProfitTriggerPriceType !== 'ByMarkPrice') && (takeProfitTriggerPriceType !== 'ByLastPrice') && (takeProfitTriggerPriceType !== 'ByIndexPrice') && (takeProfitTriggerPriceType !== 'ByAskPrice') && (takeProfitTriggerPriceType !== 'ByBidPrice') && (takeProfitTriggerPriceType !== 'ByMarkPriceLimit') && (takeProfitTriggerPriceType !== 'ByLastPriceLimit')) {
-                                throw new errors.InvalidOrder(this.id + ' createOrder() take profit trigger price type must be one of "ByMarkPrice", "ByIndexPrice", "ByAskPrice", "ByBidPrice", "ByMarkPriceLimit", "ByLastPriceLimit" or "ByLastPrice"');
-                            }
-                        }
-                        else {
-                            if ((takeProfitTriggerPriceType !== 'ByMarkPrice') && (takeProfitTriggerPriceType !== 'ByLastPrice')) {
-                                throw new errors.InvalidOrder(this.id + ' createOrder() take profit trigger price type must be one of "ByMarkPrice", or "ByLastPrice"');
-                            }
-                        }
-                        request['tpTrigger'] = takeProfitTriggerPriceType;
+                        request['tpTrigger'] = this.safeString(this.options['triggerPriceTypesMap'], takeProfitTriggerPriceType, takeProfitTriggerPriceType);
+                    }
+                    const tpLimitPrice = this.safeString(takeProfit, 'price');
+                    if (tpLimitPrice !== undefined) {
+                        request['tpPxRp'] = this.priceToPrecision(symbol, tpLimitPrice);
                     }
                 }
             }

package/dist/cjs/src/pro/binance.js

@@ -218,7 +218,7 @@ class binance extends binance$1 {
      * @description watch the public liquidations of a trading pair
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams
      * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/websocket-market-streams/All-Market-Liquidation-Order-Streams
-     * @param {string[]} symbols
+     * @param {string[]} symbols list of unified market symbols
      * @param {int} [since] the earliest time in ms to fetch liquidations for
      * @param {int} [limit] the maximum number of liquidation structures to retrieve
      * @param {object} [params] exchange specific parameters for the bitmex api endpoint
@@ -439,7 +439,7 @@ class binance extends binance$1 {
      * @description watch the private liquidations of a trading pair
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/user-data-streams/Event-Order-Update
      * @see https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Event-Order-Update
-     * @param symbols
+     * @param {string[]} symbols list of unified market symbols
      * @param {int} [since] the earliest time in ms to fetch liquidations for
      * @param {int} [limit] the maximum number of liquidation structures to retrieve
      * @param {object} [params] exchange specific parameters for the bitmex api endpoint
@@ -3170,7 +3170,7 @@ class binance extends binance$1 {
      * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#cancel-order-trade
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Cancel-Order
      * @param {string} id order id
-     * @param {string} symbol unified market symbol, default is undefined
+     * @param {string} [symbol] unified market symbol, default is undefined
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @param {string|undefined} [params.cancelRestrictions] Supported values: ONLY_NEW - Cancel will succeed if the order status is NEW. ONLY_PARTIALLY_FILLED - Cancel will succeed if order status is PARTIALLY_FILLED.
      * @returns {object} an list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
@@ -3214,7 +3214,7 @@ class binance extends binance$1 {
      * @name binance#cancelAllOrdersWs
      * @description cancel all open orders in a market
      * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#cancel-open-orders-trade
-     * @param {string} symbol unified market symbol of the market to cancel orders in
+     * @param {string} [symbol] unified market symbol of the market to cancel orders in
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
@@ -3251,8 +3251,8 @@ class binance extends binance$1 {
      * @see https://developers.binance.com/docs/binance-spot-api-docs/web-socket-api#query-order-user_data
      * @see https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/websocket-api/Query-Order
      * @param {string} id order id
-     * @param {string} symbol unified symbol of the market the order was made in
-     * @param {object} params extra parameters specific to the exchange API endpoint
+     * @param {string} [symbol] unified symbol of the market the order was made in
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @returns {object} An [order structure]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
     async fetchOrderWs(id, symbol = undefined, params = {}) {
@@ -3702,8 +3702,8 @@ class binance extends binance$1 {
      * @name binance#watchPositions
      * @description watch all open positions
      * @param {string[]|undefined} symbols list of unified market symbols
-     * @param since
-     * @param limit
+     * @param {number} [since] since timestamp
+     * @param {number} [limit] limit
      * @param {object} params extra parameters specific to the exchange API endpoint
      * @param {boolean} [params.portfolioMargin] set to true if you would like to watch positions in a portfolio margin account
      * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}