Notification of API Updates

Notification of API Updates

09/25/2024, 10:16:42

Dear KuCoin API users,

Kucoin Futures API has completed non-stop upgrades and now supports cross-margin mode. with specific optimizations as follows:

1、Futures add "GET /api/v2/position/getMarginMode" endpoint
2、Futures add "POST /api/v2/position/changeMarginMode" endpoint
3、Futures add "GET /api/v2/getCrossUserLeverage" endpoint
4、Futures add "POST /api/v2/changeCrossUserLeverage" endpoint
5、Futures add "Topic: /contract/marginMode" endpoint
6、Futures add "Topic: /contract/crossLeverage" endpoint
7、Futures modify "POST /api/v1/orders" endpoint, add "marginMode" request param
8、Futures modify "POST /api/v1/orders/multi" endpoint, add "marginMode" request param
9、Futures modify "GET /api/v1/orders" endpoint, add "marginMode" response param
10、Futures modify "GET /api/v1/stopOrders" endpoint, add "marginMode" response param11、Futures modify "GET /api/v1/recentDoneOrders" endpoint, add "marginMode" response param
12、Futures modify "GET /api/v1/orders/{order-id}" endpoint, add "marginMode" response param
13、Futures modify "GET /api/v1/orders/byClientOid?clientOid={client-order-id}" endpoint, add "marginMode" response param
14、Futures modify "GET /api/v1/fills" endpoint, add "marginMode" response param
15、Futures modify "GET /api/v1/recentFills" endpoint, add "marginMode" response param
16、Futures modify "GET /api/v1/position" endpoint, add "marginMode"、"positionSide"、"leverage"、"posFunding" response param
17、Futures modify "GET /api/v1/positions" endpoint, add "marginMode"、"positionSide"、"leverage"、"posFunding" response param
18、Futures modify "Topic: /contractMarket/tradeOrders" endpoint, add "marginMode" response param
19、Futures modify "Topic: /contractMarket/tradeOrders:{symbol}" endpoint, add "marginMode" response param
20、Futures modify "Topic: /contractMarket/advancedOrders" endpoint, add "marginMode" response param
21、Futures modify "Topic: /contractAccount/wallet" endpoint, add "walletBalance.change subject", deprecated "orderMargin.change"、"availableBalance.change"、"withdrawHold.change subject"
22、Futures modify "Topic: /contract/position:{symbol}" endpoint, add "marginMode"、"positionSide"、"leverage"、"posFunding" response param
23、Futures modify "Topic: /contract/positionAll" endpoint, add "marginMode"、"positionSide"、"leverage"、"posFunding" response param

The following are some frequently QA about cross margin:
1. Does cross margin mode still use a single currency as its margin?
Answer: Yes.
2. Does the fact that a contract isn’t enabled mean the current methods for placing orders or requests remain the same?
Answer: Yes, it remains unchanged.
3. Can a symbol be changed to cross margin mode, and if so, does the order's margin mode for that symbol still apply after the change?
Answer: The correct margin mode must be selected when placing the order, and cannot be changed midway.
4. After setting the cross margin, does the leverage on the order still apply?
Answer: No, the cross margin leverage takes priority.
5. Is there any difference in latency between cross margin and isolated margin?
Answer: From internal testing results, there has been concluded to be no noticeable difference.
6. Does enabling cross margin mode disable the Auto-Deposit feature, or do they work simultaneously for a while?
Answer: Auto-Deposit remains functional in isolated margin but is not applicable under cross margin.

For more API communication or feedback, please join our official API Telegram group: https://t.me/KuCoin_API

Thank you for your support of KuCoin!

The KuCoin API Team