新增訂單- V1

提示

建議使用POST /api/v3/hf/margin/order 端點，而不是此端點

說明

在全倉或逐倉槓桿交易系統下單。您可以下兩種主要的訂單：限價和市價。只有在您的帳戶有足夠資金的情況下才能下單。一旦下單，您的資金將在訂單期間暫停使用。保留的資金金額取決於指定的訂單類型和參數。

提示

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

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

提示

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

公開下單請求參數

Param	Type	Mandatory	Description
clientOid	String	Yes	客戶訂單 ID，由用戶建立的唯一識別碼、建議使用 UUID
符號	String	Yes	符號
side	String	Yes	'buy' or 'sell'
type	String	No	訂單類型「限價」和「市價」，預設為限價
stp	String	No	自成交防範分為四種策略：'CN'、'CO'、'CB' 和 'DC'
marginModel	String	No	交易類型，包括全倉（全倉模式）和逐倉（逐倉模式）。預設為全倉。
autoBorrow	boolean	No	當槓桿帳戶有低效餘額時，我們的系統自動借入低效資產，並根據最低市場利率開倉。
autoRepay	boolean	No	AutoPay 允許在您平倉時歸還借入的資產。我們的系統自動觸發還款，最高還款金額等於已成交訂單的金額。

限價單所需的額外請求參數

Param	Type	Mandatory	Description
price	String	Yes	Specify price for currency
size	String	Yes	Specify quantity for currency
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	在冰山單中的最大可見數量

「市場」訂單所需的附加請求參數

Param	Type	Mandatory	Description
size	String	No	(二選一：「規模」或「資金」)
funds	String	No	(二選一：「規模」或「資金」)

隱藏委託和冰山單 (Hidden & Iceberg)

隱藏委託和冰山單可以在進階設定中設定（冰山單是隱藏委託的一種特殊類型）。下限價單或止損限價單時，您可以選擇根據隱藏委託或冰山單執行。

隱藏委託不會顯示在買賣盤中。

與隱藏委託不同，冰山單分為可見部分和隱藏部分。從事冰山單時，必須設定可見的訂單大小。冰山單的最小可見數量為總訂單數量的 1/20。

配對時，先配對冰山單的可見部分。一旦可見的部分完全撮合，隱藏的部分就會出現。這將持續到訂單全部完成為止。

請注意：

系統會針對隱藏委託和冰山單收取吃單手續費係數。

如果您同時設定冰山單和隱藏委託，您的訂單將預設為冰山單執行。

持有

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

委託生命週期

當下單請求成功（撮合引擎收到訂單）或拒絕（因資金不足或參數值不合法等原因）時，系統會回應 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 的情況下成交。剩餘的訂單部分將不會與買賣盤中的訂單撮合。請注意：此功能可能無法完全精確地判斷深度。如果您的訂單沒有完全成交，可能是因為超過閾值的部分沒有成交。

Request

Body Params application/json

Example

//limit order
{
    "type": "limit",
    "symbol": "BTC-USDT",
    "side": "buy",
    "price": "50000",
    "size": "0.00001",
    "clientOid": "5c52e11203aa677f33e4193fb",
    "remark": "order remarks"
}

//market order 1
// {
//     "type": "market",
//     "symbol": "BTC-USDT",
//     "side": "buy",
//     "size": "0.00001",
//     "clientOid": "5c52e11203aa677f33e493fc",
//     "remark": "order remarks"
// }

//market order 2
// {
//     "type": "market",
//     "symbol": "BTC-USDT",
//     "side": "buy",
//     "funds": "1",
//     "clientOid": "5c52e11203aa677f33e493fc",
//     "remark": "order remarks"
// }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "orderId": "671bb90194422f00073ff4f0",
        "loanApplyId": null,
        "borrowSize": null,
        "clientOid": null
    }
}

Request

Request Code Samples

Responses