ccxt 4.3.9 → 4.3.10

package/dist/cjs/src/kucoinfutures.js

@@ -81,13 +81,14 @@ class kucoinfutures extends kucoinfutures$1 {
                 'fetchPositionHistory': false,
                 'fetchPositionMode': false,
                 'fetchPositions': true,
-                'fetchPositionsHistory': false,
+                'fetchPositionsHistory': true,
                 'fetchPremiumIndexOHLCV': false,
                 'fetchStatus': true,
                 'fetchTicker': true,
                 'fetchTickers': true,
                 'fetchTime': true,
                 'fetchTrades': true,
+                'fetchTradingFee': true,
                 'fetchTransactionFee': false,
                 'fetchWithdrawals': true,
                 'setLeverage': false,
@@ -164,6 +165,8 @@ class kucoinfutures extends kucoinfutures$1 {
                         'funding-history': 4.44,
                         'sub/api-key': 1,
                         'trade-statistics': 1,
+                        'trade-fees': 1,
+                        'history-positions': 1,
                     },
                     'post': {
                         'withdrawals': 1,
@@ -1137,6 +1140,76 @@ class kucoinfutures extends kucoinfutures$1 {
         const data = this.safeList(response, 'data');
         return this.parsePositions(data, symbols);
     }
+    async fetchPositionsHistory(symbols = undefined, since = undefined, limit = undefined, params = {}) {
+        /**
+         * @method
+         * @name kucoinfutures#fetchPositionsHistory
+         * @description fetches historical positions
+         * @see https://www.kucoin.com/docs/rest/futures-trading/positions/get-positions-history
+         * @param {string[]} [symbols] list of unified market symbols
+         * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @param {int} [params.until] closing end time
+         * @param {int} [params.pageId] page id
+         * @returns {object[]} a list of [position structure]{@link https://docs.ccxt.com/#/?id=position-structure}
+         */
+        await this.loadMarkets();
+        if (limit === undefined) {
+            limit = 200;
+        }
+        const request = {
+            'limit': limit,
+        };
+        if (since !== undefined) {
+            request['from'] = since;
+        }
+        const until = this.safeInteger(params, 'until');
+        if (until !== undefined) {
+            params = this.omit(params, 'until');
+            request['to'] = until;
+        }
+        const response = await this.futuresPrivateGetHistoryPositions(this.extend(request, params));
+        //
+        // {
+        //     "success": true,
+        //     "code": "200",
+        //     "msg": "success",
+        //     "retry": false,
+        //     "data": {
+        //         "currentPage": 1,
+        //         "pageSize": 10,
+        //         "totalNum": 25,
+        //         "totalPage": 3,
+        //         "items": [
+        //             {
+        //                 "closeId": "300000000000000030",
+        //                 "positionId": "300000000000000009",
+        //                 "uid": 99996908309485,
+        //                 "userId": "6527d4fc8c7f3d0001f40f5f",
+        //                 "symbol": "XBTUSDM",
+        //                 "settleCurrency": "XBT",
+        //                 "leverage": "0.0",
+        //                 "type": "LIQUID_LONG",
+        //                 "side": null,
+        //                 "closeSize": null,
+        //                 "pnl": "-1.0000003793999999",
+        //                 "realisedGrossCost": "0.9993849748999999",
+        //                 "withdrawPnl": "0.0",
+        //                 "roe": null,
+        //                 "tradeFee": "0.0006154045",
+        //                 "fundingFee": "0.0",
+        //                 "openTime": 1713785751181,
+        //                 "closeTime": 1713785752784,
+        //                 "openPrice": null,
+        //                 "closePrice": null
+        //             }
+        //         ]
+        //     }
+        // }
+        //
+        const data = this.safeDict(response, 'data');
+        const items = this.safeList(data, 'items', []);
+        return this.parsePositions(items, symbols);
+    }
     parsePosition(position, market = undefined) {
         //
         //    {
@@ -1183,17 +1256,51 @@ class kucoinfutures extends kucoinfutures$1 {
         //            }
         //        ]
         //    }
+        // position history
+        //             {
+        //                 "closeId": "300000000000000030",
+        //                 "positionId": "300000000000000009",
+        //                 "uid": 99996908309485,
+        //                 "userId": "6527d4fc8c7f3d0001f40f5f",
+        //                 "symbol": "XBTUSDM",
+        //                 "settleCurrency": "XBT",
+        //                 "leverage": "0.0",
+        //                 "type": "LIQUID_LONG",
+        //                 "side": null,
+        //                 "closeSize": null,
+        //                 "pnl": "-1.0000003793999999",
+        //                 "realisedGrossCost": "0.9993849748999999",
+        //                 "withdrawPnl": "0.0",
+        //                 "roe": null,
+        //                 "tradeFee": "0.0006154045",
+        //                 "fundingFee": "0.0",
+        //                 "openTime": 1713785751181,
+        //                 "closeTime": 1713785752784,
+        //                 "openPrice": null,
+        //                 "closePrice": null
+        //             }
         //
         const symbol = this.safeString(position, 'symbol');
         market = this.safeMarket(symbol, market);
         const timestamp = this.safeInteger(position, 'currentTimestamp');
         const size = this.safeString(position, 'currentQty');
         let side = undefined;
-        if (Precise["default"].stringGt(size, '0')) {
-            side = 'long';
+        const type = this.safeStringLower(position, 'type');
+        if (size !== undefined) {
+            if (Precise["default"].stringGt(size, '0')) {
+                side = 'long';
+            }
+            else if (Precise["default"].stringLt(size, '0')) {
+                side = 'short';
+            }
         }
-        else if (Precise["default"].stringLt(size, '0')) {
-            side = 'short';
+        else if (type !== undefined) {
+            if (type.indexOf('long') > -1) {
+                side = 'long';
+            }
+            else {
+                side = 'short';
+            }
         }
         const notional = Precise["default"].stringAbs(this.safeString(position, 'posCost'));
         const initialMargin = this.safeString(position, 'posInit');
@@ -1202,25 +1309,28 @@ class kucoinfutures extends kucoinfutures$1 {
         const unrealisedPnl = this.safeString(position, 'unrealisedPnl');
         const crossMode = this.safeValue(position, 'crossMode');
         // currently crossMode is always set to false and only isolated positions are supported
-        const marginMode = crossMode ? 'cross' : 'isolated';
+        let marginMode = undefined;
+        if (crossMode !== undefined) {
+            marginMode = crossMode ? 'cross' : 'isolated';
+        }
         return this.safePosition({
             'info': position,
-            'id': this.safeString(position, 'id'),
+            'id': this.safeString2(position, 'id', 'positionId'),
             'symbol': this.safeString(market, 'symbol'),
             'timestamp': timestamp,
             'datetime': this.iso8601(timestamp),
-            'lastUpdateTimestamp': undefined,
+            'lastUpdateTimestamp': this.safeInteger(position, 'closeTime'),
             'initialMargin': this.parseNumber(initialMargin),
             'initialMarginPercentage': this.parseNumber(initialMarginPercentage),
             'maintenanceMargin': this.safeNumber(position, 'posMaint'),
             'maintenanceMarginPercentage': this.safeNumber(position, 'maintMarginReq'),
-            'entryPrice': this.safeNumber(position, 'avgEntryPrice'),
+            'entryPrice': this.safeNumber2(position, 'avgEntryPrice', 'openPrice'),
             'notional': this.parseNumber(notional),
-            'leverage': this.safeNumber(position, 'realLeverage'),
+            'leverage': this.safeNumber2(position, 'realLeverage', 'leverage'),
             'unrealizedPnl': this.parseNumber(unrealisedPnl),
             'contracts': this.parseNumber(Precise["default"].stringAbs(size)),
             'contractSize': this.safeValue(market, 'contractSize'),
-            'realizedPnl': this.safeNumber(position, 'realisedPnl'),
+            'realizedPnl': this.safeNumber2(position, 'realisedPnl', 'pnl'),
             'marginRatio': undefined,
             'liquidationPrice': this.safeNumber(position, 'liquidationPrice'),
             'markPrice': this.safeNumber(position, 'markPrice'),
@@ -2701,6 +2811,44 @@ class kucoinfutures extends kucoinfutures$1 {
         }
         return this.parseOrder(response, market);
     }
+    async fetchTradingFee(symbol, params = {}) {
+        /**
+         * @method
+         * @name kucoinfutures#fetchTradingFee
+         * @description fetch the trading fees for a market
+         * @see https://www.kucoin.com/docs/rest/funding/trade-fee/trading-pair-actual-fee-futures
+         * @param {string} symbol unified market symbol
+         * @param {object} [params] extra parameters specific to the exchange API endpoint
+         * @returns {object} a [fee structure]{@link https://docs.ccxt.com/#/?id=fee-structure}
+         */
+        await this.loadMarkets();
+        const market = this.market(symbol);
+        const request = {
+            'symbols': market['id'],
+        };
+        const response = await this.privateGetTradeFees(this.extend(request, params));
+        //
+        //  {
+        //      "code": "200000",
+        //      "data": {
+        //        "symbol": "XBTUSDTM",
+        //        "takerFeeRate": "0.0006",
+        //        "makerFeeRate": "0.0002"
+        //      }
+        //  }
+        //
+        const data = this.safeList(response, 'data', []);
+        const first = this.safeDict(data, 0);
+        const marketId = this.safeString(first, 'symbol');
+        return {
+            'info': response,
+            'symbol': this.safeSymbol(marketId, market),
+            'maker': this.safeNumber(first, 'makerFeeRate'),
+            'taker': this.safeNumber(first, 'takerFeeRate'),
+            'percentage': true,
+            'tierBased': true,
+        };
+    }
 }
 
 module.exports = kucoinfutures;

package/js/ccxt.d.ts

@@ -4,7 +4,7 @@ import * as functions from './src/base/functions.js';
 import * as errors from './src/base/errors.js';
 import type { Market, Trade, Fee, Ticker, OrderBook, Order, Transaction, Tickers, Currency, Balance, DepositAddress, WithdrawalResponse, DepositAddressResponse, OHLCV, Balances, PartialBalances, Dictionary, MinMax, Position, FundingRateHistory, Liquidation, FundingHistory, MarginMode, Greeks, Leverage, Leverages, Option, OptionChain, Conversion } from './src/base/types.js';
 import { BaseError, ExchangeError, AuthenticationError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, OperationRejected, NoChange, MarginModeAlreadySet, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, AddressPending, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, ContractUnavailable, NotSupported, ProxyError, ExchangeClosedByUser, OperationFailed, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout } from './src/base/errors.js';
-declare const version = "4.3.8";
+declare const version = "4.3.9";
 import ace from './src/ace.js';
 import alpaca from './src/alpaca.js';
 import ascendex from './src/ascendex.js';

package/js/ccxt.js

@@ -38,7 +38,7 @@ import * as errors from './src/base/errors.js';
 import { BaseError, ExchangeError, AuthenticationError, PermissionDenied, AccountNotEnabled, AccountSuspended, ArgumentsRequired, BadRequest, BadSymbol, OperationRejected, NoChange, MarginModeAlreadySet, BadResponse, NullResponse, InsufficientFunds, InvalidAddress, AddressPending, InvalidOrder, OrderNotFound, OrderNotCached, CancelPending, OrderImmediatelyFillable, OrderNotFillable, DuplicateOrderId, ContractUnavailable, NotSupported, ProxyError, ExchangeClosedByUser, OperationFailed, NetworkError, DDoSProtection, RateLimitExceeded, ExchangeNotAvailable, OnMaintenance, InvalidNonce, RequestTimeout } from './src/base/errors.js';
 //-----------------------------------------------------------------------------
 // this is updated by vss.js when building
-const version = '4.3.9';
+const version = '4.3.10';
 Exchange.ccxtVersion = version;
 //-----------------------------------------------------------------------------
 import ace from './src/ace.js';

package/js/src/abstract/kucoinfutures.d.ts

@@ -183,6 +183,8 @@ interface kucoin {
     futuresPrivateGetWithdrawalList(params?: {}): Promise<implicitReturnType>;
     futuresPrivateGetSubApiKey(params?: {}): Promise<implicitReturnType>;
     futuresPrivateGetTradeStatistics(params?: {}): Promise<implicitReturnType>;
+    futuresPrivateGetTradeFees(params?: {}): Promise<implicitReturnType>;
+    futuresPrivateGetHistoryPositions(params?: {}): Promise<implicitReturnType>;
     futuresPrivatePostTransferOut(params?: {}): Promise<implicitReturnType>;
     futuresPrivatePostTransferIn(params?: {}): Promise<implicitReturnType>;
     futuresPrivatePostOrders(params?: {}): Promise<implicitReturnType>;

package/js/src/base/Exchange.js

@@ -6101,10 +6101,10 @@ export default class Exchange {
             const fromId = this.safeString(entry, fromCurrencyKey);
             const toId = this.safeString(entry, toCurrencyKey);
             if (fromId !== undefined) {
-                fromCurrency = this.currency(fromId);
+                fromCurrency = this.safeCurrency(fromId);
             }
             if (toId !== undefined) {
-                toCurrency = this.currency(toId);
+                toCurrency = this.safeCurrency(toId);
             }
             const conversion = this.extend(this.parseConversion(entry, fromCurrency, toCurrency), params);
             result.push(conversion);
@@ -6112,7 +6112,7 @@ export default class Exchange {
         const sorted = this.sortBy(result, 'timestamp');
         let currency = undefined;
         if (code !== undefined) {
-            currency = this.currency(code);
+            currency = this.safeCurrency(code);
             code = currency['code'];
         }
         if (code === undefined) {

package/js/src/base/types.d.ts

@@ -121,6 +121,8 @@ export interface Order {
     cost: number;
     trades: Trade[];
     fee: Fee;
+    reduceOnly: Bool;
+    postOnly: Bool;
     info: any;
 }
 export interface OrderBook {

package/js/src/bitget.js

@@ -8458,7 +8458,7 @@ export default class bitget extends Exchange {
          * @name bitget#fetchPositionsHistory
          * @description fetches historical positions
          * @see https://www.bitget.com/api-doc/contract/position/Get-History-Position
-         * @param {string} [symbol] unified contract symbols
+         * @param {string[]} [symbols] unified contract symbols
          * @param {int} [since] timestamp in ms of the earliest position to fetch, default=3 months ago, max range for params["until"] - since is 3 months
          * @param {int} [limit] the maximum amount of records to fetch, default=20, max=100
          * @param {object} params extra parameters specific to the exchange api endpoint