kucoin-api 2.5.0 → 2.5.2

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

@@ -113,10 +113,27 @@ export interface GetInterestHistoryRequestUTA {
     page?: number;
     size?: number;
 }
+export interface GetBorrowingRatesAndLimitsRequestUTA {
+    currency: string;
+}
 export interface ModifyLeverageRequestUTA {
     symbol: string;
     leverage: string;
 }
+/** UTA cross margin only — path includes accountMode (typically unified) */
+export interface ModifyMarginCrossLeverageRequestUTA {
+    leverage: string;
+    /** Cross margin currency (e.g. BTC) */
+    currency?: string;
+}
+export interface GetLeverageRequestUTA {
+    tradeType: 'MARGIN' | 'FUTURES';
+    marginMode: 'CROSS' | 'ISOLATED';
+    /** Required for MARGIN when not returning all; optional => all for MARGIN */
+    currency?: string;
+    /** Required for FUTURES when not returning all; optional => all for FUTURES */
+    symbol?: string;
+}
 export interface GetDepositAddressRequestUTA {
     currency: string;
     chain?: string;
@@ -125,7 +142,7 @@ export interface GetDepositAddressRequestUTA {
  * Order Endpoints
  */
 export interface PlaceOrderRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     clientOid?: string;
     symbol: string;
     side: 'BUY' | 'SELL';
@@ -161,17 +178,17 @@ export interface PlaceOrderRequestUTA {
     slTriggerPriceType?: 'TP' | 'IP' | 'MP';
 }
 export interface BatchPlaceOrderRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     orderList: Omit<PlaceOrderRequestUTA, 'tradeType'>[];
 }
 export interface GetOrderDetailsRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     symbol: string;
     orderId?: string;
     clientOid?: string;
 }
 export interface GetOpenOrderListRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     symbol?: string;
     orderFilter?: 'NORMAL' | 'CONDITION';
     startAt?: number;
@@ -180,7 +197,7 @@ export interface GetOpenOrderListRequestUTA {
     pageSize?: number;
 }
 export interface GetOrderHistoryRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     symbol?: string;
     side?: 'BUY' | 'SELL';
     orderFilter?: 'NORMAL' | 'CONDITION';
@@ -190,7 +207,7 @@ export interface GetOrderHistoryRequestUTA {
     pageSize?: number;
 }
 export interface GetTradeHistoryRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     symbol?: string;
     orderId?: string;
     side?: 'BUY' | 'SELL';
@@ -201,7 +218,7 @@ export interface GetTradeHistoryRequestUTA {
     pageSize?: number;
 }
 export interface CancelOrderRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     symbol: string;
     orderId?: string;
     clientOid?: string;
@@ -212,9 +229,16 @@ export interface CancelOrderItemRequestUTA {
     clientOid?: string;
 }
 export interface BatchCancelOrdersRequestUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     cancelOrderList: CancelOrderItemRequestUTA[];
 }
+/** Batch cancel orders by symbol (POST /order/cancel-all) */
+export interface BatchCancelOrdersBySymbolRequestUTA {
+    tradeType: 'SPOT' | 'FUTURES' | 'MARGIN';
+    symbol: string;
+    marginMode?: 'CROSS' | 'ISOLATED';
+    orderFilter?: 'NORMAL' | 'ADVANCED';
+}
 export interface SetDCPRequestUTA {
     tradeType: 'SPOT' | 'FUTURES' | 'MARGIN';
     timeout: number;
@@ -228,6 +252,33 @@ export interface GetDCPRequestUTA {
  */
 export interface GetPositionListRequestUTA {
     symbol?: string;
+    pageNumber?: number;
+    pageSize?: number;
+}
+/** Third-party custody (OES) custodian codes */
+export type ThirdPartyCustodyCustodianUTA = 'BITGO_SG' | 'BITGO_SD' | 'CACTUS' | 'CEFFU';
+/**
+ * Get Third-Party Custody Currencies (public)
+ * Settlement currencies supported per custodian.
+ */
+export interface GetThirdPartyCustodyCurrenciesRequestUTA {
+    /** If omitted, returns all custodian rows */
+    custodian?: ThirdPartyCustodyCustodianUTA;
+    /** If omitted, all currencies for the selected custodian(s) */
+    currency?: string;
+}
+/**
+ * Get Third-Party Custody Account Currency Limits (private)
+ * Remaining OES custody quota per custodian/currency.
+ */
+export interface GetThirdPartyCustodyQuotaRequestUTA {
+    /**
+     * If sub-account API key is used, this parameter is ignored; only the
+     * custodian bound to the sub-account is returned (per API docs).
+     */
+    custodian?: ThirdPartyCustodyCustodianUTA;
+    /** If omitted, limits for all currencies under the custodian */
+    currency?: string;
 }
 export interface GetPositionsHistoryRequestUTA {
     symbol?: string;
@@ -236,6 +287,14 @@ export interface GetPositionsHistoryRequestUTA {
     lastId?: number;
     pageSize?: number;
 }
+/** Settled funding fee history (private) */
+export interface GetPrivateFundingFeeHistoryRequestUTA {
+    symbol?: string;
+    startAt?: number;
+    endAt?: number;
+    lastId?: number;
+    pageSize?: number;
+}
 export interface GetAccountPositionTiersRequestUTA {
     symbol: string;
     tradeType?: 'FUTURES' | 'MARGIN';

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

@@ -37,7 +37,7 @@ export interface BrokerSubAccountApi {
     label: string;
     apiKey: string;
     apiVersion: number;
-    permissions: ('General' | 'Spot' | 'Futures')[];
+    permissions: ('General' | 'Spot' | 'Margin' | 'Futures' | 'InnerTransfer' | 'Transfer' | 'Earn')[];
     ipWhitelist: string[];
     createdAt: number;
 }

package/dist/cjs/types/response/spot-account.d.ts

@@ -52,7 +52,8 @@ export interface AccountHFMarginTransactions {
     amount: string;
     fee: string;
     balance: string;
-    accountType: 'MARGIN_V2' | 'ISOLATED_V2';
+    /** Migrating from MARGIN_V2/ISOLATED_V2 to MARGIN/ISOLATED per SPOT Margin HF migration */
+    accountType: 'MARGIN' | 'ISOLATED' | 'MARGIN_V2' | 'ISOLATED_V2';
     bizType: 'TRANSFER' | 'MARGIN_EXCHANGE' | 'ISOLATED_EXCHANGE' | 'LIQUIDATION' | 'ASSERT_RETURN';
     direction: 'out' | 'in';
     createdAt: string;
@@ -211,4 +212,5 @@ export interface ApiKeyInfo {
     createdAt: number;
     expiredAt?: number | null;
     thirdPartyApp?: string;
+    siteType?: 'global' | 'turkey' | 'australia' | 'europe' | 'thailand';
 }

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

@@ -174,6 +174,12 @@ export interface GetCurrentFundingRateResponseUTA {
     fundingTime: number;
     fundingRateCap: number;
     fundingRateFloor: number;
+    /** Current funding settlement interval (ms); as of 2026.04.19 */
+    currentGranularity: number;
+    /** New interval after change (ms); as of 2026.04.19 */
+    newGranularity: number;
+    /** When newGranularity takes effect (ms); as of 2026.04.19 */
+    newGranularityStartTime: number;
 }
 export interface FundingRateHistoryItemUTA {
     fundingRate: number;
@@ -183,6 +189,43 @@ export interface GetHistoryFundingRateResponseUTA {
     symbol: string;
     list: FundingRateHistoryItemUTA[];
 }
+export interface ModifyMarginCrossLeverageResponseUTA {
+    currency?: string;
+    leverage?: string;
+}
+/** One row from Get Leverage (UTA) — margin uses currency, futures uses symbol */
+export interface GetLeverageItemUTA {
+    leverage: string;
+    marginMode: string;
+    currency?: string;
+    symbol?: string;
+}
+export interface PrivateFundingFeeHistoryItemUTA {
+    symbol: string;
+    marginMode: 'CROSS' | 'ISOLATED';
+    fundingRate: string;
+    markPrice: string;
+    size: string;
+    positionValue: string;
+    fundingFee: string;
+    settleCurrency: string;
+    settlementTime: number;
+}
+export interface GetPrivateFundingFeeHistoryResponseUTA {
+    lastId: number;
+    items: PrivateFundingFeeHistoryItemUTA[];
+}
+export interface GetBorrowingRatesAndLimitsResponseUTA {
+    currentRateHourly: string;
+    currentRateDaily: string;
+    borrowLimitTotal: string;
+    borrowLimitTotalHold: string;
+    borrowLimitHold: string;
+    interestFreeBorrowLimit: string;
+}
+export interface BorrowableCurrencyUTA {
+    currency: string;
+}
 export interface GetCrossMarginConfigResponseUTA {
     maxLeverage: number;
     alertRiskRatio: string;
@@ -203,6 +246,8 @@ export interface AccountCurrencyUTA {
     available: string;
     balance: string;
     equity: string;
+    /** Potential borrow reserved by open orders (UTA; as of 2026.04.19) */
+    potentialBorrow?: string;
     liability?: string;
     totalCrossMargin?: string;
     crossPosMargin?: string;
@@ -321,7 +366,7 @@ export interface DepositAddressUTA {
  * Order Response Types
  */
 export interface PlaceOrderResponseUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     orderId: string;
     clientOid: string;
     /** Timestamp when system completes order request in nanoseconds. Classic mode not supported */
@@ -339,11 +384,11 @@ export interface BatchPlaceOrderItemResponseUTA {
     msg?: string;
 }
 export interface BatchPlaceOrderResponseUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     items: BatchPlaceOrderItemResponseUTA[];
 }
 export interface OrderDetailsUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     orderId: string;
     clientOid: string;
     /**
@@ -404,12 +449,12 @@ export interface GetOpenOrderListResponseUTA {
     pageSize?: number;
     totalNum?: number;
     totalPage?: number;
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     items: OrderDetailsUTA[];
 }
 export interface GetOrderHistoryResponseUTA {
     lastId: number;
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     items: OrderDetailsUTA[];
 }
 export interface TradeHistoryItemUTA {
@@ -435,11 +480,11 @@ export interface TradeHistoryItemUTA {
 }
 export interface GetTradeHistoryResponseUTA {
     lastId: number;
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     items: TradeHistoryItemUTA[];
 }
 export interface CancelOrderResponseUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     orderId?: string;
     clientOid?: string;
     /** Timestamp when system completes order cancellation request (nanoseconds). Only for unified accounts */
@@ -454,9 +499,26 @@ export interface BatchCancelOrderItemResponseUTA {
     ts?: number;
 }
 export interface BatchCancelOrdersResponseUTA {
-    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS';
+    tradeType: 'SPOT' | 'FUTURES' | 'ISOLATED' | 'CROSS' | 'MARGIN';
     items: BatchCancelOrderItemResponseUTA[];
 }
+/** Batch cancel by symbol - Classic response (orderId list) */
+export interface BatchCancelOrdersBySymbolItemClassicUTA {
+    orderId: string;
+}
+/** Batch cancel by symbol - UTA response (full result per order) */
+export interface BatchCancelOrdersBySymbolItemUTA {
+    code?: string;
+    msg?: string;
+    orderId?: string;
+    ts?: number;
+    clientOid?: string | null;
+}
+export interface BatchCancelOrdersBySymbolResponseUTA {
+    tradeType: 'SPOT' | 'FUTURES' | 'MARGIN';
+    ts?: number;
+    items: BatchCancelOrdersBySymbolItemClassicUTA[] | BatchCancelOrdersBySymbolItemUTA[];
+}
 export interface DCPResponseUTA {
     tradeType: 'SPOT' | 'FUTURES' | 'MARGIN';
     symbol: string[];
@@ -482,6 +544,8 @@ export interface PositionUTA {
     maintenanceMargin: string;
     /** Timestamp when position was first opened (nanoseconds, standardized as of 2026.01.12) */
     creationTime: number;
+    /** Estimated liquidation price (as of 2026.04.09) */
+    liquidationPrice: string;
 }
 export interface PositionHistoryItemUTA {
     closeId: string;
@@ -506,6 +570,19 @@ export interface GetPositionsHistoryResponseUTA {
     items: PositionHistoryItemUTA[];
     lastId?: number;
 }
+/** Row from Get Third-Party Custody Currencies */
+export interface ThirdPartyCustodyCurrencyUTA {
+    custodian: string;
+    currency: string;
+    precision: number;
+}
+/** Row from Get Third-Party Custody Account Currency Limits */
+export interface ThirdPartyCustodyQuotaUTA {
+    custodian: string;
+    currency: string;
+    /** Remaining custodial quota (shared across custodian sub-accounts under master) */
+    custodyQuota: string;
+}
 export interface PositionTierUTA {
     symbol: string;
     tier: number;

package/dist/mjs/BrokerClient.d.ts

@@ -36,7 +36,7 @@ export declare class BrokerClient extends BaseRestClient {
      *
      * This interface supports the creation of Broker sub-account APIKEY.
      * Supports up to 20 IPs in the whitelist.
-     * Only General, Spot, and Futures permissions can be set.
+     * Permissions: General, Spot, Margin, Futures, InnerTransfer, Transfer, Earn.
      * Label must be between 4 and 32 characters.
      */
     createSubAccountApi(params: CreateBrokerSubAccountApiRequest): Promise<APISuccessResponse<CreateBrokerSubAccountApiResponse>>;
@@ -52,7 +52,7 @@ export declare class BrokerClient extends BaseRestClient {
      *
      * This interface supports modifying the Broker's sub-account APIKEY.
      * Supports up to 20 IPs in the whitelist.
-     * Only General, Spot, and Futures permissions can be set.
+     * Permissions: General, Spot, Margin, Futures, InnerTransfer, Transfer, Earn.
      * Label must be between 4 and 32 characters.
      */
     updateSubAccountApi(params: UpdateBrokerSubAccountApiRequest): Promise<APISuccessResponse<BrokerSubAccountApi>>;

package/dist/mjs/BrokerClient.js

@@ -39,7 +39,7 @@ export class BrokerClient extends BaseRestClient {
      *
      * This interface supports the creation of Broker sub-account APIKEY.
      * Supports up to 20 IPs in the whitelist.
-     * Only General, Spot, and Futures permissions can be set.
+     * Permissions: General, Spot, Margin, Futures, InnerTransfer, Transfer, Earn.
      * Label must be between 4 and 32 characters.
      */
     createSubAccountApi(params) {
@@ -59,7 +59,7 @@ export class BrokerClient extends BaseRestClient {
      *
      * This interface supports modifying the Broker's sub-account APIKEY.
      * Supports up to 20 IPs in the whitelist.
-     * Only General, Spot, and Futures permissions can be set.
+     * Permissions: General, Spot, Margin, Futures, InnerTransfer, Transfer, Earn.
      * Label must be between 4 and 32 characters.
      */
     updateSubAccountApi(params) {

package/dist/mjs/SpotClient.d.ts

@@ -93,13 +93,13 @@ export declare class SpotClient extends BaseRestClient {
     /**
      * Get Account - Cross Margin
      *
-     * Request via this endpoint to get the info of the cross margin account.
+     * Request cross margin account info. Preferred queryType: MARGIN. MARGIN_V2 phased out gradually.
      */
     getMarginBalance(params?: GetMarginBalanceRequest): Promise<APISuccessResponse<MarginBalance>>;
     /**
      * Get Account - Isolated Margin
      *
-     * Request via this endpoint to get the info of the isolated margin account.
+     * Request isolated margin account info. Preferred queryType: ISOLATED. ISOLATED_V2 phased out gradually.
      */
     getIsolatedMarginBalance(params?: GetIsolatedMarginBalanceRequest): Promise<APISuccessResponse<IsolatedMarginBalance[]>>;
     /**
@@ -299,12 +299,14 @@ export declare class SpotClient extends BaseRestClient {
      * Get Transfer Quotas
      *
      * This endpoint returns the transferable balance of a specified account.
+     * Preferred type: MARGIN, ISOLATED. V2 (MARGIN_V2, ISOLATED_V2) phased out gradually.
      */
     getTransferable(params: GetTransferableRequest): Promise<APISuccessResponse<TransferableFunds>>;
     /**
      * Flex Transfer
      *
-     * This endpoint can be used for transfers between master and sub accounts and inner transfers
+     * Transfers between master/sub accounts and inner transfers.
+     * Preferred account types: MARGIN, ISOLATED. For non-INTERNAL type, use MARGIN/ISOLATED (not MARGIN_V2/ISOLATED_V2).
      */
     submitFlexTransfer(params: FlexTransferRequest): Promise<APISuccessResponse<{
         orderId: string;
@@ -1501,8 +1503,9 @@ export declare class SpotClient extends BaseRestClient {
      * DEPRECATED
      */
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the getMarginBalance() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use getMarginBalance() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     getMarginBalances(): Promise<APISuccessResponse<{
         debtRatio: string;
@@ -1672,13 +1675,15 @@ export declare class SpotClient extends BaseRestClient {
      * DEPRECATED
      */
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the submitHFMarginOrder() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use submitHFMarginOrder() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     submitMarginOrder(params: SubmitMarginOrderRequest): Promise<APISuccessResponse<SubmitMarginOrderResponse>>;
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the submitHFMarginOrderTest() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use submitHFMarginOrderTest() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     submitMarginOrderTest(): Promise<any>;
     /**
@@ -1687,15 +1692,17 @@ export declare class SpotClient extends BaseRestClient {
      * DEPRECATED
      */
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the getMarginBalance() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use getIsolatedMarginBalance() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     getIsolatedMarginAccounts(params?: {
         balanceCurrency?: 'USDT' | 'KCS' | 'BTC';
     }): Promise<APISuccessResponse<IsolatedMarginAccountInfo>>;
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the getIsolatedMarginBalance() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use getIsolatedMarginBalance() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     getIsolatedMarginAccount(params: {
         symbol: string;

package/dist/mjs/SpotClient.js

@@ -129,7 +129,7 @@ export class SpotClient extends BaseRestClient {
     /**
      * Get Account - Cross Margin
      *
-     * Request via this endpoint to get the info of the cross margin account.
+     * Request cross margin account info. Preferred queryType: MARGIN. MARGIN_V2 phased out gradually.
      */
     getMarginBalance(params) {
         return this.getPrivate('api/v3/margin/accounts', params);
@@ -137,7 +137,7 @@ export class SpotClient extends BaseRestClient {
     /**
      * Get Account - Isolated Margin
      *
-     * Request via this endpoint to get the info of the isolated margin account.
+     * Request isolated margin account info. Preferred queryType: ISOLATED. ISOLATED_V2 phased out gradually.
      */
     getIsolatedMarginBalance(params) {
         return this.getPrivate('api/v3/isolated/accounts', params);
@@ -350,6 +350,7 @@ export class SpotClient extends BaseRestClient {
      * Get Transfer Quotas
      *
      * This endpoint returns the transferable balance of a specified account.
+     * Preferred type: MARGIN, ISOLATED. V2 (MARGIN_V2, ISOLATED_V2) phased out gradually.
      */
     getTransferable(params) {
         return this.getPrivate('api/v1/accounts/transferable', params);
@@ -357,7 +358,8 @@ export class SpotClient extends BaseRestClient {
     /**
      * Flex Transfer
      *
-     * This endpoint can be used for transfers between master and sub accounts and inner transfers
+     * Transfers between master/sub accounts and inner transfers.
+     * Preferred account types: MARGIN, ISOLATED. For non-INTERNAL type, use MARGIN/ISOLATED (not MARGIN_V2/ISOLATED_V2).
      */
     submitFlexTransfer(params) {
         return this.postPrivate('api/v3/accounts/universal-transfer', params);
@@ -1623,8 +1625,9 @@ export class SpotClient extends BaseRestClient {
      * DEPRECATED
      */
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the getMarginBalance() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use getMarginBalance() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     getMarginBalances() {
         return this.getPrivate('api/v1/margin/account');
@@ -1796,15 +1799,17 @@ export class SpotClient extends BaseRestClient {
      * DEPRECATED
      */
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the submitHFMarginOrder() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use submitHFMarginOrder() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     submitMarginOrder(params) {
         return this.postPrivate('api/v1/margin/order', params);
     }
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the submitHFMarginOrderTest() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use submitHFMarginOrderTest() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     submitMarginOrderTest() {
         return this.postPrivate('api/v1/margin/order/test');
@@ -1815,15 +1820,17 @@ export class SpotClient extends BaseRestClient {
      * DEPRECATED
      */
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the getMarginBalance() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use getIsolatedMarginBalance() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     getIsolatedMarginAccounts(params) {
         return this.getPrivate('api/v1/isolated/accounts', params);
     }
     /**
-     * @deprecated This method is deprecated.
-     * It is recommended to use the getIsolatedMarginBalance() endpoint instead of this endpoint
+     * @deprecated SPOT Margin LF endpoint no longer available (2026.03.04).
+     * Use getIsolatedMarginBalance() instead.
+     * @see https://www.kucoin.com/announcement/kucoin-margin-notice-250702
      */
     getIsolatedMarginAccount(params) {
         return this.getPrivate(`api/v1/isolated/account/${params.symbol}`);