ccxt 4.5.48 → 4.5.50

package/dist/cjs/src/mexc.js

@@ -479,11 +479,6 @@ class mexc extends mexc$1["default"] {
             'options': {
                 'adjustForTimeDifference': false,
                 'timeDifference': 0,
-                'unavailableContracts': {
-                    'BTC/USDT:USDT': true,
-                    'LTC/USDT:USDT': true,
-                    'ETH/USDT:USDT': true,
-                },
                 'fetchMarkets': {
                     'types': {
                         'spot': true,
@@ -2305,6 +2300,7 @@ class mexc extends mexc$1["default"] {
      * @name mexc#createOrder
      * @description create a trade order
      * @see https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+     * @see https://www.mexc.com/api-docs/futures/account-and-trading-endpoints#place-order
      * @see https://mexcdevelop.github.io/apidocs/contract_v1_en/#order-under-maintenance
      * @see https://mexcdevelop.github.io/apidocs/contract_v1_en/#trigger-order-under-maintenance
      * @param {string} symbol unified symbol of the market to create an order in
@@ -2462,6 +2458,7 @@ class mexc extends mexc$1["default"] {
      * @method
      * @name mexc#createSwapOrder
      * @description create a trade order
+     * @see https://www.mexc.com/api-docs/futures/account-and-trading-endpoints#place-order
      * @see https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
      * @see https://mexcdevelop.github.io/apidocs/contract_v1_en/#order-under-maintenance
      * @see https://mexcdevelop.github.io/apidocs/contract_v1_en/#trigger-order-under-maintenance
@@ -2487,11 +2484,6 @@ class mexc extends mexc$1["default"] {
     async createSwapOrder(market, type, side, amount, price = undefined, marginMode = undefined, params = {}) {
         await this.loadMarkets();
         const symbol = market['symbol'];
-        const unavailableContracts = this.safeValue(this.options, 'unavailableContracts', {});
-        const isContractUnavaiable = this.safeBool(unavailableContracts, symbol, false);
-        if (isContractUnavaiable) {
-            throw new errors.NotSupported(this.id + ' createSwapOrder() does not support yet this symbol:' + symbol);
-        }
         let openType = undefined;
         if (marginMode !== undefined) {
             if (marginMode === 'cross') {
@@ -2562,14 +2554,17 @@ class mexc extends mexc$1["default"] {
         if (hedged) {
             if (reduceOnly) {
                 params = this.omit(params, 'reduceOnly'); // hedged mode does not accept this parameter
-                side = (side === 'buy') ? 'sell' : 'buy';
+                sideInteger = (side === 'buy') ? 4 : 2; // close short, close long
+            }
+            else {
+                sideInteger = (side === 'buy') ? 1 : 3;
             }
-            sideInteger = (side === 'buy') ? 1 : 3;
             request['positionMode'] = 1;
         }
         else {
             if (reduceOnly) {
                 sideInteger = (side === 'buy') ? 2 : 4;
+                params = this.omit(params, 'reduceOnly');
             }
             else {
                 sideInteger = (side === 'buy') ? 1 : 3;

package/dist/cjs/src/okx.js

@@ -206,6 +206,7 @@ class okx extends okx$1["default"] {
                         'market/option/instrument-family-trades': 1,
                         'market/platform-24-volume': 10,
                         'market/call-auction-detail': 1,
+                        'market/call-auction-details': 1,
                         'market/books-sbe': 10,
                         'market/block-tickers': 1,
                         'market/block-ticker': 1,
@@ -246,6 +247,9 @@ class okx extends okx$1["default"] {
                         'public/premium-history': 1,
                         'public/economic-calendar': 50,
                         'public/market-data-history': 4,
+                        'public/event-contract/events': 1,
+                        'public/event-contract/markets': 1,
+                        'public/event-contract/series': 1,
                         'public/vip-interest-rate-loan-quota': 10,
                         // rubik
                         'rubik/stat/trading-data/support-coin': 4,
@@ -254,6 +258,7 @@ class okx extends okx$1["default"] {
                         'rubik/stat/taker-volume-contract': 4,
                         'rubik/stat/margin/loan-ratio': 4,
                         'rubik/stat/contracts/long-short-account-ratio-contract-top-trader': 4,
+                        'rubik/stat/contracts/long-short-position-ratio-contract-top-trader': 4,
                         'rubik/stat/contracts/long-short-account-ratio-contract': 4,
                         'rubik/stat/contracts/long-short-account-ratio': 4,
                         'rubik/stat/contracts/open-interest-volume': 4,
@@ -295,6 +300,7 @@ class okx extends okx$1["default"] {
                         'copytrading/public-copy-traders': 4,
                         'support/announcements': 4,
                         'support/announcements-types': 20,
+                        'support/announcement-types': 20,
                     },
                     'post': {
                         'tradingBot/grid/min-investment': 1, // public
@@ -361,6 +367,7 @@ class okx extends okx$1["default"] {
                         'account/bills-archive': 4,
                         'account/bills-history-archive': 2,
                         'account/config': 4,
+                        'account/subtypes': 4,
                         'account/max-size': 1,
                         'account/max-avail-size': 1,
                         'account/leverage-info': 1,
@@ -420,6 +427,11 @@ class okx extends okx$1["default"] {
                         'tradingBot/recurring/orders-algo-history': 1,
                         'tradingBot/recurring/orders-algo-details': 1,
                         'tradingBot/recurring/sub-orders': 1,
+                        'tradingBot/dca/ongoing-list': 1,
+                        'tradingBot/dca/history-list': 1,
+                        'tradingBot/dca/orders': 1,
+                        'tradingBot/dca/position-details': 1,
+                        'tradingBot/dca/cycle-list': 1,
                         // earn
                         'finance/savings/balance': 5 / 3,
                         'finance/savings/lending-history': 5 / 3,
@@ -469,6 +481,9 @@ class okx extends okx$1["default"] {
                         'broker/nd/rebate-per-orders': 300,
                         'finance/sfp/dcd/order': 2,
                         'finance/sfp/dcd/orders': 2,
+                        'finance/sfp/dcd/currency-pair': 2,
+                        'finance/sfp/dcd/order-status': 2,
+                        'finance/sfp/dcd/order-history': 2,
                         // affiliate
                         'affiliate/invitee/detail': 1,
                         'users/partner/if-rebate': 1,
@@ -539,6 +554,7 @@ class okx extends okx$1["default"] {
                         'account/position-builder': 10,
                         'account/position-builder-graph': 50,
                         'account/set-riskOffset-type': 2,
+                        'account/set-riskOffset-amt': 2,
                         'account/activate-option': 4,
                         'account/set-auto-loan': 4,
                         'account/account-level-switch-preset': 4,
@@ -565,6 +581,7 @@ class okx extends okx$1["default"] {
                         'users/subaccount/set-transfer-out': 10,
                         // grid trading
                         'tradingBot/grid/order-algo': 1,
+                        'tradingBot/grid/copy-order-algo': 1,
                         'tradingBot/grid/amend-algo-basic-param': 1,
                         'tradingBot/grid/amend-order-algo': 1,
                         'tradingBot/grid/stop-order-algo': 1,
@@ -588,6 +605,20 @@ class okx extends okx$1["default"] {
                         'tradingBot/recurring/order-algo': 1,
                         'tradingBot/recurring/amend-order-algo': 1,
                         'tradingBot/recurring/stop-order-algo': 1,
+                        'tradingBot/dca/create': 1,
+                        'tradingBot/dca/amend-order-algo': 1,
+                        'tradingBot/dca/stop': 1,
+                        'tradingBot/dca/orders/manual-buy': 1,
+                        'tradingBot/dca/settings/reinvestment': 1,
+                        'tradingBot/dca/settings/take-profit': 1,
+                        'tradingBot/dca/margin/add': 1,
+                        'tradingBot/dca/margin/reduce': 1,
+                        'tradingBot/recurring/add-investment': 1,
+                        'tradingBot/recurring/amend-price-range': 1,
+                        'tradingBot/recurring/amend-recurring-amount': 1,
+                        'tradingBot/recurring/amend-recurring-time': 1,
+                        'tradingBot/recurring/pause': 1,
+                        'tradingBot/recurring/restart': 1,
                         // earn
                         'finance/savings/purchase-redempt': 5 / 3,
                         'finance/savings/set-lending-rate': 5 / 3,
@@ -626,6 +657,9 @@ class okx extends okx$1["default"] {
                         'broker/nd/rebate-per-orders': 36000,
                         'finance/sfp/dcd/quote': 10,
                         'finance/sfp/dcd/order': 10,
+                        'finance/sfp/dcd/trade': 10,
+                        'finance/sfp/dcd/redeem-quote': 10,
+                        'finance/sfp/dcd/redeem': 10,
                         'broker/nd/report-subaccount-ip': 0.25,
                         'broker/dma/subaccount/apikey': 1 / 4,
                         'broker/dma/trades': 36000,
@@ -5779,6 +5813,16 @@ class okx extends okx$1["default"] {
         }
         const currencyId = this.safeString(transaction, 'ccy');
         const code = this.safeCurrencyCode(currencyId);
+        let network = undefined;
+        const chain = this.safeString(transaction, 'chain');
+        if (chain !== undefined) {
+            const chainParts = chain.split('-');
+            const networkParts = this.arraySlice(chainParts, 1);
+            const networkId = networkParts.join('-');
+            if (networkId !== undefined) {
+                network = this.networkIdToCode(networkId, code);
+            }
+        }
         const amount = this.safeNumber(transaction, 'amt');
         const status = this.parseTransactionStatus(this.safeString(transaction, 'state'));
         const txid = this.safeString(transaction, 'txId');
@@ -5796,7 +5840,7 @@ class okx extends okx$1["default"] {
             'id': id,
             'currency': code,
             'amount': amount,
-            'network': undefined,
+            'network': network,
             'addressFrom': addressFrom,
             'addressTo': addressTo,
             'address': address,
@@ -6613,6 +6657,7 @@ class okx extends okx$1["default"] {
     parseFundingInterval(interval) {
         const intervals = {
             '3600000': '1h',
+            '7200000': '2h',
             '14400000': '4h',
             '28800000': '8h',
             '57600000': '16h',

package/dist/cjs/src/paradex.js

@@ -544,7 +544,9 @@ class paradex extends paradex$1["default"] {
         //  }
         //
         const assetKind = this.safeString(market, 'asset_kind');
-        const isOption = (assetKind === 'PERP_OPTION');
+        const isOptionPerpetual = (assetKind === 'PERP_OPTION');
+        const isOptionDelivery = (assetKind === 'OPTION');
+        const isOption = isOptionPerpetual || isOptionDelivery;
         const type = (isOption) ? 'option' : 'swap';
         const isSwap = (type === 'swap');
         const marketId = this.safeString(market, 'symbol');
@@ -562,7 +564,8 @@ class paradex extends paradex$1["default"] {
         let makerFee = this.parseNumber('-0.00005');
         if (isOption) {
             const optionTypeSuffix = (optionType === 'CALL') ? 'C' : 'P';
-            symbol = symbol + '-' + strikePrice + '-' + optionTypeSuffix;
+            const deliveryValue = (expiry === 0) ? '' : this.yymmdd(expiry) + '-';
+            symbol = symbol + '-' + deliveryValue + strikePrice + '-' + optionTypeSuffix;
             makerFee = this.parseNumber('0.0003');
         }
         else {

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

@@ -249,7 +249,7 @@ class binance extends binance$1["default"] {
         return baseUrl;
     }
     getFutureWsCategory(channel) {
-        if (channel === 'depth' || channel === 'rpiDepth' || channel === 'bookTicker' || channel === 'trade' || channel === 'aggTrade') {
+        if (channel === 'depth' || channel === 'rpiDepth' || channel === 'bookTicker' || channel === 'trade') {
             return 'public';
         }
         return 'market';

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

@@ -883,7 +883,7 @@ class cex extends cex$1["default"] {
         //     {
         //         "e": "open-orders",
         //         "data": [{
-        //             "id": "59098421630",
+        //             "id": "59098421631",
         //             "time": "1664062285425",
         //             "type": "buy",
         //             "price": "18920",

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

@@ -689,7 +689,7 @@ class coinbase extends coinbase$1["default"] {
             const currentEvent = events[i];
             const currentTrades = this.safeList(currentEvent, 'trades');
             for (let j = 0; j < currentTrades.length; j++) {
-                const item = currentTrades[i];
+                const item = currentTrades[j];
                 tradesArray.append(this.parseTrade(item));
             }
         }

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

@@ -18,7 +18,7 @@ class hyperliquid extends hyperliquid$1["default"] {
                 'createOrderWs': true,
                 'createOrdersWs': true,
                 'editOrderWs': true,
-                'watchBalance': false,
+                'watchBalance': true,
                 'watchMyTrades': true,
                 'watchOHLCV': true,
                 'watchOrderBook': true,
@@ -28,6 +28,9 @@ class hyperliquid extends hyperliquid$1["default"] {
                 'watchTrades': true,
                 'watchTradesForSymbols': false,
                 'watchPosition': false,
+                'unWatchBalance': true,
+                'watchPositions': true,
+                'unWatchPositions': true,
                 'unWatchOrderBook': true,
                 'unWatchTickers': true,
                 'unWatchTrades': true,
@@ -911,6 +914,334 @@ class hyperliquid extends hyperliquid$1["default"] {
         const payload = this.safeDict(response, 'payload');
         client.resolve(payload, id);
     }
+    /**
+     * @method
+     * @name hyperliquid#watchBalance
+     * @description watch balance and get the amount of funds available for trading or funds locked in orders
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {string} [params.dex] for for hip3 tokens subscription, eg: 'xyz' or 'flx'
+     * @returns {object} a [balance structure]{@link https://docs.ccxt.com/?id=balance-structure}
+     */
+    async watchBalance(params = {}) {
+        await this.loadMarkets();
+        let userAddress = undefined;
+        [userAddress, params] = this.handlePublicAddress('watchBalance', params);
+        let type = undefined;
+        [type, params] = this.handleMarketTypeAndParams('watchBalance', undefined, params);
+        let isUnifiedEnabled = undefined;
+        [isUnifiedEnabled, params] = await this.isUnifiedEnabled('watchBalance', userAddress, false, params);
+        const dex = this.safeString(params, 'dex');
+        const isSpot = ((type === 'spot') || isUnifiedEnabled) && (dex === undefined);
+        const topic = (isSpot) ? 'spotState' : 'clearinghouseState';
+        const messageHash = topic + '::balance';
+        const url = this.urls['api']['ws']['public'];
+        const subscription = {
+            'type': topic,
+            'user': userAddress,
+        };
+        if (isSpot) {
+            if (isUnifiedEnabled) {
+                subscription['isPortfolioMargin'] = true;
+            }
+        }
+        else {
+            if (dex !== undefined) {
+                subscription['dex'] = dex;
+            }
+        }
+        const request = {
+            'method': 'subscribe',
+            'subscription': subscription,
+        };
+        const message = this.extend(request, params);
+        return await this.watch(url, messageHash, message, topic);
+    }
+    /**
+     * @method
+     * @name hyperliquid#unWatchBalance
+     * @description unWatches balance
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} status of the unwatch request
+     */
+    async unWatchBalance(params = {}) {
+        await this.loadMarkets();
+        const url = this.urls['api']['ws']['public'];
+        let userAddress = undefined;
+        [userAddress, params] = this.handlePublicAddress('unWatchBalance', params);
+        let type = undefined;
+        [type, params] = this.handleMarketTypeAndParams('unWatchBalance', undefined, params);
+        let isUnifiedEnabled = undefined;
+        [isUnifiedEnabled, params] = await this.isUnifiedEnabled('unWatchBalance', userAddress, false, params);
+        const dex = this.safeString(params, 'dex');
+        const isSpot = ((type === 'spot') || isUnifiedEnabled) && (dex === undefined);
+        const topic = (isSpot) ? 'spotState' : 'clearinghouseState';
+        const messageHash = 'unsubscribe' + ':' + topic;
+        const request = {
+            'method': 'unsubscribe',
+            'subscription': {
+                'type': topic,
+                'user': userAddress,
+            },
+        };
+        const message = this.extend(request, params);
+        return await this.watch(url, messageHash, message, messageHash);
+    }
+    handleBalance(client, message) {
+        //
+        // spot
+        // {
+        //     "channel": "spotState",
+        //     "data": {
+        //         "user": "0xeeeeexxxxeeeee",
+        //         "spotState": {
+        //             "balances": [
+        //                 {
+        //                     "coin": "USDH",
+        //                     "token": 360,
+        //                     "total": "0.0",
+        //                     "hold": "0.0",
+        //                     "entryNtl": "0.0"
+        //                 }
+        //             ],
+        //             "tokenToAvailableAfterMaintenance": [
+        //                 [
+        //                     0,
+        //                     "56.1"
+        //                 ]
+        //             ]
+        //         }
+        //     }
+        // }
+        // swap
+        // {
+        //     "channel": "clearinghouseState",
+        //     "data": {
+        //         "dex": "",
+        //         "user": "0xeeeeexxxxeeeee",
+        //         "clearinghouseState": {
+        //             "marginSummary": {
+        //                 "accountValue": "0.0",
+        //                 "totalNtlPos": "0.0",
+        //                 "totalRawUsd": "0.0",
+        //                 "totalMarginUsed": "0.0"
+        //             },
+        //             "crossMarginSummary": {
+        //                 "accountValue": "0.0",
+        //                 "totalNtlPos": "0.0",
+        //                 "totalRawUsd": "0.0",
+        //                 "totalMarginUsed": "0.0"
+        //             },
+        //             "crossMaintenanceMarginUsed": "0.0",
+        //             "withdrawable": "0.0",
+        //             "assetPositions": [],
+        //             "time": 1776000003409
+        //         }
+        //     }
+        // }
+        //
+        if (this.balance === undefined) {
+            this.balance = {};
+        }
+        const topic = this.safeValue(message, 'channel');
+        const messageHash = topic + '::balance';
+        let info = undefined;
+        let rawBalances = [];
+        let account = undefined;
+        let timestamp = undefined;
+        const data = this.safeValue(message, 'data', []);
+        if (topic === 'spotState') {
+            const spotState = this.safeDict(data, 'spotState');
+            rawBalances = this.safeList(spotState, 'balances');
+            account = 'spot';
+            info = rawBalances;
+        }
+        if (topic === 'clearinghouseState') {
+            account = 'swap';
+            const clearinghouseState = this.safeDict(data, 'clearinghouseState');
+            rawBalances.push(clearinghouseState);
+            info = clearinghouseState;
+            timestamp = this.safeInteger(clearinghouseState, 'time');
+            this.handlePositions(client, message);
+        }
+        for (let i = 0; i < rawBalances.length; i++) {
+            this.parseWsBalance(rawBalances[i], account);
+        }
+        if (this.safeValue(this.balance, account) === undefined) {
+            this.balance[account] = {};
+        }
+        this.balance[account]['info'] = info;
+        this.balance[account]['timestamp'] = timestamp;
+        this.balance[account]['datetime'] = this.iso8601(timestamp);
+        this.balance[account] = this.safeBalance(this.balance[account]);
+        client.resolve(this.balance[account], messageHash);
+    }
+    parseWsBalance(balance, accountType = undefined) {
+        //
+        // spot
+        //     {
+        //         "coin": "USDH",
+        //         "token": 360,
+        //         "total": "0.0",
+        //         "hold": "0.0",
+        //         "entryNtl": "0.0"
+        //     }
+        // swap
+        //     {
+        //         "marginSummary": {
+        //             "accountValue": "0.0",
+        //             "totalNtlPos": "0.0",
+        //             "totalRawUsd": "0.0",
+        //             "totalMarginUsed": "0.0"
+        //         },
+        //         "crossMarginSummary": {
+        //             "accountValue": "0.0",
+        //             "totalNtlPos": "0.0",
+        //             "totalRawUsd": "0.0",
+        //             "totalMarginUsed": "0.0"
+        //         },
+        //         "crossMaintenanceMarginUsed": "0.0",
+        //         "withdrawable": "0.0",
+        //         "assetPositions": [],
+        //         "time": 1776000003409
+        //     }
+        //
+        const account = this.account();
+        const currencyId = this.safeString(balance, 'coin');
+        let code = undefined;
+        if (currencyId === undefined) {
+            code = 'USDC';
+            const marginSummary = this.safeDict(balance, 'marginSummary', {});
+            account['free'] = this.safeString(balance, 'withdrawable');
+            account['used'] = this.safeString(marginSummary, 'totalMarginUsed');
+            account['total'] = this.safeString(marginSummary, 'accountValue');
+        }
+        else {
+            code = this.safeCurrencyCode(currencyId);
+            account['used'] = this.safeString(balance, 'hold');
+            account['total'] = this.safeString(balance, 'total');
+        }
+        if (accountType !== undefined) {
+            if (this.safeValue(this.balance, accountType) === undefined) {
+                this.balance[accountType] = {};
+            }
+            this.balance[accountType][code] = account;
+        }
+        else {
+            this.balance[code] = account;
+        }
+    }
+    /**
+     * @method
+     * @name hyperliquid#watchPositions
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     * @description watch all open positions
+     * @param {string[]} [symbols] list of unified market symbols
+     * @param {int} [since] the earliest time in ms to fetch positions for
+     * @param {int} [limit] the maximum number of positions to retrieve
+     * @param {object} params extra parameters specific to the exchange API endpoint
+     * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/en/latest/manual.html#position-structure}
+     */
+    async watchPositions(symbols = undefined, since = undefined, limit = undefined, params = {}) {
+        await this.loadMarkets();
+        let userAddress = undefined;
+        [userAddress, params] = this.handlePublicAddress('watchPositions', params);
+        const topic = 'clearinghouseState';
+        let messageHash = topic + '::positions';
+        if (!this.isEmpty(symbols)) {
+            symbols = this.marketSymbols(symbols);
+            messageHash += '::' + symbols.join(',');
+        }
+        const url = this.urls['api']['ws']['public'];
+        const subscription = {
+            'type': topic,
+            'user': userAddress,
+        };
+        const dexName = this.getDexFromSymbols('watchPositions', symbols);
+        if (dexName !== undefined) {
+            subscription['dex'] = dexName;
+        }
+        const request = {
+            'method': 'subscribe',
+            'subscription': subscription,
+        };
+        const message = this.extend(request, params);
+        const client = this.client(url);
+        this.setPositionsCache(client, symbols);
+        const cache = this.positions;
+        const newPositions = await this.watch(url, messageHash, message, topic);
+        if (this.newUpdates) {
+            return newPositions;
+        }
+        return this.filterBySymbolsSinceLimit(cache, symbols, since, limit, true);
+    }
+    setPositionsCache(client, symbols = undefined) {
+        if (this.positions !== undefined) {
+            return;
+        }
+        this.positions = new Cache.ArrayCacheBySymbolBySide();
+    }
+    handlePositions(client, message) {
+        if (this.positions === undefined) {
+            this.positions = new Cache.ArrayCacheBySymbolBySide();
+        }
+        const cache = this.positions;
+        const data = this.safeDict(message, 'data', {});
+        const clearinghouseState = this.safeDict(data, 'clearinghouseState', {});
+        const newPositions = [];
+        const rawPositions = this.safeList(clearinghouseState, 'assetPositions', []);
+        for (let i = 0; i < rawPositions.length; i++) {
+            const rawPosition = rawPositions[i];
+            const position = this.parsePosition(rawPosition);
+            newPositions.push(position);
+            cache.append(position);
+        }
+        const baseMessageHash = 'clearinghouseState::positions';
+        const messageHashes = this.findMessageHashes(client, baseMessageHash);
+        for (let i = 0; i < messageHashes.length; i++) {
+            const messageHash = messageHashes[i];
+            const parts = messageHash.split('::');
+            const symbolsString = this.safeString(parts, 2);
+            if (symbolsString === undefined) {
+                continue;
+            }
+            const symbols = symbolsString.split(',');
+            const positions = this.filterByArray(newPositions, 'symbol', symbols, false);
+            if (!this.isEmpty(positions)) {
+                client.resolve(positions, messageHash);
+            }
+        }
+        client.resolve(newPositions, baseMessageHash);
+    }
+    /**
+     * @method
+     * @name hyperliquid#unWatchPositions
+     * @description unWatches all open positions
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions
+     * @param {string[]} [symbols] list of unified market symbols
+     * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @returns {object} status of the unwatch request
+     */
+    async unWatchPositions(symbols = undefined, params = {}) {
+        await this.loadMarkets();
+        if (!this.isEmpty(symbols)) {
+            throw new errors.NotSupported(this.id + ' unWatchPositions() does not support a symbol parameter, you must unwatch all orders');
+        }
+        const messageHash = 'unsubscribe:clearinghouseState';
+        const url = this.urls['api']['ws']['public'];
+        let userAddress = undefined;
+        [userAddress, params] = this.handlePublicAddress('unWatchPositions', params);
+        const request = {
+            'method': 'unsubscribe',
+            'subscription': {
+                'type': 'clearinghouseState',
+                'user': userAddress,
+            },
+        };
+        const message = this.extend(request, params);
+        return await this.watch(url, messageHash, message, messageHash);
+    }
     /**
      * @method
      * @name hyperliquid#watchOrders
@@ -1165,6 +1496,27 @@ class hyperliquid extends hyperliquid$1["default"] {
         };
         this.cleanCache(topicStructure);
     }
+    handlePositionsUnsubscription(client, subscription) {
+        const subHash = 'clearinghouseState';
+        const unSubHash = 'unsubscribe:' + subHash;
+        this.cleanUnsubscription(client, subHash, unSubHash, true);
+        const topicStructure = {
+            'topic': 'positions',
+        };
+        this.cleanCache(topicStructure);
+        // clean swap balance if it existed
+        if ('swap' in this.balance) {
+            delete this.balance['swap'];
+        }
+    }
+    handleSpotBalanceUnsubscription(client, subscription) {
+        const subHash = 'spotState';
+        const unSubHash = 'unsubscribe:' + subHash;
+        this.cleanUnsubscription(client, subHash, unSubHash, true);
+        if ('spot' in this.balance) {
+            delete this.balance['spot'];
+        }
+    }
     handleSubscriptionResponse(client, message) {
         // {
         //     "channel":"subscriptionResponse",
@@ -1213,6 +1565,12 @@ class hyperliquid extends hyperliquid$1["default"] {
             else if (type === 'userFills') {
                 this.handleMyTradesUnsubscription(client, subscription);
             }
+            else if (type === 'clearinghoustState') {
+                this.handlePositionsUnsubscription(client, subscription);
+            }
+            else if (type === 'spotState') {
+                this.handleSpotBalanceUnsubscription(client, subscription);
+            }
         }
     }
     handleMessage(client, message) {
@@ -1245,6 +1603,8 @@ class hyperliquid extends hyperliquid$1["default"] {
             'allMids': this.handleWsTickers,
             'post': this.handleWsPost,
             'subscriptionResponse': this.handleSubscriptionResponse,
+            'clearinghouseState': this.handleBalance,
+            'spotState': this.handleBalance,
         };
         const exacMethod = this.safeValue(methods, topic);
         if (exacMethod !== undefined) {