kucoin-api 2.6.2 → 2.6.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
1
  import { BaseRestClient } from './lib/BaseRestClient.js';
2
2
  import type { RestClientType } from './lib/requestUtils.js';
3
- import type { AddSubAccountApiRequestUTA, AddSubAccountRequestUTA, BatchCancelOrdersBySymbolRequestUTA, BatchCancelOrdersRequestUTA, BatchModifyMarginModeRequestUTA, BatchPlaceOrderRequestUTA, CancelOrderRequestUTA, FlexTransferRequestUTA, GetAccountLedgerRequestUTA, GetAccountPositionTiersRequestUTA, GetAnnouncementsRequestUTA, GetBorrowingRatesAndLimitsRequestUTA, GetCallAuctionInfoRequestUTA, GetClassicAccountRequestUTA, GetCurrencyRequestUTA, GetCurrentFundingRateRequestUTA, GetDCPRequestUTA, GetDepositAddressRequestUTA, GetDepositHistoryRequestUTA, GetFeeRateRequestUTA, GetFiatPriceRequestUTA, GetHistoryFundingRateRequestUTA, GetInterestHistoryRequestUTA, GetInterestRateIndexRequestUTA, GetKlinesRequestUTA, GetLeverageRequestUTA, GetOpenOrderListRequestUTA, GetOrderBookRequestUTA, GetOrderDetailsRequestUTA, GetOrderHistoryRequestUTA, GetPositionListRequestUTA, GetPositionsHistoryRequestUTA, GetPrivateFundingFeeHistoryRequestUTA, GetRateLimitRequestUTA, GetServiceStatusRequestUTA, GetSubAccountListRequestUTA, GetSubAccountRequestUTA, GetSymbolRequestUTA, GetThirdPartyCustodyCurrenciesRequestUTA, GetThirdPartyCustodyQuotaRequestUTA, GetTickerRequestUTA, GetTradeHistoryRequestUTA, GetTradesRequestUTA, GetTransferQuotasRequestUTA, GetWithdrawalHistoryRequestUTA, GetWithdrawalQuotasRequestUTA, ModifyIsolatedFuturesMarginRequestUTA, ModifyLeverageRequestUTA, ModifyMarginCrossLeverageRequestUTA, PlaceOrderRequestUTA, SetAccountModeRequestUTA, SetDCPRequestUTA, SetKcsFeeDeductionRequestUTA, SetSubAccountsRateLimitRequestUTA, SetSubAccountTransferPermissionRequestUTA, SubmitWithdrawRequestUTA } from './types/request/uta-types.js';
3
+ import type { AddSubAccountApiRequestUTA, AddSubAccountRequestUTA, AmendOrderRequestUTA, BatchCancelOrdersBySymbolRequestUTA, BatchCancelOrdersRequestUTA, BatchModifyMarginModeRequestUTA, BatchPlaceOrderRequestUTA, CancelOrderRequestUTA, FlexTransferRequestUTA, GetAccountLedgerRequestUTA, GetAccountPositionTiersRequestUTA, GetAnnouncementsRequestUTA, GetBorrowingRatesAndLimitsRequestUTA, GetCallAuctionInfoRequestUTA, GetClassicAccountRequestUTA, GetCurrenciesRequestUTA, GetCurrencyRequestUTA, GetCurrentFundingRateRequestUTA, GetDCPRequestUTA, GetDepositAddressRequestUTA, GetDepositHistoryRequestUTA, GetFeeRateRequestUTA, GetFiatPriceRequestUTA, GetHistoryFundingRateRequestUTA, GetIndexPriceRequestUTA, GetInterestHistoryRequestUTA, GetInterestRateIndexRequestUTA, GetKlinesRequestUTA, GetLeverageRequestUTA, GetOpenOrderListRequestUTA, GetOrderBookRequestUTA, GetOrderDetailsRequestUTA, GetOrderHistoryRequestUTA, GetPositionListRequestUTA, GetPositionsHistoryRequestUTA, GetPrivateFundingFeeHistoryRequestUTA, GetRateLimitRequestUTA, GetServiceStatusRequestUTA, GetSubAccountListRequestUTA, GetSubAccountRequestUTA, GetSymbolRequestUTA, GetThirdPartyCustodyCurrenciesRequestUTA, GetThirdPartyCustodyQuotaRequestUTA, GetTickerRequestUTA, GetTradeHistoryRequestUTA, GetTradesRequestUTA, GetTransferQuotasRequestUTA, GetWithdrawalHistoryRequestUTA, GetWithdrawalQuotasRequestUTA, ModifyIsolatedFuturesMarginRequestUTA, ModifyLeverageRequestUTA, ModifyMarginCrossLeverageRequestUTA, PlaceOrderRequestUTA, SetAccountModeRequestUTA, SetDCPRequestUTA, SetKcsFeeDeductionRequestUTA, SetSubAccountsRateLimitRequestUTA, SetSubAccountTransferPermissionRequestUTA, SubmitWithdrawRequestUTA } from './types/request/uta-types.js';
4
4
  import type { APISuccessResponse } from './types/response/shared.types.js';
5
- import type { AddSubAccountApiResponseUTA, AddSubAccountResponseUTA, ApiKeyInfoUTA, BatchCancelOrdersBySymbolResponseUTA, BatchCancelOrdersResponseUTA, BatchModifyMarginModeResponseUTA, BatchPlaceOrderResponseUTA, BorrowableCurrencyUTA, CancelOrderResponseUTA, DCPResponseUTA, DepositAddressUTA, FlexTransferResponseUTA, GetAccountLedgerResponseClassicUTA, GetAccountLedgerResponseUTA, GetAccountModeResponseUTA, GetAccountOverviewResponseUTA, GetAnnouncementsResponseUTA, GetBorrowingRatesAndLimitsResponseUTA, GetCallAuctionInfoResponseUTA, GetClassicAccountResponseUTA, GetCrossMarginConfigResponseUTA, GetCurrencyResponseUTA, GetCurrentFundingRateResponseUTA, GetDepositHistoryResponseUTA, GetFeeRateResponseUTA, GetFiatPriceResponseUTA, GetHistoryFundingRateResponseUTA, GetInterestHistoryResponseUTA, GetInterestRateIndexResponseUTA, GetKlinesResponseUTA, GetLeverageItemUTA, GetOpenOrderListResponseUTA, GetOrderBookResponseUTA, GetOrderHistoryResponseUTA, GetPositionsHistoryResponseUTA, GetPrivateFundingFeeHistoryResponseUTA, GetRateLimitCapResponseUTA, GetRateLimitResponseUTA, GetServiceStatusResponseUTA, GetSubAccountListResponseUTA, GetSubAccountResponseUTA, GetSymbolResponseUTA, GetTickerResponseUTA, GetTradeHistoryResponseUTA, GetTradesResponseUTA, GetTradeStatisticsResponseUTA, GetTransferQuotasResponseUTA, GetWithdrawalHistoryResponseUTA, KYCRegionUTA, ModifyIsolatedFuturesMarginResponseUTA, ModifyMarginCrossLeverageResponseUTA, OrderDetailsUTA, PlaceOrderResponseUTA, PositionTierUTA, PositionUTA, SetKcsFeeDeductionResponseUTA, SetSubAccountsRateLimitResponseUTA, SubAccountTransferPermissionUTA, SubmitWithdrawResponseUTA, ThirdPartyCustodyCurrencyUTA, ThirdPartyCustodyQuotaUTA, WithdrawalQuotasUTA } from './types/response/uta-types.js';
5
+ import type { AddSubAccountApiResponseUTA, AddSubAccountResponseUTA, AmendOrderResponseUTA, ApiKeyInfoUTA, BatchCancelOrdersBySymbolResponseUTA, BatchCancelOrdersResponseUTA, BatchModifyMarginModeResponseUTA, BatchPlaceOrderResponseUTA, BorrowableCurrencyUTA, CancelOrderResponseUTA, DCPResponseUTA, DepositAddressUTA, FlexTransferResponseUTA, GetAccountLedgerResponseClassicUTA, GetAccountLedgerResponseUTA, GetAccountModeResponseUTA, GetAccountOverviewResponseUTA, GetAnnouncementsResponseUTA, GetBorrowingRatesAndLimitsResponseUTA, GetCallAuctionInfoResponseUTA, GetClassicAccountResponseUTA, GetCrossMarginConfigResponseUTA, GetCurrenciesResponseUTA, GetCurrencyResponseUTA, GetCurrentFundingRateResponseUTA, GetDepositHistoryResponseUTA, GetFeeRateResponseUTA, GetFiatPriceResponseUTA, GetHistoryFundingRateResponseUTA, GetIndexPriceResponseUTA, GetInterestHistoryResponseUTA, GetInterestRateIndexResponseUTA, GetKlinesResponseUTA, GetLeverageItemUTA, GetOpenOrderListResponseUTA, GetOrderBookResponseUTA, GetOrderHistoryResponseUTA, GetPositionsHistoryResponseUTA, GetPrivateFundingFeeHistoryResponseUTA, GetRateLimitCapResponseUTA, GetRateLimitResponseUTA, GetServiceStatusResponseUTA, GetSubAccountListResponseUTA, GetSubAccountResponseUTA, GetSymbolResponseUTA, GetTickerResponseUTA, GetTradeHistoryResponseUTA, GetTradesResponseUTA, GetTradeStatisticsResponseUTA, GetTransferQuotasResponseUTA, GetWithdrawalHistoryResponseUTA, KYCRegionUTA, ModifyIsolatedFuturesMarginResponseUTA, ModifyMarginCrossLeverageResponseUTA, OrderDetailsUTA, PlaceOrderResponseUTA, PositionTierUTA, PositionUTA, SetKcsFeeDeductionResponseUTA, SetSubAccountsRateLimitResponseUTA, SubAccountTransferPermissionUTA, SubmitWithdrawResponseUTA, ThirdPartyCustodyCurrencyUTA, ThirdPartyCustodyQuotaUTA, WithdrawalQuotasUTA } from './types/response/uta-types.js';
6
6
  /**
7
7
  * Unified Trading Account Client
8
8
  *
@@ -26,7 +26,12 @@ export declare class UnifiedAPIClient extends BaseRestClient {
26
26
  * Get Currency
27
27
  * Request the currency details of a specified currency via this endpoint.
28
28
  */
29
- getCurrency(params?: GetCurrencyRequestUTA): Promise<APISuccessResponse<GetCurrencyResponseUTA>>;
29
+ getCurrency(params: GetCurrencyRequestUTA): Promise<APISuccessResponse<GetCurrencyResponseUTA>>;
30
+ /**
31
+ * Get Currencies
32
+ * Currency and chain-level deposit/withdrawal configuration.
33
+ */
34
+ getCurrencies(params?: GetCurrenciesRequestUTA): Promise<APISuccessResponse<GetCurrenciesResponseUTA>>;
30
35
  /**
31
36
  * Get Third-Party Custody Currencies
32
37
  * Query settlement currencies supported by third-party (OES) custodian institutions.
@@ -57,11 +62,16 @@ export declare class UnifiedAPIClient extends BaseRestClient {
57
62
  * Get the Kline of the symbol. Data are returned in grouped buckets based on requested type.
58
63
  */
59
64
  getKlines(params: GetKlinesRequestUTA): Promise<APISuccessResponse<GetKlinesResponseUTA>>;
65
+ /**
66
+ * Get Index Price
67
+ * Index price snapshots (updated once per second).
68
+ */
69
+ getIndexPrice(params: GetIndexPriceRequestUTA): Promise<APISuccessResponse<GetIndexPriceResponseUTA>>;
60
70
  /**
61
71
  * Get Current Funding Rate
62
72
  * Get current Futures funding fee rate.
63
73
  */
64
- getCurrentFundingRate(params: GetCurrentFundingRateRequestUTA): Promise<APISuccessResponse<GetCurrentFundingRateResponseUTA>>;
74
+ getCurrentFundingRate(params?: GetCurrentFundingRateRequestUTA): Promise<APISuccessResponse<GetCurrentFundingRateResponseUTA | GetCurrentFundingRateResponseUTA[]>>;
65
75
  /**
66
76
  * Get History Funding Rate
67
77
  * Query the Futures funding rate at each settlement time point within a certain time range.
@@ -91,7 +101,7 @@ export declare class UnifiedAPIClient extends BaseRestClient {
91
101
  * Get Fiat Price (UTA)
92
102
  * Request the fiat price of currencies for available trading pairs. Added 2026.07.01.
93
103
  */
94
- getFiatPrice(params?: GetFiatPriceRequestUTA): Promise<APISuccessResponse<GetFiatPriceResponseUTA>>;
104
+ getFiatPrice(params: GetFiatPriceRequestUTA): Promise<APISuccessResponse<GetFiatPriceResponseUTA>>;
95
105
  /**
96
106
  * Get Interest Rate Index (UTA)
97
107
  * Interest rate index records by symbol. Added 2026.07.17.
@@ -203,7 +213,7 @@ export declare class UnifiedAPIClient extends BaseRestClient {
203
213
  * Modify Leverage Margin Cross (UTA)
204
214
  * Update leverage for a currency in UTA cross margin.
205
215
  */
206
- modifyMarginCrossLeverage(params: ModifyMarginCrossLeverageRequestUTA, accountMode?: 'unified'): Promise<APISuccessResponse<ModifyMarginCrossLeverageResponseUTA>>;
216
+ modifyMarginCrossLeverage(params: ModifyMarginCrossLeverageRequestUTA, accountMode?: 'classic' | 'unified'): Promise<APISuccessResponse<ModifyMarginCrossLeverageResponseUTA>>;
207
217
  /**
208
218
  * Get Leverage (UTA)
209
219
  * Query leverage for MARGIN (currency) or FUTURES (symbol).
@@ -213,7 +223,7 @@ export declare class UnifiedAPIClient extends BaseRestClient {
213
223
  * Get Deposit Address
214
224
  * Return a deposit address; when both currency and chain are provided,
215
225
  * the address will be created if it does not exist.
216
- * URL unified to GET /api/ua/v1/asset/deposit/address as of 2026.01.17.
226
+ * URL unified to GET /api/ua/v2/asset/deposit/address as of 2026.01.17.
217
227
  */
218
228
  getDepositAddress(params: GetDepositAddressRequestUTA): Promise<APISuccessResponse<DepositAddressUTA[]>>;
219
229
  /**
@@ -309,10 +319,15 @@ export declare class UnifiedAPIClient extends BaseRestClient {
309
319
  * Note: closeOrder supported for closing futures position by symbol.
310
320
  */
311
321
  placeOrder(params: PlaceOrderRequestUTA, accountMode?: 'classic' | 'unified'): Promise<APISuccessResponse<PlaceOrderResponseUTA>>;
322
+ /**
323
+ * Amend Order
324
+ * Modify price, size, or TP/SL trigger prices. Futures only. Provide orderId or clientOid.
325
+ */
326
+ amendOrder(params: AmendOrderRequestUTA): Promise<APISuccessResponse<AmendOrderResponseUTA>>;
312
327
  /**
313
328
  * Batch Place Order (Classic)
314
329
  * This interface can be used for placing batch orders.
315
- * URL changed to /api/ua/v1/{accountMode}/order/place-batch as of 2026.01.17.
330
+ * URL changed to /api/ua/v2/{accountMode}/order/place-batch as of 2026.01.17.
316
331
  * Note: timeInForce supports 'RPI' value for Futures as of 2025.01.02.
317
332
  */
318
333
  batchPlaceOrder(params: BatchPlaceOrderRequestUTA, accountMode?: 'classic' | 'unified'): Promise<APISuccessResponse<BatchPlaceOrderResponseUTA>>;