ccxt 4.1.72 → 4.1.74

package/js/src/bybit.js

@@ -38,6 +38,8 @@ export default class bybit extends Exchange {
                 'borrowCrossMargin': true,
                 'cancelAllOrders': true,
                 'cancelOrder': true,
+                'createMarketBuyOrderWithCost': true,
+                'createMarketSellOrderWithCost': false,
                 'createOrder': true,
                 'createOrders': true,
                 'createPostOnlyOrder': true,
@@ -3449,6 +3451,25 @@ export default class bybit extends Exchange {
         }
         return this.safeValue(result, 0);
     }
+    async createMarketBuyOrderWithCost(symbol, cost, params = {}) {
+        /**
+         * @method
+         * @name bybit#createMarketBuyOrderWithCost
+         * @see https://bybit-exchange.github.io/docs/v5/order/create-order
+         * @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 NotSupported(this.id + ' createMarketBuyOrderWithCost() supports spot orders only');
+        }
+        params['createMarketBuyOrderRequiresPrice'] = false;
+        return await this.createOrder(symbol, 'market', 'buy', cost, undefined, params);
+    }
     async createOrder(symbol, type, side, amount, price = undefined, params = {}) {
         /**
          * @method
@@ -3549,18 +3570,20 @@ export default class bybit extends Exchange {
         }
         if (market['spot'] && (type === 'market') && (side === 'buy')) {
             // for market buy it requires the amount of quote currency to spend
-            if (this.options['createMarketBuyOrderRequiresPrice']) {
-                const cost = this.safeNumber(params, 'cost');
-                params = this.omit(params, 'cost');
-                if (price === undefined && cost === undefined) {
-                    throw new InvalidOrder(this.id + ' createOrder() requires the price argument with market buy orders to calculate total order cost (amount to spend), where cost = amount * price. Supply a price argument to createOrder() call if you want the cost to be calculated for you from price and amount, or, alternatively, add .options["createMarketBuyOrderRequiresPrice"] = false to supply the cost in the amount argument (the exchange-specific behaviour)');
+            let createMarketBuyOrderRequiresPrice = true;
+            [createMarketBuyOrderRequiresPrice, params] = this.handleOptionAndParams(params, 'createOrder', 'createMarketBuyOrderRequiresPrice', true);
+            const cost = this.safeNumber(params, 'cost');
+            params = this.omit(params, 'cost');
+            if (createMarketBuyOrderRequiresPrice) {
+                if ((price === undefined) && (cost === undefined)) {
+                    throw new InvalidOrder(this.id + ' createOrder() requires the price argument for market buy orders to calculate the total cost to spend (amount * price), alternatively set the createMarketBuyOrderRequiresPrice option or param to false and pass the cost to spend in the amount argument');
                 }
                 else {
                     const amountString = this.numberToString(amount);
                     const priceString = this.numberToString(price);
                     const quoteAmount = Precise.stringMul(amountString, priceString);
-                    amount = (cost !== undefined) ? cost : this.parseNumber(quoteAmount);
-                    request['qty'] = this.costToPrecision(symbol, amount);
+                    const costRequest = (cost !== undefined) ? cost : quoteAmount;
+                    request['qty'] = this.costToPrecision(symbol, costRequest);
                 }
             }
             else {

package/js/src/cex.d.ts

@@ -22,6 +22,7 @@ export default class cex extends Exchange {
     fetchTradingFees(params?: {}): Promise<{}>;
     createOrder(symbol: string, type: OrderType, side: OrderSide, amount: any, price?: any, params?: {}): Promise<Order>;
     cancelOrder(id: string, symbol?: Str, params?: {}): Promise<any>;
+    cancelAllOrders(symbol?: string, params?: {}): Promise<any>;
     parseOrder(order: any, market?: Market): Order;
     fetchOpenOrders(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Order[]>;
     fetchClosedOrders(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<Order[]>;

package/js/src/cex.js

@@ -31,6 +31,7 @@ export default class cex extends Exchange {
                 'future': false,
                 'option': false,
                 'addMargin': false,
+                'cancelAllOrders': true,
                 'cancelOrder': true,
                 'cancelOrders': false,
                 'createDepositAddress': false,
@@ -466,6 +467,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchBalance
+         * @see https://docs.cex.io/#account-balance
          * @description query for balance and get the amount of funds available for trading or funds locked in orders
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
@@ -478,6 +480,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchOrderBook
+         * @see https://docs.cex.io/#orderbook
          * @description fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
          * @param {string} symbol unified symbol of the market to fetch the order book for
          * @param {int} [limit] the maximum amount of order book entries to return
@@ -520,6 +523,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchOHLCV
+         * @see https://docs.cex.io/#historical-ohlcv-chart
          * @description fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market
          * @param {string} symbol unified symbol of the market to fetch OHLCV data for
          * @param {string} timeframe the length of time each candle represents
@@ -625,6 +629,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchTicker
+         * @see https://docs.cex.io/#ticker
          * @description fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
          * @param {string} symbol unified symbol of the market to fetch the ticker for
          * @param {object} [params] extra parameters specific to the exchange API endpoint
@@ -677,6 +682,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchTrades
+         * @see https://docs.cex.io/#trade-history
          * @description get the list of most recent trades for a particular symbol
          * @param {string} symbol unified symbol of the market to fetch trades for
          * @param {int} [since] timestamp in ms of the earliest trade to fetch
@@ -696,6 +702,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchTradingFees
+         * @see https://docs.cex.io/#get-my-fee
          * @description fetch the trading fees for multiple markets
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object} a dictionary of [fee structures]{@link https://docs.ccxt.com/#/?id=fee-structure} indexed by market symbols
@@ -737,6 +744,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#createOrder
+         * @see https://docs.cex.io/#place-order
          * @description create a trade order
          * @see https://cex.io/rest-api#place-order
          * @param {string} symbol unified symbol of the market to create an order in
@@ -820,6 +828,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#cancelOrder
+         * @see https://docs.cex.io/#cancel-order
          * @description cancels an open order
          * @param {string} id order id
          * @param {string} symbol not used by cex cancelOrder ()
@@ -834,6 +843,36 @@ export default class cex extends Exchange {
         // 'true'
         return this.extend(this.parseOrder({}), { 'info': response, 'type': undefined, 'id': id, 'status': 'canceled' });
     }
+    async cancelAllOrders(symbol = undefined, params = {}) {
+        /**
+         * @method
+         * @name cex#cancelAllOrders
+         * @see https://docs.cex.io/#cancel-all-orders-for-given-pair
+         * @description cancel all open orders in a market
+         * @param {string} symbol unified market symbol of the market to cancel orders in
+         * @param {object} [params] extra parameters specific to the cex api endpoint
+         * @param {string} [params.marginMode] 'cross' or 'isolated', for spot margin trading
+         * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
+         */
+        if (symbol === undefined) {
+            throw new ArgumentsRequired(this.id + ' cancelAllOrders requires a symbol.');
+        }
+        await this.loadMarkets();
+        const market = this.market(symbol);
+        const request = {
+            'pair': market['id'],
+        };
+        const orders = await this.privatePostCancelOrdersPair(this.extend(request, params));
+        //
+        //  {
+        //      "e":"cancel_orders",
+        //      "ok":"ok",
+        //      "data":[
+        //      ]
+        //   }
+        //
+        return orders;
+    }
     parseOrder(order, market = undefined) {
         // Depending on the call, 'time' can be a unix int, unix string or ISO string
         // Yes, really
@@ -847,9 +886,9 @@ export default class cex extends Exchange {
             timestamp = parseInt(timestamp);
         }
         let symbol = undefined;
-        if (market === undefined) {
-            const baseId = this.safeString(order, 'symbol1');
-            const quoteId = this.safeString(order, 'symbol2');
+        const baseId = this.safeString(order, 'symbol1');
+        const quoteId = this.safeString(order, 'symbol2');
+        if (market === undefined && baseId !== undefined && quoteId !== undefined) {
             const base = this.safeCurrencyCode(baseId);
             const quote = this.safeCurrencyCode(quoteId);
             if ((base !== undefined) && (quote !== undefined)) {
@@ -1104,6 +1143,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchOpenOrders
+         * @see https://docs.cex.io/#open-orders
          * @description fetch all unfilled currently open orders
          * @param {string} symbol unified market symbol
          * @param {int} [since] the earliest time in ms to fetch open orders for
@@ -1130,6 +1170,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchClosedOrders
+         * @see https://docs.cex.io/#archived-orders
          * @description fetches information on multiple closed orders made by the user
          * @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
@@ -1151,6 +1192,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchOrder
+         * @see https://docs.cex.io/?python#get-order-details
          * @description fetches information on an order made by the user
          * @param {string} symbol not used by cex fetchOrder
          * @param {object} [params] extra parameters specific to the exchange API endpoint
@@ -1268,6 +1310,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchOrders
+         * @see https://docs.cex.io/#archived-orders
          * @description fetches information on multiple orders made by the user
          * @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
@@ -1490,6 +1533,20 @@ export default class cex extends Exchange {
         return this.safeString(this.options['order']['status'], status, status);
     }
     async editOrder(id, symbol, type, side, amount = undefined, price = undefined, params = {}) {
+        /**
+         * @method
+         * @name cex#editOrderWs
+         * @description edit a trade order
+         * @see https://docs.cex.io/#cancel-replace-order
+         * @param {string} id order id
+         * @param {string} symbol unified symbol of the market to create an order in
+         * @param {string} type 'market' or 'limit'
+         * @param {string} side 'buy' or 'sell'
+         * @param {float} amount how much of the currency you want to trade in units of the base currency
+         * @param {float|undefined} [price] the price at which the order is to be fullfilled, in units of the quote currency, ignored in market orders
+         * @param {object} [params] extra parameters specific to the cex api endpoint
+         * @returns {object} an [order structure]{@link https://docs.ccxt.com/en/latest/manual.html#order-structure}
+         */
         if (amount === undefined) {
             throw new ArgumentsRequired(this.id + ' editOrder() requires a amount argument');
         }
@@ -1513,6 +1570,7 @@ export default class cex extends Exchange {
         /**
          * @method
          * @name cex#fetchDepositAddress
+         * @see https://docs.cex.io/#get-crypto-address
          * @description fetch the deposit address for a currency associated with this account
          * @param {string} code unified currency code
          * @param {object} [params] extra parameters specific to the exchange API endpoint

package/js/src/coinex.js

@@ -47,8 +47,8 @@ export default class coinex extends Exchange {
                 'cancelOrder': true,
                 'cancelOrders': true,
                 'createDepositAddress': true,
-                'createOrder': true,
                 'createMarketBuyOrderWithCost': true,
+                'createOrder': true,
                 'createOrders': true,
                 'createReduceOnlyOrder': true,
                 'editOrder': true,

package/js/src/exmo.d.ts

@@ -42,7 +42,7 @@ export default class exmo extends Exchange {
         total: any;
         status: string;
     }>;
-    fetchTradingFees(params?: {}): Promise<any>;
+    fetchTradingFees(params?: {}): Promise<{}>;
     fetchPrivateTradingFees(params?: {}): Promise<{}>;
     fetchPublicTradingFees(params?: {}): Promise<{}>;
     parseFixedFloatValue(input: any): number;

package/js/src/exmo.js

@@ -240,14 +240,13 @@ export default class exmo extends Exchange {
             'position_id': market['id'],
             'quantity': amount,
         };
-        let method = undefined;
+        let response = undefined;
         if (type === 'add') {
-            method = 'privatePostMarginUserPositionMarginAdd';
+            response = await this.privatePostMarginUserPositionMarginAdd(this.extend(request, params));
         }
         else if (type === 'reduce') {
-            method = 'privatePostMarginUserPositionMarginReduce';
+            response = await this.privatePostMarginUserPositionMarginRemove(this.extend(request, params));
         }
-        const response = await this[method](this.extend(request, params));
         //
         //      {}
         //
@@ -306,13 +305,16 @@ export default class exmo extends Exchange {
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object} a dictionary of [fee structures]{@link https://docs.ccxt.com/#/?id=fee-structure} indexed by market symbols
          */
-        let method = this.safeString(params, 'method');
+        const options = this.safeValue(this.options, 'fetchTradingFees', {});
+        const defaultMethod = this.safeString(options, 'method', 'fetchPrivateTradingFees');
+        const method = this.safeString(params, 'method', defaultMethod);
         params = this.omit(params, 'method');
-        if (method === undefined) {
-            const options = this.safeValue(this.options, 'fetchTradingFees', {});
-            method = this.safeString(options, 'method', 'fetchPrivateTradingFees');
+        if (method === 'fetchPrivateTradingFees') {
+            return await this.fetchPrivateTradingFees(params);
+        }
+        else {
+            return await this.fetchPublicTradingFees(params);
         }
-        return await this[method](params);
     }
     async fetchPrivateTradingFees(params = {}) {
         await this.loadMarkets();
@@ -1425,7 +1427,6 @@ export default class exmo extends Exchange {
             // 'client_id': 123, // optional, must be a positive integer
             // 'comment': '', // up to 50 latin symbols, whitespaces, underscores
         };
-        let method = isSpot ? 'privatePostOrderCreate' : 'privatePostMarginUserOrderCreate';
         let clientOrderId = this.safeValue2(params, 'client_id', 'clientOrderId');
         if (clientOrderId !== undefined) {
             clientOrderId = this.safeInteger2(params, 'client_id', 'clientOrderId');
@@ -1441,32 +1442,22 @@ export default class exmo extends Exchange {
             throw new ArgumentsRequired(this.id + ' createOrder requires an extra param params["leverage"] for margin orders');
         }
         params = this.omit(params, ['stopPrice', 'stop_price', 'triggerPrice', 'timeInForce', 'client_id', 'clientOrderId']);
-        if (triggerPrice !== undefined) {
-            if (isSpot) {
+        if (price !== undefined) {
+            request['price'] = this.priceToPrecision(market['symbol'], price);
+        }
+        let response = undefined;
+        if (isSpot) {
+            if (triggerPrice !== undefined) {
                 if (type === 'limit') {
                     throw new BadRequest(this.id + ' createOrder () cannot create stop limit orders for spot, only stop market');
                 }
                 else {
-                    method = 'privatePostStopMarketOrderCreate';
                     request['type'] = side;
                     request['trigger_price'] = this.priceToPrecision(symbol, triggerPrice);
                 }
+                response = await this.privatePostStopMarketOrderCreate(this.extend(request, params));
             }
             else {
-                request['stop_price'] = this.priceToPrecision(symbol, triggerPrice);
-                if (type === 'limit') {
-                    request['type'] = 'stop_limit_' + side;
-                }
-                else if (type === 'market') {
-                    request['type'] = 'stop_' + side;
-                }
-                else {
-                    request['type'] = type;
-                }
-            }
-        }
-        else {
-            if (isSpot) {
                 const execType = this.safeString(params, 'exec_type');
                 let isPostOnly = undefined;
                 [isPostOnly, params] = this.handlePostOnly(type === 'market', execType === 'post_only', params);
@@ -1484,6 +1475,21 @@ export default class exmo extends Exchange {
                 else if (timeInForce !== undefined) {
                     request['exec_type'] = timeInForce;
                 }
+                response = await this.privatePostOrderCreate(this.extend(request, params));
+            }
+        }
+        else {
+            if (triggerPrice !== undefined) {
+                request['stop_price'] = this.priceToPrecision(symbol, triggerPrice);
+                if (type === 'limit') {
+                    request['type'] = 'stop_limit_' + side;
+                }
+                else if (type === 'market') {
+                    request['type'] = 'stop_' + side;
+                }
+                else {
+                    request['type'] = type;
+                }
             }
             else {
                 if (type === 'limit' || type === 'market') {
@@ -1493,11 +1499,8 @@ export default class exmo extends Exchange {
                     request['type'] = type;
                 }
             }
+            response = await this.privatePostMarginUserOrderCreate(this.extend(request, params));
         }
-        if (price !== undefined) {
-            request['price'] = this.priceToPrecision(market['symbol'], price);
-        }
-        const response = await this[method](this.extend(request, params));
         return this.parseOrder(response, market);
     }
     async cancelOrder(id, symbol = undefined, params = {}) {

package/js/src/kraken.js

@@ -196,6 +196,8 @@ export default class kraken extends Exchange {
                         'Withdraw': 3,
                         'WithdrawCancel': 3,
                         'WithdrawInfo': 3,
+                        'WithdrawMethods': 3,
+                        'WithdrawAddresses': 3,
                         'WithdrawStatus': 3,
                         'WalletTransfer': 3,
                         // sub accounts

package/js/src/latoken.d.ts

@@ -18,7 +18,12 @@ export default class latoken extends Exchange {
     fetchTickers(symbols?: Strings, params?: {}): Promise<Tickers>;
     parseTrade(trade: any, market?: Market): Trade;
     fetchTrades(symbol: string, since?: Int, limit?: Int, params?: {}): Promise<Trade[]>;
-    fetchTradingFee(symbol: string, params?: {}): Promise<any>;
+    fetchTradingFee(symbol: string, params?: {}): Promise<{
+        info: any;
+        symbol: string;
+        maker: number;
+        taker: number;
+    }>;
     fetchPublicTradingFee(symbol: string, params?: {}): Promise<{
         info: any;
         symbol: string;

package/js/src/latoken.js

@@ -6,7 +6,7 @@
 
 //  ---------------------------------------------------------------------------
 import Exchange from './abstract/latoken.js';
-import { ExchangeError, AuthenticationError, InvalidNonce, BadRequest, ExchangeNotAvailable, PermissionDenied, AccountSuspended, RateLimitExceeded, InsufficientFunds, BadSymbol, InvalidOrder, ArgumentsRequired } from './base/errors.js';
+import { ExchangeError, AuthenticationError, InvalidNonce, BadRequest, ExchangeNotAvailable, PermissionDenied, AccountSuspended, RateLimitExceeded, InsufficientFunds, BadSymbol, InvalidOrder, ArgumentsRequired, NotSupported } from './base/errors.js';
 import { TICK_SIZE } from './base/functions/number.js';
 import { sha512 } from './static_dependencies/noble-hashes/sha512.js';
 //  ---------------------------------------------------------------------------
@@ -829,13 +829,19 @@ export default class latoken extends Exchange {
          * @param {object} [params] extra parameters specific to the exchange API endpoint
          * @returns {object} a [fee structure]{@link https://docs.ccxt.com/#/?id=fee-structure}
          */
-        let method = this.safeString(params, 'method');
+        const options = this.safeValue(this.options, 'fetchTradingFee', {});
+        const defaultMethod = this.safeString(options, 'method', 'fetchPrivateTradingFee');
+        const method = this.safeString(params, 'method', defaultMethod);
         params = this.omit(params, 'method');
-        if (method === undefined) {
-            const options = this.safeValue(this.options, 'fetchTradingFee', {});
-            method = this.safeString(options, 'method', 'fetchPrivateTradingFee');
+        if (method === 'fetchPrivateTradingFee') {
+            return await this.fetchPrivateTradingFee(symbol, params);
+        }
+        else if (method === 'fetchPublicTradingFee') {
+            return await this.fetchPublicTradingFee(symbol, params);
+        }
+        else {
+            throw new NotSupported(this.id + ' not support this method');
         }
-        return await this[method](symbol, params);
     }
     async fetchPublicTradingFee(symbol, params = {}) {
         await this.loadMarkets();
@@ -901,18 +907,20 @@ export default class latoken extends Exchange {
         // 'from': this.milliseconds (),
         // 'limit': limit, // default '100'
         };
-        let method = 'privateGetAuthTrade';
         let market = undefined;
+        if (limit !== undefined) {
+            request['limit'] = limit; // default 100
+        }
+        let response = undefined;
         if (symbol !== undefined) {
             market = this.market(symbol);
             request['currency'] = market['baseId'];
             request['quote'] = market['quoteId'];
-            method = 'privateGetAuthTradePairCurrencyQuote';
+            response = await this.privateGetAuthTradePairCurrencyQuote(this.extend(request, params));
         }
-        if (limit !== undefined) {
-            request['limit'] = limit; // default 100
+        else {
+            response = await this.privateGetAuthTrade(this.extend(request, params));
         }
-        const response = await this[method](this.extend(request, params));
         //
         //     [
         //         {
@@ -1578,22 +1586,21 @@ export default class latoken extends Exchange {
          */
         await this.loadMarkets();
         const currency = this.currency(code);
-        let method = undefined;
+        const request = {
+            'currency': currency['id'],
+            'recipient': toAccount,
+            'value': this.currencyToPrecision(code, amount),
+        };
+        let response = undefined;
         if (toAccount.indexOf('@') >= 0) {
-            method = 'privatePostAuthTransferEmail';
+            response = await this.privatePostAuthTransferEmail(this.extend(request, params));
         }
         else if (toAccount.length === 36) {
-            method = 'privatePostAuthTransferId';
+            response = await this.privatePostAuthTransferId(this.extend(request, params));
         }
         else {
-            method = 'privatePostAuthTransferPhone';
+            response = await this.privatePostAuthTransferPhone(this.extend(request, params));
         }
-        const request = {
-            'currency': currency['id'],
-            'recipient': toAccount,
-            'value': this.currencyToPrecision(code, amount),
-        };
-        const response = await this[method](this.extend(request, params));
         //
         //     {
         //         "id": "e6fc4ace-7750-44e4-b7e9-6af038ac7107",

package/js/src/okx.d.ts

@@ -52,6 +52,8 @@ export default class okx extends Exchange {
         taker: number;
     }>;
     fetchBalance(params?: {}): Promise<Balances>;
+    createMarketBuyOrderWithCost(symbol: string, cost: any, params?: {}): Promise<Order>;
+    createMarketSellOrderWithCost(symbol: string, cost: any, params?: {}): Promise<Order>;
     createOrderRequest(symbol: string, type: OrderType, side: OrderSide, amount: any, price?: any, params?: {}): any;
     createOrder(symbol: string, type: OrderType, side: OrderSide, amount: any, price?: any, params?: {}): Promise<Order>;
     createOrders(orders: OrderRequest[], params?: {}): Promise<Order[]>;

package/js/src/okx.js

@@ -38,6 +38,8 @@ export default class okx extends Exchange {
                 'cancelOrder': true,
                 'cancelOrders': true,
                 'createDepositAddress': false,
+                'createMarketBuyOrderWithCost': true,
+                'createMarketSellOrderWithCost': true,
                 'createOrder': true,
                 'createOrders': true,
                 'createPostOnlyOrder': true,
@@ -2492,6 +2494,46 @@ export default class okx extends Exchange {
         //
         return this.parseBalanceByType(marketType, response);
     }
+    async createMarketBuyOrderWithCost(symbol, cost, params = {}) {
+        /**
+         * @method
+         * @name okx#createMarketBuyOrderWithCost
+         * @see https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-place-order
+         * @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 NotSupported(this.id + ' createMarketBuyOrderWithCost() supports spot markets only');
+        }
+        params['createMarketBuyOrderRequiresPrice'] = false;
+        params['tgtCcy'] = 'quote_ccy';
+        return await this.createOrder(symbol, 'market', 'buy', cost, undefined, params);
+    }
+    async createMarketSellOrderWithCost(symbol, cost, params = {}) {
+        /**
+         * @method
+         * @name okx#createMarketSellOrderWithCost
+         * @see https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-place-order
+         * @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 NotSupported(this.id + ' createMarketSellOrderWithCost() supports spot markets only');
+        }
+        params['createMarketBuyOrderRequiresPrice'] = false;
+        params['tgtCcy'] = 'quote_ccy';
+        return await this.createOrder(symbol, 'market', 'sell', cost, undefined, params);
+    }
     createOrderRequest(symbol, type, side, amount, price = undefined, params = {}) {
         const market = this.market(symbol);
         const request = {
@@ -2585,8 +2627,10 @@ export default class okx extends Exchange {
                 // see documentation: https://www.okx.com/docs-v5/en/#rest-api-trade-place-order
                 if (tgtCcy === 'quote_ccy') {
                     // quote_ccy: sz refers to units of quote currency
+                    let createMarketBuyOrderRequiresPrice = true;
+                    [createMarketBuyOrderRequiresPrice, params] = this.handleOptionAndParams(params, 'createOrder', 'createMarketBuyOrderRequiresPrice', true);
                     let notional = this.safeNumber2(params, 'cost', 'sz');
-                    const createMarketBuyOrderRequiresPrice = this.safeValue(this.options, 'createMarketBuyOrderRequiresPrice', true);
+                    params = this.omit(params, ['cost', 'sz']);
                     if (createMarketBuyOrderRequiresPrice) {
                         if (price !== undefined) {
                             if (notional === undefined) {
@@ -2604,7 +2648,6 @@ export default class okx extends Exchange {
                         notional = (notional === undefined) ? amount : notional;
                     }
                     request['sz'] = this.costToPrecision(symbol, notional);
-                    params = this.omit(params, ['cost', 'sz']);
                 }
             }
             if (marketIOC && contract) {

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

@@ -1,5 +1,5 @@
 import cexRest from '../cex.js';
-import { Int, Str, Strings } from '../base/types.js';
+import { Int, OrderSide, OrderType, Strings, Str } from '../base/types.js';
 import Client from '../base/ws/Client.js';
 export default class cex extends cexRest {
     describe(): any;
@@ -12,9 +12,11 @@ export default class cex extends cexRest {
     handleTrade(client: Client, message: any): void;
     watchTicker(symbol: string, params?: {}): Promise<any>;
     watchTickers(symbols?: Strings, params?: {}): any;
+    fetchTickerWs(symbol: string, params?: {}): Promise<any>;
     handleTicker(client: Client, message: any): void;
     parseWsTicker(ticker: any, market?: any): import("../base/types.js").Ticker;
-    watchOrders(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<any>;
+    fetchBalanceWs(params?: {}): Promise<any>;
+    watchOrders(symbol?: string, since?: Int, limit?: Int, params?: {}): Promise<any>;
     watchMyTrades(symbol?: Str, since?: Int, limit?: Int, params?: {}): Promise<any>;
     handleTransaction(client: Client, message: any): void;
     handleMyTrades(client: Client, message: any): void;
@@ -35,6 +37,13 @@ export default class cex extends cexRest {
     handleOHLCV24(client: Client, message: any): any;
     handleOHLCV1m(client: Client, message: any): void;
     handleOHLCV(client: Client, message: any): void;
+    fetchOrderWs(id: string, symbol?: string, params?: {}): Promise<import("../base/types.js").Order>;
+    fetchOpenOrdersWs(symbol?: string, since?: Int, limit?: Int, params?: {}): Promise<import("../base/types.js").Order[]>;
+    createOrderWs(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number, params?: {}): Promise<import("../base/types.js").Order>;
+    editOrderWs(id: string, symbol: any, type: any, side: any, amount?: any, price?: any, params?: {}): Promise<import("../base/types.js").Order>;
+    cancelOrderWs(id: string, symbol?: string, params?: {}): Promise<import("../base/types.js").Order>;
+    cancelOrdersWs(ids: any, symbol?: string, params?: {}): Promise<import("../base/types.js").Order[]>;
+    resolveData(client: Client, message: any): void;
     handleConnected(client: Client, message: any): any;
     handleErrorMessage(client: Client, message: any): void;
     handleMessage(client: Client, message: any): any;