How to Use Kucoin Futures Cross Margin Via API
06/17/2025, 15:06:02
Dear KuCoin User,
The Kucoin Futures Cross Margin API has been upgraded recently. This article will help you complete the integration of the Futures Cross Margin API.
Step 1: Obtain symbol information
Call the Get All Symbols interface to get the basic information of Futures Symbols.
Step 2: Check Cross Margin risk limit
Call the Get Cross Margin Risk Limit interface to query the risk limit in batches, that is, the maximum open size corresponding to the specific leverage and margin. Click on the Kucoin Futures Cross Margin mode to learn more about the Futures Cross Margin mechanism.
Step 3: Switch the margin mode of the target symbols to Cross Margin
Call the Batch Switch Margin Mode interface to adjust symbols' margin mode in batches. Note that there must be no active orders or positions under the target symbol.
Step 4: Set leverage
Kucoin uses a fixed leverage model commonly used in the industry. You can check the current leverage through Get Cross Margin Leverage and adjust the leverage of specific symbol through Modify Cross Margin Leverage . Note that when the leverage is lowered, the margin required by active orders and positions will increase, and vice versa.
Step 5: Obtain market data
Ticker , Kline , Orderbook , Trades and other market data interfaces can continue to be used normally in cross margin mode.
Step 6: Place an order and trade
Cross margin mode shares the same trading interfaces for placing orders , canceling orders , order inquiry , etc with isolated margin. We recommend that you use the Get Max Open Size interface to obtain the actual maximum open position of the current account calculated by the system, so as to avoid the order quantity exceeding the risk limit and causing the order to fail.
Note that the two imported parameters "Leverage" and "MarginMode" in the order interface are only useful for isolated margin mode. When placing an order in full position mode, the leverage and margin modes will be based on the leverage and margin modes set in Step3 and Step4.
Step 7: Query position information
Use Get Position list and Get Positions History to obtain active and historical position information. If the interface returns "MarginMode" as "CROSS" in the data, it means that the corresponding position is in cross margin mode . In addition, for active cross margin positions, you can obtain the Maintenance Margin rate and Maintenance Margin of the position with "maintMarginReq" and "posMaint" in the returned messages.
FAQs
-
What are the advantages of Futures Cross Margin Mode?
View The advantages of Futures Cross Margin to quickly understand the advantages of Futures Cross Margin Mode.
-
Which symbols support cross mrgin mode?
Cross mrgin mode support all symbols in Kucoin Futures market.
-
Will using cross mrgin mode increase lattency ?
No, there is no lattency difference between cross and isolated margin mode.
We sincerely appreciate your support!
The KuCoin Futures Team
Risk Warning: Futures trading is a high-risk activity with the potential for huge gains and huge losses. Previous gains do not indicate future returns. Severe price fluctuations may result in the forced liquidation of your entire margin balance. This information should not be regarded as investment advice from KuCoin. All trading is done at your own discretion and your own risk. KuCoin is not liable for any losses resulting from Futures trading.
Thank you for your support!
The KuCoin Team
Find The Next Crypto Gem On KuCoin!