批次新增訂單同步

說明

此端點支援從單一端點順序批次下單。最多可同時下 20 張訂單。

此界面與「批次新增訂單」的差異在於，此界面會在訂單撮合完成後同步傳回訂單資訊。

若需要較高的延遲時間，請選擇「批次新增訂單」界面。如果需要傳回資料的完整性，請選擇此界面。

提示

此端點只支援下單請求。若要取得下單的結果，您需要檢查訂單狀態或訂閱 Websocket 以取得訂單的相關資訊。

提示

請注意，一旦您的訂單進入買賣盤，系統會提前凍結訂單的手續費。

在下單前，請務必充分瞭解各交易對參數的含義。

提示

每個帳戶的有效訂單數量上限為 2000，每個交易對的有效訂單數量上限為 200。

公開下單請求參數

參數	類型	是否必須	描述
clientOid	String	No	客戶訂單 ID，用戶建立的唯一識別碼、建議使用 UUID
symbol	String	Yes	交易對
type	String	Yes	訂單類型 `limit` 和 `market`
side	String	Yes	`buy` or `sell`
stp	String	No	自成交防範分為四種策略：`CN`, `CO`, `CB` , 和 `DC`
tags	String	No	訂單標籤，長度不能超過 `20` 個字符（ASCII）
remark	String	No	訂單備註、長度不可超過 `20` 個字元 (ASCII)

limit 限價單所需的附加請求參數

參數	類型	是否必須	描述
price	String	Yes	指定貨幣價格
size	String	Yes	指定貨幣數量
timeInForce	String	No	訂單時間策略 `GTC`、GTT`,` IOC`、`FOK`(預設為`GTC`)
cancelAfter	long	No	`n` 秒後取消，訂單定時策略為 `GTT`
postOnly	boolean	No	被動訂單標籤、當訂單計時策略為 `IOC` 或 `FOK` 時，此功能會停用
hidden	boolean	No	是否隱藏 (不顯示在買賣盤中)
iceberg	boolean	No	是否只在買賣盤中顯示訂單的可見部分？冰山單
visibleSize	String	No	冰山單中的最大可見數量

Market市價訂單所需的附加請求參數

參數	類型	是否必須	描述
size	String	No	(從兩者中選擇其一：`size` 或 `funds`)
funds	String	No	(二選一: `size` 或 `funds`)

Hold

對於限價購買訂單，我們將持有您的購買訂單所需的資金額（價格* 大小）。同樣地，對於限價賣出指令，我們也會持有您的賣出指令資產。交易執行時，會計算服務費。如果您取消已成交或未成交訂單的一部分，那麼剩餘的資金或金額將被釋放並退回到您的帳戶。對於需要特定資金的市價買/賣訂單，我們會從您的帳戶中保留所需資金。如果只指定了大小，我們可能會在訂單成交或取消之前凍結（通常是很短的時間）您帳戶中的所有資金。

委託生命週期

當下單請求成功（撮合引擎收到訂單）或拒絕（因資金不足或參數值不合法等原因）時，系統會回應 HTTP 請求。訂單成功下達時，會傳回訂單 ID。訂單將進行撮合，這可能導致訂單全部或部分成交。當訂單全部或部分成交時，訂單的剩餘部分將處於有效狀態，等待撮合（這不包括 IOC 訂單）。全部或部分成交（已取消）的訂單將進入「已完成」狀態。

訂閱市場數據頻道的用戶可以使用訂單 ID (orderId) 和客戶 ID (clientOid) 來識別訊息。

價格保護機制

下單時會啟用價格保護機制。詳細規則如下：

如果用戶下達的幣幣交易市價單/限價單可以直接與當前買賣盤中的訂單進行撮合，系統將判斷交易深度對應的價格與差價之間的偏差是否超過閾值（閾值可使用交易對 API 端點獲取）；

如果超出，對於限價單，訂單會直接取消；

如果是市價盤，系統會部分執行該訂單。執行限額將是與閾值相對應的價格範圍內的訂單大小。餘下的訂單將不會完成。

例如：如果閾值為 10%，當用戶在 KCS/USDT 交易市場下了 10,000 USDT 的市價購買訂單時（目前賣出價為 1.20000），系統會判定在訂單完全成交後，最終價格為 1.40000。(1.40000-1.20000)/1.20000=16.7%>10%.閾值為 1.32000。用戶的市價買入訂單只會在最高 1.32000 的情況下成交。剩餘的訂單部分將不會與買賣盤中的訂單撮合。請注意：此功能可能無法完全精確地判斷深度。如果您的訂單沒有完全成交，可能是因為超過閾值的部分沒有成交。

curl --location --request POST 'https://api.kucoin.com/api/v1/hf/orders/multi/sync' \ --header 'Content-Type: application/json' \ --data-raw '{ "orderList": [ { "clientOid": "client order id 13", "symbol": "BTC-USDT", "type": "limit", "side": "buy", "price": "30000", "size": "0.00001" }, { "clientOid": "client order id 14", "symbol": "ETH-USDT", "type": "limit", "side": "sell", "price": "2000", "size": "0.00001" } ] }'

{"code":"200000","data":[{"orderId":"6711195e5584bc0007bd5aef","clientOid":"client order id 13","orderTime":1729173854299,"originSize":"0.00001","dealSize":"0","remainSize":"0.00001","canceledSize":"0","status":"open","matchTime":1729173854326,"success":true},{"success":false,"failMsg":"The order funds should more then 0.1 USDT."}]}

批次新增訂單同步

Request

Responses