kucoin-api 2.5.2 → 2.5.4

package/dist/mjs/types/request/broker.types.d.ts

@@ -44,9 +44,40 @@ export interface BrokerTransferRequest {
 }
 export interface GetBrokerDepositListRequest {
     currency?: string;
-    status?: 'PROCESSING' | 'SUCCESS' | 'FAILURE';
+    status?: 'PROCESSING' | 'SUCCESS' | 'FAILURE' | 'PRE_SUCCESS' | 'WAIT_TRM_MGT' | 'TRM_MGT_REJECTED' | 'ROLLBACKING' | 'ROLLBACK' | 'WAIT_RISK_MGT' | 'RISK_MGT_REJECTED';
     hash?: string;
     startTimestamp?: number;
     endTimestamp?: number;
     limit?: number;
 }
+export interface FastApiWithdrawValidationFactor {
+    factorType: string;
+    factorValue: string;
+}
+export interface FastApiWithdrawValidation {
+    factors: FastApiWithdrawValidationFactor[];
+    transactionId: string;
+}
+export interface FastApiWithdrawApplyRequest {
+    address: string;
+    amount: number;
+    currency: string;
+    memo: string;
+    remark: string;
+    chain?: string;
+    feeDeductType?: 'EXTERNAL' | 'INTERNAL';
+    isInner?: boolean;
+    wallet?: string;
+    withdrawType?: 'ADDRESS' | 'MAIL' | 'PHONE' | 'UID';
+    validation?: FastApiWithdrawValidation;
+    tin?: string;
+    country?: string;
+    lastName?: string;
+    firstName?: string;
+    identityNo?: string;
+    companyName?: string;
+    identityType?: string;
+    receiverType?: 'COMPANY' | 'INDIVIDUAL';
+    questionnaire?: string;
+    reasonOfTransfer?: string;
+}

package/dist/mjs/types/request/uta-types.d.ts

@@ -138,6 +138,35 @@ export interface GetDepositAddressRequestUTA {
     currency: string;
     chain?: string;
 }
+export interface GetWithdrawalQuotasRequestUTA {
+    currency: string;
+    chainId?: string;
+}
+export interface SubmitWithdrawRequestUTA {
+    currency: string;
+    toAddress: string;
+    amount: string;
+    withdrawType: 'ADDRESS' | 'UID' | 'MAIL' | 'PHONE';
+    chainId?: string;
+    memo?: string;
+    isInner?: boolean;
+    remark?: string;
+    feeDeductType?: 'INTERNAL' | 'EXTERNAL';
+}
+export interface AddSubAccountRequestUTA {
+    password: string;
+    subName: string;
+    access: 'Spot' | 'Futures' | 'Margin' | string;
+    remarks?: string;
+}
+export interface AddSubAccountApiRequestUTA {
+    subName: string;
+    passphrase: string;
+    remark: string;
+    permission?: string;
+    ipWhitelist?: string;
+    expire?: '-1' | '30' | '90' | '180' | '360';
+}
 /**
  * Order Endpoints
  */
@@ -176,6 +205,8 @@ export interface PlaceOrderRequestUTA {
     tpTriggerPriceType?: 'TP' | 'IP' | 'MP';
     slTriggerPrice?: string;
     slTriggerPriceType?: 'TP' | 'IP' | 'MP';
+    /** Close position for symbol; ignores side/size and cancels pending close orders. Default false */
+    closeOrder?: boolean;
 }
 export interface BatchPlaceOrderRequestUTA {
     tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
@@ -255,6 +286,18 @@ export interface GetPositionListRequestUTA {
     pageNumber?: number;
     pageSize?: number;
 }
+export interface BatchModifyMarginModeRequestUTA {
+    /** Trading pair symbol(s), comma-separated for batch */
+    symbol: string;
+    marginMode: 'CROSS' | 'ISOLATED';
+}
+export interface ModifyIsolatedFuturesMarginRequestUTA {
+    type: 'DEPOSIT' | 'WITHDRAW';
+    amount: string;
+    symbol: string;
+    tradeType: 'FUTURES' | 'MARGIN';
+    positionSide?: 'LONG' | 'SHORT' | 'BOTH';
+}
 /** Third-party custody (OES) custodian codes */
 export type ThirdPartyCustodyCustodianUTA = 'BITGO_SG' | 'BITGO_SD' | 'CACTUS' | 'CEFFU';
 /**

package/dist/mjs/types/response/broker.types.d.ts

@@ -43,6 +43,7 @@ export interface BrokerSubAccountApi {
 }
 export type BrokerTransferAccountType = 'MAIN' | 'TRADE' | 'CONTRACT' | 'MARGIN' | 'ISOLATED';
 export type BrokerTransferStatus = 'PROCESSING' | 'SUCCESS' | 'FAILURE';
+export type BrokerDepositStatus = 'PROCESSING' | 'SUCCESS' | 'FAILURE' | 'PRE_SUCCESS' | 'WAIT_TRM_MGT' | 'TRM_MGT_REJECTED' | 'ROLLBACKING' | 'ROLLBACK' | 'WAIT_RISK_MGT' | 'RISK_MGT_REJECTED';
 export interface BrokerTransferHistory {
     orderId: string;
     currency: string;
@@ -67,12 +68,25 @@ export interface BrokerDepositRecord {
     currency: string;
     isInner: boolean;
     walletTxId: string;
-    status: BrokerTransferStatus;
+    status: BrokerDepositStatus;
     remark: string;
     chain: string;
     createdAt: number;
     updatedAt: number;
+    statusRemark?: string;
+    preConfirms?: number;
+    confirms?: number;
+    currentConfirms?: number;
+}
+export interface FastApiWithdrawApplyInitialResponse {
+    transactionId: string;
+    allFactors: string[][];
+    sentFactors: string[][];
+}
+export interface FastApiWithdrawApplyCompleteResponse {
+    withdrawalId: string;
 }
+export type FastApiWithdrawApplyResponse = FastApiWithdrawApplyInitialResponse | FastApiWithdrawApplyCompleteResponse;
 export type BrokerWithdrawalStatus = 'PROCESSING' | 'WALLET_PROCESSING' | 'REVIEW' | 'SUCCESS' | 'FAILURE';
 export interface BrokerWithdrawalRecord {
     id: string;

package/dist/mjs/types/response/futures.types.d.ts

@@ -362,7 +362,7 @@ export interface FuturesFill {
     settleCurrency: string;
     orderType: 'market' | 'limit';
     displayType: 'limit' | 'market' | 'limit_stop' | 'market_stop';
-    tradeType: 'trade' | 'cancel' | 'liquid' | 'adl' | 'settlement';
+    tradeType: 'trade' | 'liquid' | 'adl' | 'settlement';
     subTradeType: string | null;
     /** Trade time (execution time), standardized to nanoseconds as of 2026.01.12 */
     tradeTime: number;

package/dist/mjs/types/response/uta-types.d.ts

@@ -296,7 +296,7 @@ export interface GetSubAccountResponseUTA {
 export interface GetTransferQuotasResponseUTA {
     currency: string;
     transferable: string;
-    accountType: string;
+    accountType: 'FUNDING' | 'SPOT' | 'FUTURES' | 'ISOLATED' | 'UNIFIED';
 }
 export interface FlexTransferResponseUTA {
     orderId: string;
@@ -326,6 +326,7 @@ export interface AccountLedgerItemUTA {
     currency: string;
     direction: 'IN' | 'OUT';
     businessType: string;
+    /** Change in funds balance. Always positive as of 2026.04.28; use direction (IN/OUT) for flow. */
     amount: string;
     balance: string;
     fee: string;
@@ -355,13 +356,73 @@ export interface DepositAddressUTA {
     address: string;
     memo: string;
     chainId: string;
-    to: 'MAIN' | 'TRADE';
+    to: 'FUNDING' | 'SPOT' | 'UNIFIED';
     currency: string;
     contractAddress: string;
     chainName: string;
     expirationDate: string;
     remark: string;
 }
+export interface WithdrawalQuotasUTA {
+    currency: string;
+    limitBTCAmount: string;
+    usedBTCAmount: string;
+    quotaCurrency: string;
+    limitQuotaCurrencyAmount: string;
+    usedQuotaCurrencyAmount: string;
+    remainAmount: string;
+    availableAmount: string;
+    withdrawMinFee: string;
+    innerWithdrawMinFee: string;
+    withdrawMinSize: string;
+    isWithdrawEnabled: boolean;
+    precision: number;
+    reason: string | null;
+    lockedAmount: string;
+    chainId: string;
+    chainName: string;
+}
+export interface SubmitWithdrawResponseUTA {
+    withdrawalId: string;
+}
+export interface AddSubAccountResponseUTA {
+    uid: number;
+    subName: string;
+    remarks: string;
+    access: string;
+}
+export interface AddSubAccountApiResponseUTA {
+    subName: string;
+    remark: string;
+    apiKey: string;
+    apiSecret: string;
+    apiVersion: number;
+    passphrase: string;
+    permission: string;
+    ipWhitelist?: string;
+    createdAt: number;
+}
+export interface KYCRegionUTA {
+    code: string;
+    enName: string;
+}
+export interface ApiKeyInfoUTA {
+    uid: number;
+    parentUid?: number;
+    region: string;
+    kycStatus: 0 | 1;
+    subName?: string;
+    remark: string;
+    apiKey: string;
+    apiVersion: number;
+    permission: string;
+    ipWhitelist?: string;
+    isMaster: boolean;
+    createdAt: number;
+    expiredAt?: number | null;
+    thirdPartyApp?: string;
+    siteType?: 'global' | 'turkey' | 'australia' | 'europe' | 'thailand';
+}
 /**
  * Order Response Types
  */
@@ -535,6 +596,8 @@ export interface PositionUTA {
     size: string;
     entryPrice: string;
     positionValue: string;
+    /** Margin occupied by the futures position */
+    positionMargin: string;
     markPrice: string;
     leverage: string;
     unrealizedPnL: string;
@@ -546,6 +609,10 @@ export interface PositionUTA {
     creationTime: number;
     /** Estimated liquidation price (as of 2026.04.09) */
     liquidationPrice: string;
+    /** ADL ranking percentile (0.12 = 12%). Added 2026.05.15 */
+    adlPercentage: string;
+    /** Isolated futures risk ratio (0.65 = 65%). Empty for cross margin positions */
+    riskRatio: string;
 }
 export interface PositionHistoryItemUTA {
     closeId: string;
@@ -592,3 +659,16 @@ export interface PositionTierUTA {
     initialMarginRate: string;
     maintainMarginRate: string;
 }
+export interface BatchModifyMarginModeItemUTA {
+    symbol: string;
+    marginMode: string;
+    code: string;
+    msg: string;
+}
+export interface BatchModifyMarginModeResponseUTA {
+    ts: number;
+    items: BatchModifyMarginModeItemUTA[];
+}
+export interface ModifyIsolatedFuturesMarginResponseUTA {
+    ts: number;
+}