如何使用 KuCoin Futures全倉API

17/06/2025 15:06:02

親愛的 KuCoin 用戶：

KuCoin Futures 全倉API最近已升級。本篇文章將幫助您完成全倉API的整合。

第 1 步：獲取交易對資訊

調用 Get All Symbols 介面以獲取 Futures 交易對的基本資訊。

第 2 步：檢查全倉風險限額

調用 Get Cross Margin Risk Limit 介面以批量查詢風險限額，即特定槓桿和保證金對應的最大開倉量。點擊 KuCoin Futures 全倉模式以了解更多有關 Futures 全倉機制的資訊。

第 3 步：將目標交易對的保證金模式切換至全倉

調用 Batch Switch Margin Mode 介面以批量調整交易對的保證金模式。注意，目標交易對下不得有活躍訂單或持倉。

第 4 步：設置槓桿

KuCoin 使用業界常見的固定槓桿模型。您可以通過 Get Cross Margin Leverage 檢查當前槓桿，並通過 Modify Cross Margin Leverage 調整特定交易對的槓桿。請注意，當槓桿降低時，活躍訂單和持倉所需的保證金會增加，反之亦然。

第 5 步：獲取市場數據

Ticker , Kline , Orderbook , Trades 等市場數據介面在全倉模式下可正常使用。

第 6 步：下單與交易

全倉模式與 Isolated Margin 共享相同的交易介面，用於下單 , 取消訂單 , 訂單查詢等。我們建議您使用 Get Max Open Size 介面以獲取系統計算的當前帳戶實際最大開倉量，避免訂單數量超出風險限額導致訂單失敗。

注意：訂單介面的兩個導入參數「Leverage」（槓桿）和「MarginMode」（保證金模式）僅適用於逐倉保證金模式。在全倉模式下下單時，槓桿倍數和保證金模式將根據第 3 步和第 4 步設定的槓桿倍數和保證金模式運行。

步驟 7：查詢倉位資訊

使用Get Position list和Get Positions History以獲取活躍倉位及歷史倉位資訊。如果介面回傳的資料中「MarginMode」顯示為「CROSS」，則意味該倉位處於全倉保證金模式。此外，針對活躍的全倉倉位，您可以通過回傳訊息中的「maintMarginReq」和「posMaint」獲取倉位的維持保證金率及維持保證金。