kucoin-api 1.0.22 → 2.0.0

package/README.md

@@ -64,7 +64,7 @@ Check out my related JavaScript/TypeScript/Node.js projects:
 
 Most methods accept JS objects. These can be populated using parameters specified by Kucoin's API documentation.
 
-- [Kucoin API Documentation](https://www.kucoin.com/docs/beginners/introduction)
+- [Kucoin API Documentation](https://www.kucoin.com/docs-new/introduction)
 - Node.js Quick Start Guides
   - [Spot Node.js Kucoin Quick Start Guide](./examples/kucoin-SPOT-examples-nodejs.md)
   - [Futures Node.js Kucoin Quick Start Guide](./examples/kucoin-FUTURES-examples-nodejs.md)
@@ -102,7 +102,7 @@ const client = new SpotClient({
 });
 
 try {
-  const spotBuyResult = await client.submitOrder({
+  const spotBuyResult = await client.submitHFOrder({
     clientOid: client.generateNewOrderID(),
     side: 'buy',
     type: 'market',
@@ -111,7 +111,7 @@ try {
   });
   console.log('spotBuy ', JSON.stringify(spotBuyResult, null, 2));
 
-  const spotSellResult = await client.submitOrder({
+  const spotSellResult = await client.submitHFOrder({
     clientOid: client.generateNewOrderID(),
     side: 'sell',
     type: 'market',

package/dist/cjs/FuturesClient.d.ts

@@ -1,8 +1,8 @@
 import { AxiosRequestConfig } from 'axios';
 import { BaseRestClient } from './lib/BaseRestClient.js';
 import { RestClientOptions, RestClientType } from './lib/requestUtils.js';
-import { AccountFillsRequest, BatchCancelOrdersRequest, CreateSubAPIRequest, DeleteSubAPIRequest, GetFundingHistoryRequest, GetFundingRatesRequest, GetInterestRatesRequest, GetKlinesRequest, GetOrdersRequest, GetStopOrdersRequest, GetSubAPIsRequest, GetTransactionsRequest, GetTransfersRequest, MaxOpenSizeRequest, Order, SLTPOrder, SubmitTransfer, UpdateSubAPIRequest } from './types/request/futures.types.js';
-import { AccountBalance, AccountSummary, AddMargin, BatchCancelOrderResult, CreateSubAccountAPI, FullOrderBookDetail, FuturesAccountFundingRateHistory, FuturesAccountTransaction, FuturesActiveOrder, FuturesClosedPositions, FuturesCurrentFundingRate, FuturesFill, FuturesFills, FuturesHistoricFundingRate, FuturesKline, FuturesMarkPrice, FuturesOrder, FuturesOrders, FuturesPosition, FuturesRiskLimit, FuturesSymbolInfo, FuturesTransferRecords, IndexListItem, InterestRateItem, MarketTradeDetail, MaxOpenSize, PremiumIndexItem, SubAccountAPI, SubBalance, SubmitMultipleOrdersFuturesResponse, TickerDetail, TransferDetail, UpdateSubAccountAPI } from './types/response/futures.types.js';
+import { AccountFillsRequest, BatchCancelOrdersRequest, GetFundingHistoryRequest, GetFundingRatesRequest, GetInterestRatesRequest, GetKlinesRequest, GetOrdersRequest, GetStopOrdersRequest, GetTransactionsRequest, MaxOpenSizeRequest, Order, SLTPOrder } from './types/request/futures.types.js';
+import { AccountBalance, AccountSummary, AddMargin, BatchCancelOrderResult, FullOrderBookDetail, FuturesAccountFundingRateHistory, FuturesAccountTransaction, FuturesActiveOrder, FuturesClosedPositions, FuturesCurrentFundingRate, FuturesFill, FuturesFills, FuturesHistoricFundingRate, FuturesKline, FuturesMarkPrice, FuturesOrder, FuturesOrders, FuturesPosition, FuturesRiskLimit, FuturesSymbolInfo, IndexListItem, InterestRateItem, MarketTradeDetail, MaxOpenSize, PremiumIndexItem, SubBalance, SubmitMultipleOrdersFuturesResponse, TickerDetail } from './types/response/futures.types.js';
 import { APISuccessResponse, ServiceStatus } from './types/response/shared.types.js';
 import { WsConnectionInfo } from './types/response/ws.js';
 /**
@@ -17,32 +17,35 @@ export declare class FuturesClient extends BaseRestClient {
      *
      */
     generateNewOrderID(): string;
-    getServerTime(): Promise<APISuccessResponse<number>>;
-    getServiceStatus(): Promise<APISuccessResponse<ServiceStatus>>;
     /**
-     * REST - ACCOUNT  - BASIC INFO
+     *
+     * REST - ACCOUNT INFO - Account & Funding
+     *
+     */
+    /**
+     * Get Account - Futures
+     * Request via this endpoint to get the info of the futures account.
+     */
+    getBalance(params?: {
+        currency?: string;
+    }): Promise<APISuccessResponse<AccountBalance>>;
+    /**
      * Get Account Ledgers - Futures
+     * This interface can query the ledger records of the futures business line
      */
     getTransactions(params: GetTransactionsRequest): Promise<APISuccessResponse<{
         hasMore: boolean;
         dataList: FuturesAccountTransaction[];
     }>>;
     /**
-     * REST - ACCOUNT  - SUBACCOUNT API
+     *
+     * REST - ACCOUNT INFO - Sub Account
+     *
      */
-    getSubAPIs(params: GetSubAPIsRequest): Promise<APISuccessResponse<SubAccountAPI[]>>;
-    createSubAPI(params: CreateSubAPIRequest): Promise<APISuccessResponse<CreateSubAccountAPI>>;
-    updateSubAPI(params: UpdateSubAPIRequest): Promise<APISuccessResponse<UpdateSubAccountAPI>>;
-    deleteSubAPI(params: DeleteSubAPIRequest): Promise<APISuccessResponse<{
-        subName: string;
-        apiKey: string;
-    }>>;
     /**
-     * REST - FUNDING - FUNDING OVERVIEW
+     * Get SubAccount List - Futures Balance(V2)
+     * This endpoint can be used to get Futures sub-account information.
      */
-    getBalance(params?: {
-        currency?: string;
-    }): Promise<APISuccessResponse<AccountBalance>>;
     getSubBalances(params?: {
         currency?: string;
     }): Promise<APISuccessResponse<{
@@ -50,13 +53,13 @@ export declare class FuturesClient extends BaseRestClient {
         accounts: SubBalance[];
     }>>;
     /**
-     * REST - FUNDING - TRANSFER
+     *
+     * REST - Account Info - Trade Fee
+     *
      */
-    submitTransferOut(params: SubmitTransfer): Promise<Promise<APISuccessResponse<TransferDetail>>>;
-    submitTransferIn(params: SubmitTransfer): Promise<any>;
-    getTransfers(params: GetTransfersRequest): Promise<APISuccessResponse<FuturesTransferRecords>>;
     /**
-     * REST - FUNDING - TRADE FEE
+     * Get Actual Fee - Futures
+     * This interface is for the actual futures fee rate of the trading pair. The fee rate of your sub-account is the same as that of the master account.
      */
     getTradingPairFee(params: {
         symbol: string;
@@ -67,143 +70,293 @@ export declare class FuturesClient extends BaseRestClient {
     }>>;
     /**
      *
-     * REST - FUTURES TRADING - Market Data
+     * REST - Futures Trading - Market Data
      *
      */
-    getSymbols(): Promise<APISuccessResponse<FuturesSymbolInfo[]>>;
+    /**
+     * Get Symbol
+     * Get information of specified contracts that can be traded.
+     * This API will return a list of tradable contracts, including some key parameters of the contract such as the symbol name, tick size, mark price,etc.
+     */
     getSymbol(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FuturesSymbolInfo>>;
+    /**
+     * Get Symbol
+     * Get information of specified contracts that can be traded.
+     * This API will return a list of tradable contracts, including some key parameters of the contract such as the symbol name, tick size, mark price,etc.
+     */
+    getSymbols(): Promise<APISuccessResponse<FuturesSymbolInfo[]>>;
+    /**
+     * Get Ticker
+     * This endpoint returns "last traded price/size"、"best bid/ask price/size" etc. of a single symbol.
+     */
     getTicker(params: {
         symbol: string;
     }): Promise<APISuccessResponse<TickerDetail>>;
+    /**
+     * Get All Tickers
+     * This endpoint returns "last traded price/size"、"best bid/ask price/size" etc. of all symbol.
+     */
     getTickers(): Promise<APISuccessResponse<TickerDetail[]>>;
+    /**
+     * Get Full OrderBook
+     * Query for Full orderbook depth data. (aggregated by price)
+     */
     getFullOrderBookLevel2(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FullOrderBookDetail>>;
+    /**
+     * Get Part OrderBook
+     * Query for part orderbook depth data. (aggregated by price)
+     */
     getPartOrderBookLevel2Depth20(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FullOrderBookDetail>>;
+    /**
+     * Get Part OrderBook
+     * Query for part orderbook depth data. (aggregated by price)
+     */
     getPartOrderBookLevel2Depth100(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FullOrderBookDetail>>;
+    /**
+     * Get Trade History
+     * Request via this endpoint to get the trade history of the specified symbol, the returned quantity is the last 100 transaction records.
+     */
     getMarketTrades(params: {
         symbol: string;
     }): Promise<APISuccessResponse<MarketTradeDetail>>;
+    /**
+     * Get Klines
+     * Get the Kline of the symbol. Data are returned in grouped buckets based on requested type.
+     */
     getKlines(params: GetKlinesRequest): Promise<APISuccessResponse<FuturesKline[]>>;
-    getInterestRates(params: GetInterestRatesRequest): Promise<APISuccessResponse<{
-        dataList: InterestRateItem[];
-        hasMore: boolean;
-    }>>;
+    /**
+     * Get Mark Price
+     * Get the mark price of the symbol.
+     */
+    getMarkPrice(params: {
+        symbol: string;
+    }): Promise<APISuccessResponse<FuturesMarkPrice>>;
+    /**
+     * Get Spot Index Price
+     * This endpoint returns the index price of the specified symbol.
+     */
     getIndex(params: GetInterestRatesRequest): Promise<APISuccessResponse<{
         dataList: IndexListItem[];
         hasMore: boolean;
     }>>;
-    getMarkPrice(params: {
-        symbol: string;
-    }): Promise<APISuccessResponse<FuturesMarkPrice>>;
+    /**
+     * Get Interest Rate Index
+     * This endpoint returns the interest rate index of the specified symbol.
+     */
+    getInterestRates(params: GetInterestRatesRequest): Promise<APISuccessResponse<{
+        dataList: InterestRateItem[];
+        hasMore: boolean;
+    }>>;
+    /**
+     * Get Premium Index
+     * This endpoint returns the premium index of the specified symbol.
+     */
     getPremiumIndex(params: GetInterestRatesRequest): Promise<APISuccessResponse<{
         dataList: PremiumIndexItem[];
         hasMore: boolean;
     }>>;
+    /**
+     * Get 24hr Stats
+     * Get the statistics of the platform futures trading volume in the last 24 hours.
+     */
     get24HourTransactionVolume(): Promise<APISuccessResponse<{
         turnoverOf24h: number;
     }>>;
+    /**
+     * Get Server Time
+     * Get the API server time. This is the Unix timestamp.
+     */
+    getServerTime(): Promise<APISuccessResponse<number>>;
+    /**
+     * Get Service Status
+     * This endpoint returns the status of the API service.
+     */
+    getServiceStatus(): Promise<APISuccessResponse<ServiceStatus>>;
     /**
      *
-     * REST - FUTURES TRADING - Orders
+     * REST - Futures Trading - Orders
      *
      */
+    /**
+     * Add Order
+     * Place order to the futures trading system
+     */
     submitOrder(params: Order): Promise<APISuccessResponse<{
         orderId?: string;
         clientOid?: string;
     }>>;
-    submitNewOrderTest(): Promise<{
+    /**
+     * Add Order Test
+     * Order test endpoint, the request parameters and return parameters of this endpoint are exactly the same as the order endpoint, and can be used to verify whether the signature is correct and other operations.
+     */
+    submitNewOrderTest(params: Order): Promise<{
         orderId?: string;
         clientOid?: string;
     }>;
+    /**
+     * Batch Add Orders
+     * Place multiple order to the futures trading system
+     */
+    submitMultipleOrders(params: Order[]): Promise<APISuccessResponse<SubmitMultipleOrdersFuturesResponse[]>>;
+    /**
+     * Add Take Profit And Stop Loss Order
+     * Place take profit and stop loss order supports both take-profit and stop-loss functions, and other functions are exactly the same as the place order interface.
+     */
+    submitSLTPOrder(params: SLTPOrder): Promise<APISuccessResponse<{
+        orderId?: string;
+        clientOid?: string;
+    }>>;
+    /**
+     * Cancel Order By OrderId
+     * Cancel an order (including a stop order).
+     */
     cancelOrderById(params: {
         orderId: string;
     }): Promise<APISuccessResponse<{
         cancelledOrderIds: string[];
     }>>;
+    /**
+     * Cancel Order By Client Order Id
+     * Cancel an order (including a stop order) by client order id.
+     */
     cancelOrderByClientOid(params: {
         clientOid: string;
     }): Promise<APISuccessResponse<{
         clientOid: string;
     }>>;
+    /**
+     * Batch Cancel Orders
+     * Cancel multiple orders.
+     */
     batchCancelOrders(params: BatchCancelOrdersRequest): Promise<APISuccessResponse<{
         data: BatchCancelOrderResult[];
     }>>;
-    submitSLTPOrder(params: SLTPOrder): Promise<APISuccessResponse<{
-        orderId?: string;
-        clientOid?: string;
-    }>>;
-    submitMultipleOrders(params: Order[]): Promise<APISuccessResponse<SubmitMultipleOrdersFuturesResponse[]>>;
     /**
-     * @deprecated, use cancelAllOrdersV3 instead
+     * Cancel All Orders
+     * Using this endpoint, all open orders (excluding stop orders) can be canceled in batches.
      */
-    cancelAllOrders(params?: {
-        symbol?: string;
-    }): Promise<APISuccessResponse<{
-        cancelledOrderIds: string[];
-    }>>;
     cancelAllOrdersV3(params: {
         symbol: string;
     }): Promise<APISuccessResponse<{
         cancelledOrderIds: string[];
     }>>;
+    /**
+     * Cancel All Stop orders
+     * Using this endpoint, all untriggered stop orders can be canceled in batches.
+     */
     cancelAllStopOrders(params?: {
         symbol?: string;
     }): Promise<APISuccessResponse<{
         cancelledOrderIds: string[];
     }>>;
-    getOrders(params?: GetOrdersRequest): Promise<APISuccessResponse<FuturesOrders>>;
-    getStopOrders(params?: GetStopOrdersRequest): Promise<APISuccessResponse<FuturesOrders>>;
-    getRecentOrders(params?: {
-        symbol?: string;
-    }): Promise<APISuccessResponse<FuturesOrder[]>>;
+    /**
+     * Get Order By OrderId
+     * Get order details by order id.
+     */
     getOrderByOrderId(params: {
         orderId: string;
     }): Promise<APISuccessResponse<FuturesOrder>>;
+    /**
+     * Get Order By Client Order Id
+     * Get order details by client order id.
+     */
     getOrderByClientOrderId(params: {
         clientOid: string;
     }): Promise<APISuccessResponse<FuturesOrder>>;
     /**
-     *
-     * REST - FUTURES TRADING - Fills
-     *
+     * Get Order List
+     * List your current orders. Any limit order on the exchange order book is in active status.
      */
+    getOrders(params?: GetOrdersRequest): Promise<APISuccessResponse<FuturesOrders>>;
     /**
-     * Get a list of recent fills.
-     *
-     * If you need to get your recent trade history with low latency, please query endpoint Get List of Orders Completed in 24h.
-     * The requested data is not real-time.
+     * Get Recent Closed Orders
+     * Get a list of recent 1000 closed orders in the last 24 hours.
      */
-    getFills(params?: AccountFillsRequest): Promise<APISuccessResponse<FuturesFills>>;
+    getRecentOrders(params?: {
+        symbol?: string;
+    }): Promise<APISuccessResponse<FuturesOrder[]>>;
     /**
+     * Get Stop Order List
+     * Get the un-triggered stop orders list. Stop orders that have been triggered can be queried through the general order interface
+     */
+    getStopOrders(params?: GetStopOrdersRequest): Promise<APISuccessResponse<FuturesOrders>>;
+    /**
+     * Get Open Order Value
+     * You can query this endpoint to get the the total number and value of the all your active orders.
+     */
+    getOpenOrderStatistics(params: {
+        symbol: string;
+    }): Promise<APISuccessResponse<FuturesActiveOrder>>;
+    /**
+     * Get Recent Trade History
      * Get a list of recent 1000 fills in the last 24 hours.
-     *
-     * If you need to get your recent traded order history with low latency, you may query this endpoint.
      */
     getRecentFills(params?: {
         symbol?: string;
     }): Promise<APISuccessResponse<FuturesFill[]>>;
-    getOpenOrderStatistics(params: {
-        symbol: string;
-    }): Promise<APISuccessResponse<FuturesActiveOrder>>;
+    /**
+     * Get Trade History
+     * Get a list of recent fills.
+     * If you need to get your recent trade history with low latency, please query endpoint Get List of Orders Completed in 24h. The requested data is not real-time.
+     */
+    getFills(params?: AccountFillsRequest): Promise<APISuccessResponse<FuturesFills>>;
     /**
      *
-     * REST - FUTURES TRADING - Positions
+     * REST - Futures Trading - Positions
      *
      */
+    /**
+     * Get Margin Mode
+     * This interface can query the margin mode of the current symbol.
+     */
+    getMarginMode(params: {
+        symbol: string;
+    }): Promise<APISuccessResponse<{
+        symbol: string;
+        marginMode: 'ISOLATED' | 'CROSS';
+    }>>;
+    /**
+     * Switch Margin Mode
+     * Modify the margin mode of the current symbol.
+     */
+    updateMarginMode(params: {
+        symbol: string;
+        marginMode: 'ISOLATED' | 'CROSS';
+    }): Promise<APISuccessResponse<{
+        symbol: string;
+        marginMode: 'ISOLATED' | 'CROSS';
+    }>>;
+    /**
+     * Get Max Open Size
+     * Get Maximum Open Position Size.
+     */
     getMaxOpenSize(params: MaxOpenSizeRequest): Promise<APISuccessResponse<MaxOpenSize>>;
+    /**
+     * Get Position Details
+     * Get the position details of a specified position.
+     */
     getPosition(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FuturesPosition>>;
+    /**
+     * Get Position List
+     * Get the position details of a specified position.
+     */
     getPositions(params?: {
         currency?: string;
     }): Promise<APISuccessResponse<FuturesPosition[]>>;
+    /**
+     * Get Positions History
+     * This interface can query position history information records.
+     */
     getHistoryPositions(params?: {
         symbol?: string;
         from?: number;
@@ -211,44 +364,27 @@ export declare class FuturesClient extends BaseRestClient {
         limit?: number;
         pageId?: number;
     }): Promise<APISuccessResponse<FuturesClosedPositions>>;
-    updateAutoDepositStatus(params: {
-        symbol: string;
-        status: boolean;
-    }): Promise<APISuccessResponse<boolean>>;
+    /**
+     * Get Max Withdraw Margin
+     * This interface can query the maximum amount of margin that the current position supports withdrawal.
+     */
     getMaxWithdrawMargin(params: {
         symbol: string;
     }): Promise<APISuccessResponse<number>>;
-    withdrawMargin(params: {
-        symbol: string;
-        withdrawAmount: string;
-    }): Promise<APISuccessResponse<{
-        sybmol: string;
-        withdrawAmount: number;
-    }>>;
-    depositMargin(params: {
-        symbol: string;
-        margin: number;
-        bizNo: string;
-    }): Promise<APISuccessResponse<AddMargin>>;
-    getMarginMode(params: {
-        symbol: string;
-    }): Promise<APISuccessResponse<{
-        symbol: string;
-        marginMode: 'ISOLATED' | 'CROSS';
-    }>>;
-    updateMarginMode(params: {
-        symbol: string;
-        marginMode: 'ISOLATED' | 'CROSS';
-    }): Promise<APISuccessResponse<{
-        symbol: string;
-        marginMode: 'ISOLATED' | 'CROSS';
-    }>>;
+    /**
+     * Get Cross Margin Leverage
+     * This interface can query the current symbol’s cross-margin leverage multiple.
+     */
     getCrossMarginLeverage(params: {
         symbol: string;
     }): Promise<APISuccessResponse<{
         symbol: string;
         leverage: string;
     }>>;
+    /**
+     * Modify Cross Margin Leverage
+     * This interface can modify the current symbol’s cross-margin leverage multiple.
+     */
     changeCrossMarginLeverage(params: {
         symbol: string;
         leverage: string;
@@ -257,26 +393,61 @@ export declare class FuturesClient extends BaseRestClient {
         leverage: string;
     }>>;
     /**
-     *
-     * REST - FUTURES TRADING - Risk limit
-     *
+     * Add Isolated Margin
+     * Add Isolated Margin Manually.
+     */
+    depositMargin(params: {
+        symbol: string;
+        margin: number;
+        bizNo: string;
+    }): Promise<APISuccessResponse<AddMargin>>;
+    /**
+     * Remove Isolated Margin
+     * Remove Isolated Margin Manually.
+     */
+    withdrawMargin(params: {
+        symbol: string;
+        withdrawAmount: string;
+    }): Promise<APISuccessResponse<{
+        sybmol: string;
+        withdrawAmount: number;
+    }>>;
+    /**
+     * Get Isolated Margin Risk Limit
+     * This interface can be used to obtain information about risk limit level of a specific contract(Only valid for isolated Margin).
      */
     getRiskLimitLevel(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FuturesRiskLimit[]>>;
+    /**
+     * Modify Isolated Margin Risk Limit
+     * This interface is for the adjustment of the risk limit level(Only valid for isolated Margin).
+     */
     updateRiskLimitLevel(params: {
         symbol: string;
         level: number;
     }): Promise<any>;
     /**
      *
-     * REST - FUTURES TRADING - Funding fees
+     * REST - Futures Trading - Funding Fees
      *
      */
+    /**
+     * Get Current Funding Rate
+     * This interface can be used to obtain the current funding rate of the specified symbol.
+     */
     getFundingRate(params: {
         symbol: string;
     }): Promise<APISuccessResponse<FuturesCurrentFundingRate>>;
+    /**
+     * Get Public Funding History
+     * Query the funding rate at each settlement time point within a certain time range of the corresponding contract
+     */
     getFundingRates(params: GetFundingRatesRequest): Promise<APISuccessResponse<FuturesHistoricFundingRate[]>>;
+    /**
+     * Get Private Funding History
+     * Submit request to get the funding history.
+     */
     getFundingHistory(params: GetFundingHistoryRequest): Promise<APISuccessResponse<{
         dataList: FuturesAccountFundingRateHistory[];
         hasMore: boolean;
@@ -298,4 +469,39 @@ export declare class FuturesClient extends BaseRestClient {
      */
     getPublicWSConnectionToken(): Promise<APISuccessResponse<WsConnectionInfo>>;
     getPrivateWSConnectionToken(): Promise<APISuccessResponse<WsConnectionInfo>>;
+    /**
+     * @deprecated - please use universal transfer from SpotClient
+     */
+    submitTransferOut(params: {
+        currency: string;
+        amount: number;
+        recAccountType: 'MAIN' | 'TRADE';
+    }): Promise<APISuccessResponse<any>>;
+    /**
+     * @deprecated - please use universal transfer from SpotClient
+     */
+    submitTransferIn(params: {
+        currency: string;
+        amount: number;
+        payAccountType: 'MAIN' | 'TRADE';
+    }): Promise<APISuccessResponse<any>>;
+    /**
+     * @deprecated - please use universal transfer from SpotClient
+     */
+    getTransfers(params?: {
+        currency?: string;
+        type?: 'MAIN' | 'TRADE' | 'MARGIN' | 'ISOLATED';
+        tag?: string[];
+        startAt?: number;
+        endAt?: number;
+        currentPage?: number;
+        pageSize?: number;
+    }): Promise<APISuccessResponse<any>>;
+    /**
+     * @deprecated - please use updateMarginMode() instead
+     */
+    updateAutoDepositStatus(params: {
+        symbol: string;
+        status: boolean;
+    }): Promise<APISuccessResponse<any>>;
 }