ccxt 4.5.4 → 4.5.6

package/js/src/pro/bitget.js

@@ -1,9 +1,3 @@
-// ----------------------------------------------------------------------------
-
-// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
-// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
-// EDIT THE CORRESPONDENT .ts FILE INSTEAD
-
 //  ---------------------------------------------------------------------------
 import bitgetRest from '../bitget.js';
 import { AuthenticationError, BadRequest, ArgumentsRequired, ChecksumError, ExchangeError, RateLimitExceeded, UnsubscribeError } from '../base/errors.js';
@@ -514,7 +508,7 @@ export default class bitget extends bitgetRest {
             args['topic'] = 'kline';
             args['symbol'] = market['id'];
             args['interval'] = interval;
-            params['uta'] = true;
+            params = this.extend(params, { 'uta': true });
             messageHash = 'kline:' + symbol;
         }
         else {
@@ -563,7 +557,7 @@ export default class bitget extends bitgetRest {
             args['topic'] = channel;
             args['symbol'] = market['id'];
             args['interval'] = interval;
-            params['uta'] = true;
+            params = this.extend(params, { 'uta': true });
             params['interval'] = interval;
             messageHash = channel + symbol;
         }
@@ -713,9 +707,11 @@ export default class bitget extends bitgetRest {
      * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
      * @see https://www.bitget.com/api-doc/spot/websocket/public/Depth-Channel
      * @see https://www.bitget.com/api-doc/contract/websocket/public/Order-Book-Channel
+     * @see https://www.bitget.com/api-doc/uta/websocket/public/Order-Book-Channel
      * @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
      * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.uta] set to true for the unified trading account (uta), defaults to false
      * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
      */
     async watchOrderBook(symbol, limit = undefined, params = {}) {
@@ -727,16 +723,18 @@ export default class bitget extends bitgetRest {
      * @description unsubscribe from the orderbook channel
      * @see https://www.bitget.com/api-doc/spot/websocket/public/Depth-Channel
      * @see https://www.bitget.com/api-doc/contract/websocket/public/Order-Book-Channel
+     * @see https://www.bitget.com/api-doc/uta/websocket/public/Order-Book-Channel
      * @param {string} symbol unified symbol of the market to fetch the order book for
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @param {int} [params.limit] orderbook limit, default is undefined
+     * @param {boolean} [params.uta] set to true for the unified trading account (uta), defaults to false
      * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
      */
     async unWatchOrderBook(symbol, params = {}) {
         await this.loadMarkets();
         let channel = 'books';
         const limit = this.safeInteger(params, 'limit');
-        if ((limit === 1) || (limit === 5) || (limit === 15)) {
+        if ((limit === 1) || (limit === 5) || (limit === 15) || (limit === 50)) {
             params = this.omit(params, 'limit');
             channel += limit.toString();
         }
@@ -757,7 +755,7 @@ export default class bitget extends bitgetRest {
             args['topic'] = channel;
             args['symbol'] = market['id'];
             args['interval'] = this.safeString(params, 'interval', '1m');
-            params['uta'] = true;
+            params = this.extend(params, { 'uta': true });
             params = this.omit(params, 'interval');
         }
         else {
@@ -772,9 +770,11 @@ export default class bitget extends bitgetRest {
      * @description watches information on open orders with bid (buy) and ask (sell) prices, volumes and other data
      * @see https://www.bitget.com/api-doc/spot/websocket/public/Depth-Channel
      * @see https://www.bitget.com/api-doc/contract/websocket/public/Order-Book-Channel
+     * @see https://www.bitget.com/api-doc/uta/websocket/public/Order-Book-Channel
      * @param {string[]} symbols unified array of symbols
      * @param {int} [limit] the maximum amount of order book entries to return
      * @param {object} [params] extra parameters specific to the exchange API endpoint
+     * @param {boolean} [params.uta] set to true for the unified trading account (uta), defaults to false
      * @returns {object} A dictionary of [order book structures]{@link https://docs.ccxt.com/#/?id=order-book-structure} indexed by market symbols
      */
     async watchOrderBookForSymbols(symbols, limit = undefined, params = {}) {
@@ -782,25 +782,32 @@ export default class bitget extends bitgetRest {
         symbols = this.marketSymbols(symbols);
         let channel = 'books';
         let incrementalFeed = true;
-        if ((limit === 1) || (limit === 5) || (limit === 15)) {
+        if ((limit === 1) || (limit === 5) || (limit === 15) || (limit === 50)) {
             channel += limit.toString();
             incrementalFeed = false;
         }
         const topics = [];
         const messageHashes = [];
+        let uta = undefined;
+        [uta, params] = this.handleOptionAndParams(params, 'watchOrderBookForSymbols', 'uta', false);
         for (let i = 0; i < symbols.length; i++) {
             const symbol = symbols[i];
             const market = this.market(symbol);
             let instType = undefined;
-            [instType, params] = this.getInstType(market, false, params);
+            [instType, params] = this.getInstType(market, uta, params);
             const args = {
                 'instType': instType,
-                'channel': channel,
-                'instId': market['id'],
             };
+            const topicOrChannel = uta ? 'topic' : 'channel';
+            const symbolOrInstId = uta ? 'symbol' : 'instId';
+            args[topicOrChannel] = channel;
+            args[symbolOrInstId] = market['id'];
             topics.push(args);
             messageHashes.push('orderbook:' + symbol);
         }
+        if (uta) {
+            params['uta'] = true;
+        }
         const orderbook = await this.watchPublicMultiple(messageHashes, topics, params);
         if (incrementalFeed) {
             return orderbook.limit();
@@ -840,11 +847,27 @@ export default class bitget extends bitgetRest {
         //       ]
         //   }
         //
+        // {
+        //     "action": "snapshot",
+        //     "arg": { "instType": "usdt-futures", "topic": "books", "symbol": "BTCUSDT" },
+        //     "data": [
+        //         {
+        //             "a": [Array],
+        //             "b": [Array],
+        //             "checksum": 0,
+        //             "pseq": 0,
+        //             "seq": "1343064377779269632",
+        //             "ts": "1755937421270"
+        //         }
+        //     ],
+        //     "ts": 1755937421337
+        // }
+        //
         const arg = this.safeValue(message, 'arg');
-        const channel = this.safeString(arg, 'channel');
-        const instType = this.safeString(arg, 'instType');
-        const marketType = (instType === 'SPOT') ? 'spot' : 'contract';
-        const marketId = this.safeString(arg, 'instId');
+        const channel = this.safeString2(arg, 'channel', 'topic');
+        const instType = this.safeStringLower(arg, 'instType');
+        const marketType = (instType === 'spot') ? 'spot' : 'contract';
+        const marketId = this.safeString2(arg, 'instId', 'symbol');
         const market = this.safeMarket(marketId, undefined, undefined, marketType);
         const symbol = market['symbol'];
         const messageHash = 'orderbook:' + symbol;
@@ -861,8 +884,8 @@ export default class bitget extends bitgetRest {
                 this.orderbooks[symbol] = ob;
             }
             const storedOrderBook = this.orderbooks[symbol];
-            const asks = this.safeValue(rawOrderBook, 'asks', []);
-            const bids = this.safeValue(rawOrderBook, 'bids', []);
+            const asks = this.safeList2(rawOrderBook, 'asks', 'a', []);
+            const bids = this.safeList2(rawOrderBook, 'bids', 'b', []);
             this.handleDeltas(storedOrderBook['asks'], asks);
             this.handleDeltas(storedOrderBook['bids'], bids);
             storedOrderBook['timestamp'] = timestamp;
@@ -981,7 +1004,7 @@ export default class bitget extends bitgetRest {
             messageHashes.push('trade:' + symbol);
         }
         if (uta) {
-            params['uta'] = true;
+            params = this.extend(params, { 'uta': true });
         }
         const trades = await this.watchPublicMultiple(messageHashes, topics, params);
         if (this.newUpdates) {
@@ -1215,11 +1238,13 @@ export default class bitget extends bitgetRest {
      * @name bitget#watchPositions
      * @description watch all open positions
      * @see https://www.bitget.com/api-doc/contract/websocket/private/Positions-Channel
+     * @see https://www.bitget.com/api-doc/uta/websocket/private/Positions-Channel
      * @param {string[]|undefined} 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
      * @param {string} [params.instType] one of 'USDT-FUTURES', 'USDC-FUTURES', 'COIN-FUTURES', 'SUSDT-FUTURES', 'SUSDC-FUTURES' or 'SCOIN-FUTURES', default is 'USDT-FUTURES'
+     * @param {boolean} [params.uta] set to true for the unified trading account (uta), defaults to false
      * @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 = {}) {
@@ -1228,17 +1253,29 @@ export default class bitget extends bitgetRest {
         let messageHash = '';
         const subscriptionHash = 'positions';
         let instType = 'USDT-FUTURES';
+        let uta = undefined;
+        [uta, params] = this.handleOptionAndParams(params, 'watchPositions', 'uta', false);
         symbols = this.marketSymbols(symbols);
         if (!this.isEmpty(symbols)) {
             market = this.getMarketFromSymbols(symbols);
-            [instType, params] = this.getInstType(market, false, params);
+            [instType, params] = this.getInstType(market, uta, params);
+        }
+        if (uta) {
+            instType = 'UTA';
         }
         messageHash = instType + ':positions' + messageHash;
         const args = {
             'instType': instType,
-            'channel': 'positions',
-            'instId': 'default',
         };
+        const topicOrChannel = uta ? 'topic' : 'channel';
+        const channel = uta ? 'position' : 'positions';
+        args[topicOrChannel] = channel;
+        if (!uta) {
+            args['instId'] = 'default';
+        }
+        else {
+            params = this.extend(params, { 'uta': true });
+        }
         const newPositions = await this.watchPrivate(messageHash, subscriptionHash, args, params);
         if (this.newUpdates) {
             return newPositions;
@@ -1283,7 +1320,46 @@ export default class bitget extends bitgetRest {
         //         "ts": 1701913043767
         //     }
         //
-        const arg = this.safeValue(message, 'arg', {});
+        // uta
+        //
+        //     {
+        //         "data": [
+        //             {
+        //                 "symbol": "BTCUSDT",
+        //                 "leverage": "20",
+        //                 "openFeeTotal": "",
+        //                 "mmr": "",
+        //                 "breakEvenPrice": "",
+        //                 "available": "0",
+        //                 "liqPrice": "",
+        //                 "marginMode": "crossed",
+        //                 "unrealisedPnl": "0",
+        //                 "markPrice": "94987.1",
+        //                 "createdTime": "1736378720620",
+        //                 "avgPrice": "0",
+        //                 "totalFundingFee": "0",
+        //                 "updatedTime": "1736378720620",
+        //                 "marginCoin": "USDT",
+        //                 "frozen": "0",
+        //                 "profitRate": "",
+        //                 "closeFeeTotal": "",
+        //                 "marginSize": "0",
+        //                 "curRealisedPnl": "0",
+        //                 "size": "0",
+        //                 "positionStatus": "ended",
+        //                 "posSide": "long",
+        //                 "holdMode": "hedge_mode"
+        //             }
+        //         ],
+        //         "arg": {
+        //             "instType": "UTA",
+        //             "topic": "position"
+        //         },
+        //         "action": "snapshot",
+        //         "ts": 1730711666652
+        //     }
+        //
+        const arg = this.safeDict(message, 'arg', {});
         const instType = this.safeString(arg, 'instType', '');
         if (this.positions === undefined) {
             this.positions = {};
@@ -1293,11 +1369,11 @@ export default class bitget extends bitgetRest {
             this.positions[instType] = new ArrayCacheBySymbolBySide();
         }
         const cache = this.positions[instType];
-        const rawPositions = this.safeValue(message, 'data', []);
+        const rawPositions = this.safeList(message, 'data', []);
         const newPositions = [];
         for (let i = 0; i < rawPositions.length; i++) {
             const rawPosition = rawPositions[i];
-            const marketId = this.safeString(rawPosition, 'instId');
+            const marketId = this.safeString2(rawPosition, 'instId', 'symbol');
             const market = this.safeMarket(marketId, undefined, undefined, 'contract');
             const position = this.parseWsPosition(rawPosition, market);
             newPositions.push(position);
@@ -1342,16 +1418,45 @@ export default class bitget extends bitgetRest {
         //         "autoMargin": "off"
         //     }
         //
-        const marketId = this.safeString(position, 'instId');
+        // uta
+        //
+        //     {
+        //         "symbol": "BTCUSDT",
+        //         "leverage": "20",
+        //         "openFeeTotal": "",
+        //         "mmr": "",
+        //         "breakEvenPrice": "",
+        //         "available": "0",
+        //         "liqPrice": "",
+        //         "marginMode": "crossed",
+        //         "unrealisedPnl": "0",
+        //         "markPrice": "94987.1",
+        //         "createdTime": "1736378720620",
+        //         "avgPrice": "0",
+        //         "totalFundingFee": "0",
+        //         "updatedTime": "1736378720620",
+        //         "marginCoin": "USDT",
+        //         "frozen": "0",
+        //         "profitRate": "",
+        //         "closeFeeTotal": "",
+        //         "marginSize": "0",
+        //         "curRealisedPnl": "0",
+        //         "size": "0",
+        //         "positionStatus": "ended",
+        //         "posSide": "long",
+        //         "holdMode": "hedge_mode"
+        //     }
+        //
+        const marketId = this.safeString2(position, 'instId', 'symbol');
         const marginModeId = this.safeString(position, 'marginMode');
         const marginMode = this.getSupportedMapping(marginModeId, {
             'crossed': 'cross',
             'isolated': 'isolated',
         });
-        const hedgedId = this.safeString(position, 'posMode');
+        const hedgedId = this.safeString2(position, 'posMode', 'holdMode');
         const hedged = (hedgedId === 'hedge_mode') ? true : false;
-        const timestamp = this.safeInteger2(position, 'uTime', 'cTime');
-        const percentageDecimal = this.safeString(position, 'unrealizedPLR');
+        const timestamp = this.safeIntegerN(position, ['updatedTime', 'uTime', 'cTime', 'createdTime']);
+        const percentageDecimal = this.safeString2(position, 'unrealizedPLR', 'profitRate');
         const percentage = Precise.stringMul(percentageDecimal, '100');
         let contractSize = undefined;
         if (market !== undefined) {
@@ -1363,21 +1468,21 @@ export default class bitget extends bitgetRest {
             'symbol': this.safeSymbol(marketId, market, undefined, 'contract'),
             'notional': undefined,
             'marginMode': marginMode,
-            'liquidationPrice': this.safeNumber(position, 'liquidationPrice'),
-            'entryPrice': this.safeNumber(position, 'openPriceAvg'),
-            'unrealizedPnl': this.safeNumber(position, 'unrealizedPL'),
+            'liquidationPrice': this.safeNumber2(position, 'liquidationPrice', 'liqPrice'),
+            'entryPrice': this.safeNumber2(position, 'openPriceAvg', 'avgPrice'),
+            'unrealizedPnl': this.safeNumber2(position, 'unrealizedPL', 'unrealisedPnl'),
             'percentage': this.parseNumber(percentage),
-            'contracts': this.safeNumber(position, 'total'),
+            'contracts': this.safeNumber2(position, 'total', 'size'),
             'contractSize': contractSize,
-            'markPrice': undefined,
-            'side': this.safeString(position, 'holdSide'),
+            'markPrice': this.safeNumber(position, 'markPrice'),
+            'side': this.safeString2(position, 'holdSide', 'posSide'),
             'hedged': hedged,
             'timestamp': timestamp,
             'datetime': this.iso8601(timestamp),
             'maintenanceMargin': undefined,
-            'maintenanceMarginPercentage': this.safeNumber(position, 'keepMarginRate'),
-            'collateral': undefined,
-            'initialMargin': undefined,
+            'maintenanceMarginPercentage': this.safeNumber2(position, 'keepMarginRate', 'mmr'),
+            'collateral': this.safeNumber(position, 'available'),
+            'initialMargin': this.safeNumber(position, 'marginSize'),
             'initialMarginPercentage': undefined,
             'leverage': this.safeNumber(position, 'leverage'),
             'marginRatio': this.safeNumber(position, 'marginRate'),
@@ -1392,6 +1497,7 @@ export default class bitget extends bitgetRest {
      * @see https://www.bitget.com/api-doc/contract/websocket/private/Plan-Order-Channel
      * @see https://www.bitget.com/api-doc/margin/cross/websocket/private/Cross-Orders
      * @see https://www.bitget.com/api-doc/margin/isolated/websocket/private/Isolate-Orders
+     * @see https://www.bitget.com/api-doc/uta/websocket/private/Order-Channel
      * @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
@@ -1400,6 +1506,7 @@ export default class bitget extends bitgetRest {
      * @param {string} [params.marginMode] 'isolated' or 'cross' for watching spot margin orders]
      * @param {string} [params.type] 'spot', 'swap'
      * @param {string} [params.subType] 'linear', 'inverse'
+     * @param {boolean} [params.uta] set to true for the unified trading account (uta), defaults to false
      * @returns {object[]} a list of [order structures]{@link https://docs.ccxt.com/#/?id=order-structure}
      */
     async watchOrders(symbol = undefined, since = undefined, limit = undefined, params = {}) {
@@ -1416,6 +1523,8 @@ export default class bitget extends bitgetRest {
             marketId = market['id'];
             messageHash = messageHash + ':' + symbol;
         }
+        let uta = undefined;
+        [uta, params] = this.handleOptionAndParams(params, 'watchOrders', 'uta', false);
         const productType = this.safeString(params, 'productType');
         let type = undefined;
         [type, params] = this.handleMarketTypeAndParams('watchOrders', market, params);
@@ -1441,7 +1550,7 @@ export default class bitget extends bitgetRest {
             instType = 'SPOT';
         }
         else {
-            [instType, params] = this.getInstType(market, false, params);
+            [instType, params] = this.getInstType(market, uta, params);
         }
         if (type === 'spot' && (symbol !== undefined)) {
             subscriptionHash = subscriptionHash + ':' + symbol;
@@ -1463,12 +1572,22 @@ export default class bitget extends bitgetRest {
                 channel = 'orders-crossed';
             }
         }
+        if (uta) {
+            instType = 'UTA';
+            channel = 'order';
+        }
         subscriptionHash = subscriptionHash + ':' + instType;
         const args = {
             'instType': instType,
-            'channel': channel,
-            'instId': instId,
         };
+        const topicOrChannel = uta ? 'topic' : 'channel';
+        args[topicOrChannel] = channel;
+        if (!uta) {
+            args['instId'] = instId;
+        }
+        else {
+            params = this.extend(params, { 'uta': true });
+        }
         const orders = await this.watchPrivate(messageHash, subscriptionHash, args, params);
         if (this.newUpdates) {
             limit = orders.getLimit(symbol, limit);
@@ -1510,24 +1629,73 @@ export default class bitget extends bitgetRest {
         //         "ts": 1701923982497
         //     }
         //
+        // uta
+        //
+        //     {
+        //         "action": "snapshot",
+        //         "arg": {
+        //             "instType": "UTA",
+        //             "topic": "order"
+        //         },
+        //         "data": [
+        //             {
+        //                 "category": "usdt-futures",
+        //                 "symbol": "BTCUSDT",
+        //                 "orderId": "xxx",
+        //                 "clientOid": "xxx",
+        //                 "price": "",
+        //                 "qty": "0.001",
+        //                 "amount": "1000",
+        //                 "holdMode": "hedge_mode",
+        //                 "holdSide": "long",
+        //                 "tradeSide": "open",
+        //                 "orderType": "market",
+        //                 "timeInForce": "gtc",
+        //                 "side": "buy",
+        //                 "marginMode": "crossed",
+        //                 "marginCoin": "USDT",
+        //                 "reduceOnly": "no",
+        //                 "cumExecQty": "0.001",
+        //                 "cumExecValue": "83.1315",
+        //                 "avgPrice": "83131.5",
+        //                 "totalProfit": "0",
+        //                 "orderStatus": "filled",
+        //                 "cancelReason": "",
+        //                 "leverage": "20",
+        //                 "feeDetail": [
+        //                     {
+        //                         "feeCoin": "USDT",
+        //                         "fee": "0.0332526"
+        //                     }
+        //                 ],
+        //                 "createdTime": "1742367838101",
+        //                 "updatedTime": "1742367838115",
+        //                 "stpMode": "none"
+        //             }
+        //         ],
+        //         "ts": 1742367838124
+        //     }
+        //
         const arg = this.safeDict(message, 'arg', {});
-        const channel = this.safeString(arg, 'channel');
-        const instType = this.safeString(arg, 'instType');
+        const channel = this.safeString2(arg, 'channel', 'topic');
+        const instType = this.safeStringLower(arg, 'instType');
         const argInstId = this.safeString(arg, 'instId');
         let marketType = undefined;
-        if (instType === 'SPOT') {
+        if (instType === 'spot') {
             marketType = 'spot';
         }
-        else if (instType === 'MARGIN') {
+        else if (instType === 'margin') {
             marketType = 'spot';
         }
         else {
             marketType = 'contract';
         }
-        const isLinearSwap = (instType === 'USDT-FUTURES');
-        const isInverseSwap = (instType === 'COIN-FUTURES');
-        const isUSDCFutures = (instType === 'USDC-FUTURES');
-        const data = this.safeValue(message, 'data', []);
+        const data = this.safeList(message, 'data', []);
+        const first = this.safeDict(data, 0, {});
+        const category = this.safeStringLower(first, 'category', instType);
+        const isLinearSwap = (category === 'usdt-futures');
+        const isInverseSwap = (category === 'coin-futures');
+        const isUSDCFutures = (category === 'usdc-futures');
         if (this.orders === undefined) {
             const limit = this.safeInteger(this.options, 'ordersLimit', 1000);
             this.orders = new ArrayCacheBySymbolById(limit);
@@ -1539,7 +1707,7 @@ export default class bitget extends bitgetRest {
         const marketSymbols = {};
         for (let i = 0; i < data.length; i++) {
             const order = data[i];
-            const marketId = this.safeString(order, 'instId', argInstId);
+            const marketId = this.safeString2(order, 'instId', 'symbol', argInstId);
             const market = this.safeMarket(marketId, undefined, undefined, marketType);
             const parsed = this.parseWsOrder(order, market);
             stored.append(parsed);
@@ -1687,13 +1855,57 @@ export default class bitget extends bitgetRest {
         //         orderId: "1183419084588060673",
         //       }
         //
-        const isSpot = !('posMode' in order);
-        const isMargin = ('loanType' in order);
-        const marketId = this.safeString(order, 'instId');
+        // uta
+        //
+        //     {
+        //         "category": "usdt-futures",
+        //         "symbol": "BTCUSDT",
+        //         "orderId": "xxx",
+        //         "clientOid": "xxx",
+        //         "price": "",
+        //         "qty": "0.001",
+        //         "amount": "1000",
+        //         "holdMode": "hedge_mode",
+        //         "holdSide": "long",
+        //         "tradeSide": "open",
+        //         "orderType": "market",
+        //         "timeInForce": "gtc",
+        //         "side": "buy",
+        //         "marginMode": "crossed",
+        //         "marginCoin": "USDT",
+        //         "reduceOnly": "no",
+        //         "cumExecQty": "0.001",
+        //         "cumExecValue": "83.1315",
+        //         "avgPrice": "83131.5",
+        //         "totalProfit": "0",
+        //         "orderStatus": "filled",
+        //         "cancelReason": "",
+        //         "leverage": "20",
+        //         "feeDetail": [
+        //             {
+        //                 "feeCoin": "USDT",
+        //                 "fee": "0.0332526"
+        //             }
+        //         ],
+        //         "createdTime": "1742367838101",
+        //         "updatedTime": "1742367838115",
+        //         "stpMode": "none"
+        //     }
+        //
+        let isSpot = !('posMode' in order);
+        let isMargin = ('loanType' in order);
+        const category = this.safeStringLower(order, 'category');
+        if (category === 'spot') {
+            isSpot = true;
+        }
+        if (category === 'margin') {
+            isMargin = true;
+        }
+        const marketId = this.safeString2(order, 'instId', 'symbol');
         market = this.safeMarket(marketId, market);
-        const timestamp = this.safeInteger(order, 'cTime');
+        const timestamp = this.safeInteger2(order, 'cTime', 'createdTime');
         const symbol = market['symbol'];
-        const rawStatus = this.safeString(order, 'status');
+        const rawStatus = this.safeString2(order, 'status', 'orderStatus');
         const orderFee = this.safeValue(order, 'feeDetail', []);
         const fee = this.safeValue(orderFee, 0);
         const feeAmount = this.safeString(fee, 'fee');
@@ -1715,23 +1927,23 @@ export default class bitget extends bitgetRest {
             // for spot trigger order, limit price is this
             price = this.safeNumber(order, 'executePrice');
         }
-        const avgPrice = this.omitZero(this.safeString2(order, 'priceAvg', 'fillPrice'));
+        const avgPrice = this.omitZero(this.safeStringLowerN(order, ['priceAvg', 'fillPrice', 'avgPrice']));
         const side = this.safeString(order, 'side');
         const type = this.safeString(order, 'orderType');
-        const accBaseVolume = this.omitZero(this.safeString(order, 'accBaseVolume'));
-        const newSizeValue = this.omitZero(this.safeString(order, 'newSize'));
+        const accBaseVolume = this.omitZero(this.safeString2(order, 'accBaseVolume', 'cumExecQty'));
+        const newSizeValue = this.omitZero(this.safeString2(order, 'newSize', 'cumExecValue'));
         const isMarketOrder = (type === 'market');
         const isBuy = (side === 'buy');
         let totalAmount = undefined;
         let filledAmount = undefined;
         let cost = undefined;
         let remaining = undefined;
-        let totalFilled = this.safeString(order, 'accBaseVolume');
+        let totalFilled = this.safeString2(order, 'accBaseVolume', 'cumExecQty');
         if (isSpot) {
             if (isMargin) {
-                totalAmount = this.safeString(order, 'baseSize');
-                totalFilled = this.safeString(order, 'baseVolume');
-                cost = this.safeString(order, 'fillTotalAmount');
+                totalAmount = this.safeString2(order, 'baseSize', 'qty');
+                totalFilled = this.safeString2(order, 'baseVolume', 'cumExecQty');
+                cost = this.safeString2(order, 'fillTotalAmount', 'cumExecValue');
             }
             else {
                 const partialFillAmount = this.safeString(order, 'baseVolume');
@@ -1752,16 +1964,16 @@ export default class bitget extends bitgetRest {
                     }
                 }
                 else {
-                    totalAmount = this.safeString(order, 'newSize');
+                    totalAmount = this.safeString2(order, 'newSize', 'qty');
                     // we don't have cost for limit order
                 }
             }
         }
         else {
             // baseVolume should not be used for "amount" for contracts !
-            filledAmount = this.safeString(order, 'baseVolume');
-            totalAmount = this.safeString(order, 'size');
-            cost = this.safeString(order, 'fillNotionalUsd');
+            filledAmount = this.safeString2(order, 'baseVolume', 'cumExecQty');
+            totalAmount = this.safeString2(order, 'size', 'qty');
+            cost = this.safeString2(order, 'fillNotionalUsd', 'cumExecValue');
         }
         remaining = Precise.stringSub(totalAmount, totalFilled);
         return this.safeOrder({
@@ -1771,9 +1983,9 @@ export default class bitget extends bitgetRest {
             'clientOrderId': this.safeString(order, 'clientOid'),
             'timestamp': timestamp,
             'datetime': this.iso8601(timestamp),
-            'lastTradeTimestamp': this.safeInteger(order, 'uTime'),
+            'lastTradeTimestamp': this.safeInteger2(order, 'uTime', 'updatedTime'),
             'type': type,
-            'timeInForce': this.safeStringUpper(order, 'force'),
+            'timeInForce': this.safeStringUpper2(order, 'force', 'timeInForce'),
             'postOnly': undefined,
             'side': side,
             'price': price,
@@ -1844,7 +2056,7 @@ export default class bitget extends bitgetRest {
             args['instId'] = 'default';
         }
         else {
-            params['uta'] = true;
+            params = this.extend(params, { 'uta': true });
         }
         const trades = await this.watchPrivate(messageHash, subscriptionHash, args, params);
         if (this.newUpdates) {
@@ -1988,13 +2200,17 @@ export default class bitget extends bitgetRest {
      * @see https://www.bitget.com/api-doc/contract/websocket/private/Account-Channel
      * @see https://www.bitget.com/api-doc/margin/cross/websocket/private/Margin-Cross-Account-Assets
      * @see https://www.bitget.com/api-doc/margin/isolated/websocket/private/Margin-isolated-account-assets
+     * @see https://www.bitget.com/api-doc/uta/websocket/private/Account-Channel
      * @param {object} [params] extra parameters specific to the exchange API endpoint
      * @param {str} [params.type] spot or contract if not provided this.options['defaultType'] is used
      * @param {string} [params.instType] one of 'SPOT', 'MARGIN', 'USDT-FUTURES', 'USDC-FUTURES', 'COIN-FUTURES', 'SUSDT-FUTURES', 'SUSDC-FUTURES' or 'SCOIN-FUTURES'
      * @param {string} [params.marginMode] 'isolated' or 'cross' for watching spot margin balances
+     * @param {boolean} [params.uta] set to true for the unified trading account (uta), defaults to false
      * @returns {object} a [balance structure]{@link https://docs.ccxt.com/#/?id=balance-structure}
      */
     async watchBalance(params = {}) {
+        let uta = undefined;
+        [uta, params] = this.handleOptionAndParams(params, 'watchBalance', 'uta', false);
         let type = undefined;
         [type, params] = this.handleMarketTypeAndParams('watchBalance', undefined, params);
         let marginMode = undefined;
@@ -2006,22 +2222,33 @@ export default class bitget extends bitgetRest {
         }
         else if (marginMode !== undefined) {
             instType = 'MARGIN';
-            if (marginMode === 'isolated') {
-                channel = 'account-isolated';
-            }
-            else {
-                channel = 'account-crossed';
+            if (!uta) {
+                if (marginMode === 'isolated') {
+                    channel = 'account-isolated';
+                }
+                else {
+                    channel = 'account-crossed';
+                }
             }
         }
-        else {
+        else if (!uta) {
             instType = 'SPOT';
         }
         [instType, params] = this.handleOptionAndParams(params, 'watchBalance', 'instType', instType);
+        if (uta) {
+            instType = 'UTA';
+        }
         const args = {
             'instType': instType,
-            'channel': channel,
-            'coin': 'default',
         };
+        const topicOrChannel = uta ? 'topic' : 'channel';
+        args[topicOrChannel] = channel;
+        if (!uta) {
+            args['coin'] = 'default';
+        }
+        else {
+            params = this.extend(params, { 'uta': true });
+        }
         const messageHash = 'balance:' + instType.toLowerCase();
         return await this.watchPrivate(messageHash, messageHash, args, params);
     }
@@ -2084,26 +2311,76 @@ export default class bitget extends bitgetRest {
         //         "ts": 1701933110544
         //     }
         //
+        // uta
+        //
+        //     {
+        //         "data": [{
+        //             "unrealisedPnL": "-10116.55",
+        //             "totalEquity": "4976919.05",
+        //             "positionMgnRatio": "0",
+        //             "mmr": "408.08",
+        //             "effEquity": "4847952.35",
+        //             "imr": "17795.97",
+        //             "mgnRatio": "0",
+        //             "coin": [{
+        //                 "debts": "0",
+        //                 "balance": "0.9992",
+        //                 "available": "0.9992",
+        //                 "borrow": "0",
+        //                 "locked": "0",
+        //                 "equity": "0.9992",
+        //                 "coin": "ETH",
+        //                 "usdValue": "2488.667472"
+        //             }]
+        //         }],
+        //         "arg": {
+        //             "instType": "UTA",
+        //             "topic": "account"
+        //         },
+        //         "action": "snapshot",
+        //         "ts": 1740546523244
+        //     }
+        //
+        const arg = this.safeDict(message, 'arg', {});
+        const instType = this.safeStringLower(arg, 'instType');
         const data = this.safeValue(message, 'data', []);
         for (let i = 0; i < data.length; i++) {
             const rawBalance = data[i];
-            const currencyId = this.safeString2(rawBalance, 'coin', 'marginCoin');
-            const code = this.safeCurrencyCode(currencyId);
-            const account = (code in this.balance) ? this.balance[code] : this.account();
-            const borrow = this.safeString(rawBalance, 'borrow');
-            if (borrow !== undefined) {
-                const interest = this.safeString(rawBalance, 'interest');
-                account['debt'] = Precise.stringAdd(borrow, interest);
+            if (instType === 'uta') {
+                const coins = this.safeList(rawBalance, 'coin', []);
+                for (let j = 0; j < coins.length; j++) {
+                    const entry = coins[j];
+                    const currencyId = this.safeString(entry, 'coin');
+                    const code = this.safeCurrencyCode(currencyId);
+                    const account = (code in this.balance) ? this.balance[code] : this.account();
+                    const borrow = this.safeString(entry, 'borrow');
+                    const debts = this.safeString(entry, 'debts');
+                    if ((borrow !== undefined) || (debts !== undefined)) {
+                        account['debt'] = Precise.stringAdd(borrow, debts);
+                    }
+                    account['free'] = this.safeString(entry, 'available');
+                    account['used'] = this.safeString(entry, 'locked');
+                    account['total'] = this.safeString(entry, 'balance');
+                    this.balance[code] = account;
+                }
+            }
+            else {
+                const currencyId = this.safeString2(rawBalance, 'coin', 'marginCoin');
+                const code = this.safeCurrencyCode(currencyId);
+                const account = (code in this.balance) ? this.balance[code] : this.account();
+                const borrow = this.safeString(rawBalance, 'borrow');
+                if (borrow !== undefined) {
+                    const interest = this.safeString(rawBalance, 'interest');
+                    account['debt'] = Precise.stringAdd(borrow, interest);
+                }
+                const freeQuery = ('maxTransferOut' in rawBalance) ? 'maxTransferOut' : 'available';
+                account['free'] = this.safeString(rawBalance, freeQuery);
+                account['total'] = this.safeString(rawBalance, 'equity');
+                account['used'] = this.safeString(rawBalance, 'frozen');
+                this.balance[code] = account;
             }
-            const freeQuery = ('maxTransferOut' in rawBalance) ? 'maxTransferOut' : 'available';
-            account['free'] = this.safeString(rawBalance, freeQuery);
-            account['total'] = this.safeString(rawBalance, 'equity');
-            account['used'] = this.safeString(rawBalance, 'frozen');
-            this.balance[code] = account;
         }
         this.balance = this.safeBalance(this.balance);
-        const arg = this.safeValue(message, 'arg');
-        const instType = this.safeStringLower(arg, 'instType');
         const messageHash = 'balance:' + instType;
         client.resolve(this.balance, messageHash);
     }
@@ -2403,12 +2680,14 @@ export default class bitget extends bitgetRest {
             'trade': this.handleTrades,
             'publicTrade': this.handleTrades,
             'fill': this.handleMyTrades,
+            'order': this.handleOrder,
             'orders': this.handleOrder,
             'ordersAlgo': this.handleOrder,
             'orders-algo': this.handleOrder,
             'orders-crossed': this.handleOrder,
             'orders-isolated': this.handleOrder,
             'account': this.handleBalance,
+            'position': this.handlePositions,
             'positions': this.handlePositions,
             'account-isolated': this.handleBalance,
             'account-crossed': this.handleBalance,