下單

  //Request
  {
    "clientOid": "5c52e11203aa677f33e493fb",
    "reduceOnly": false,
    "closeOrder": false,
    "forceHold": false,
    "hidden": false,
    "iceberg": false,
    "leverage": 20,
    "postOnly": false,
    "price": 8000,
    "remark": "remark",
    "side": "buy",
    "size": 20,
    "stop": "",
    "stopPrice": 0,
    "stopPriceType": "",
    "symbol": "XBTUSDM",
    "timeInForce": "",
    "type": "limit",
    "visibleSize": 0
  }
  
  //Response
  {
    "code": "200000",
    "data": {
      "orderId": "5bd6e9286d99522a52e458de"
      }
  }

有兩種訂單類型：限價單和市價單。只有當賬戶資金充足時，下單纔會成功。下單後，系統將根據指定訂單類型和參數，凍結相應資金，直至訂單完結。

注意：系統將在訂單進入買賣盤前凍結手續費用。查看成交記錄，瞭解更多詳情。

請勿在JSON字符串中添加空格。

下單限制

一個賬戶中，每種合約最多可下100個限價單和50個止損單。

HTTP請求

POST /api/v1/orders

示例

POST /api/v1/orders

API權限

此接口需要合約交易權限

請求URL

此接口支持合約URL

頻率限制

合约类权重：limit 2, market 2

參數

下單公有的請求參數

參數	數據類型	是否必須	含義
clientOid	String	是	唯一的訂單ID，可用於識別訂單，長度最大不超過40。如：UUID 只能包含數字、字母、下劃線（_）或 分隔線（-）
side	String	是	buy 或 sell
symbol	String	是	有效合約代碼。如：XBTUSDM
leverage	String	是	槓桿表示訂單凍結保證金時使用的槓桿倍數，如果是平倉單可以不設置此屬性。
type	String	否	訂單類型，包括limit或market,默認limit。
remark	String	否	下單備註，字符長度不能超過100 個字符（UTF-8）。
stop	String	否	觸發價格的兩種類型。下跌至某個價格（down），或上漲至某個價格（up）。設置後，就必須設置stopPrice和stopPriceType 參數。
stopPriceType	String	否	止損單觸發價類型，包括TP、IP和MP， 只要設置stop參數，就必須設置此屬性。
stopPrice	String	否	只要設置stop參數，就必須設置此屬性。
reduceOnly	boolean	否	只減倉標記, 默認值是 false 。值爲true時，需要設置平倉數量。被標記爲只減倉的訂單隻會被以減倉的方向撮合（不會增加倉位），當用戶倉位數量小於只減倉訂單數量時，多餘數量的訂單數量會被撮合引擎取消掉。
closeOrder	boolean	否	平倉單標記, 默認值是 false 。值爲true時，代表倉位全平。平倉單會把當前用戶的所有倉位修改爲 0。平倉單標記爲 true 時，不需要傳入買賣方向和訂單數量參數，系統會根據用戶當前倉位的方向和數量動態決定訂單的買賣方向和訂單數量。由於減倉不需要凍結，所以有也不需要傳入槓桿參數。
forceHold	boolean	否	強制凍結標記（減倉同樣適用）,可將訂單留在買賣盤中而不受倉位變化的影響。默認值是 false。下當前倉位的反向訂單時，會凍結相應資金以確保訂單不會因爲沒有足夠的資金而被撮合引擎自動取消。
stp	String	否	自成交保護 分爲CN, CO, CB三種策略，暫不支持DC

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

參數	數據類型	是否必須	含義
price	String	是	限價單的價格
size	Integer	是	訂單數量。必須是一個正數。
timeInForce	String	否	訂單時效策略，包括GTC、IOC（默認爲GTC）。
postOnly	boolean	否	只掛單的標識。選擇postOnly，不允許選擇hidden和iceberg。當訂單時效爲IOC策略時，該參數無效。選擇被動委託的訂單，增加了市場的流動性，將按照maker費用執行。
hidden	boolean	否	訂單不會在買賣盤中展示。選擇hidden，不允許選擇postOnly。
iceberg	boolean	否	僅設置可見的部分會顯示在買賣盤中。選擇iceberg，不允許選擇postOnly。
visibleSize	Integer	否	冰山單最大可展示的數量。

market 市價單額外所需請求參數

參數	數據類型	是否必須	含義
size	Integer	否	下單數量

返回值

參數	含義
orderId	訂單id

術語解釋

用戶訂單ID

ClientOid字段是客戶端創建的唯一的ID（推薦使用UUID），只能包含數字、字母、下劃線（_） 和 分隔線（-）。這個字段會在獲取訂單信息時返回。您可使用clientOid來標識您的訂單。ClientOid不同於服務端創建的訂單ID。請不要使用同一個clientOid發起請求。clientOid最長不得超過40個字符。

請妥善記錄服務端創建的orderId，以用於查詢訂單狀態的更新。

TYPE

您在下單時指定的訂單類型，決定了您是否需要請求其他參數，同時還會影響到撮合引擎的執行。如果您在下單時未指定訂單類型，系統將默認按照限價單執行。

下限價單時，您需指定限價單的價格（price）和數量（size）。系統將根據市場行情以指定或更優價格撮合該訂單。如果訂單未能被立即撮合，將繼續留買賣盤中，直至被撮合或被用戶取消。

與限價單不同，市價單價格會隨着市場價格波動而變化。下市價單時，您無需指定價格，只需指定合約數量。市價單會立即成交，不會進入買賣盤。所有市價單都是taker，需支付taker費用。

STOP ORDERS

止損單，是指當市場價格達到了設置的止損觸發價格（stopPrice）觸發合約後，訂單按照市場價格或指定價格買進或賣出相應數量的合約。止損單分爲兩種，向下止損（down）和向上止損（up）。

止損單類型

向下止損（down）：當價格下跌至或低於設置的止損價格（stopPrice）時，訂單將被觸發。

向上止損（up）：當價格上漲至或高於設置的止損價格（stopPrice）時，訂單將被觸發。

止損單觸發價類型：

1. 最新交易價格（TP）：最新交易價格，指最近一次的訂單成交價格，該價格可在最新撮合消息中找到。
2. 標記價格（MP）：可以通過相關指數服務OPEN API獲取
3. 指數價格（IP）：可以通過相關指數服務OPEN API獲取

請注意，當止損單被觸發後，訂單將按照指定訂單類型，以市價單或限價單成交。 進行止盈止損交易時，系統不會提前凍結您的賬戶資金。訂單被觸發後，如果賬戶餘額不足時，訂單會被自動取消。

PRICE

下單價格必須是合約tickSize的整數倍，否則下單時會報錯。tickSize是合約價格的最小精度單位。合約價格不能超過合約最高價格（maxPrice）規定。KuCoin Futures平台採用了IEPR價格保護機制（Immediately Executable Price Range, 簡稱爲IEPR），合約購買價格不得超過1.05*標記價格的價格上限，合約賣出價格不得低於0.95 *標記價格的價格下限。

下市價單不需要價格字段。

訂單數量

訂單數量是合約的張數, 訂單數量不能小於合約最小數量（lotSize）或大於合約最大數量（maxOrderQty）。訂單數量必須是lotSize的整數倍，否則下單時系統會報錯。訂單數量表示要買入或賣出的合約數量大小。每張 XBTUSDTM 合約對應 0.001 BTC, 每張 XBTUSDM 合約對應 1 USD.

訂單時效

訂單時效是一種交易時使用的特殊策略，用於設定訂單在被撮合或取消前的生效時間。訂單時效策略分爲兩種：

1. 取消前有效（Good Till Canceled，簡稱爲GTC）：指委託將持續有效直到被手動取消。如果用戶在交易時沒有設置該字段，系統將默認按照GTC策略執行訂單。
2. 立即成交或取消（Immediate Or Cancel，簡稱爲IOC）：指如果委託全部成交或部分成交，未成交部分將被立即取消。

注意：成交也包含自成交

隱藏單&冰山單

您可在高級設置中設置隱藏單和冰山單（冰山單是一種特殊形式的隱藏單）。進行限價單和限價止損單交易時，您可選擇按照隱藏單或冰山單執行。

隱藏單不會展示在買賣盤上。

與隱藏單不同，冰山單分爲可見和隱藏兩部分。進行冰山單交易時，需設置可見訂單數量。冰山單最小可見數量是總訂單量的1/20。

進行撮合時，冰山單的可見部分會首先被撮合，當可見部分被全部撮合後，另一部分隱藏訂單將浮出，直至訂單全部成交。

注意：

1. 系統將對隱藏和冰山單收取taker費用。
2. 如果您同時設定了冰山單和隱藏單，您的訂單將默認作爲冰山單處理。

凍結訂單

下單時，系統會根據訂單的價格和數量凍結一定的賬戶金額，作爲倉位保證金和交易費。沒有凍結的訂單不能進行加倉撮合, 只能進行平倉撮合。當撮合引擎發現訂單零凍結數量超過反向倉位數量時, 會取消多餘零凍結訂單, 以保證沒有零凍結訂單加倉撮合。

交易實際產生的手續費會在訂單成交時確定。如果您取消了一個未完全成交的委託，則其相應的剩餘的已凍結資金會被釋放到可用餘額中。

訂單的加倉數量需要凍結，平倉數量不需要凍結，平倉單（closeOrder is true）和只減倉訂單（reduceOnly is true）不需要凍結。

訂單生命週期

當下單請求因請求成功（撮合引擎已收到訂單）或（因餘額不足、參數不合法等原因）被拒絕時，HTTP請求會進行響應。下單成功，返回訂單ID，訂單將被撮合，可能會部分或全部成交。部分成交後，訂單剩餘爲未成交部分會變成等待撮合（Active）狀態（不包括使用立即成交或取消[IOC]的訂單）。已完全成交的訂單會變成“已完成”（Done）狀態。

訂閱市場數據頻道的用戶可使用訂單ID（orderId）和用戶訂單ID（clientOid）來識別消息。

響應

下單成功後會返回一個訂單ID（order id）。下單成功即表示撮合引擎已收到訂單。

未被撮合的訂單將繼續留在買賣盤上直至被完全撮合或取消。