訂單
下單
訂單有兩種類型： 限價單（limit）: 指定價格和數量進行交易。 市價單(market) : 指定資金或數量進行交易。
在下單前，請確保您的交易賬戶/槓桿賬戶有足夠的資金。一旦下單成功，您下單的金額會被凍結。凍結金額的多少取決於您下單的類型和具體的請求參數。
TIP
下單將啓用價格保護機制。當限價單的價格在閾值範圍之外時，會觸發價格保護機制，導致下單失敗。
請悉知，當您的訂單進入買賣盤，系統會提前凍結訂單的手續費。
在下單之前，請充分了解每一個交易對的參數含義。
請求體中的JSON字符串中不要有多餘的空格
下單限制
對於一個賬號：最多2000个活跃订单，每一個交易對最大活躍委託訂單數量200（包含止損單）。
HTTP請求
POST /api/v1/orders
請求示例
POST /api/v1/orders
{
"orderId":"5bd6e9286d99522a52e458de"
}
API權限
此接口需要幣幣交易權限或槓桿交易權限。
請求URL
此接口支持現貨URL
頻率限制
現貨類權重：limit 2, market 2
請求參數
下單公有的請求參數
| 請求參數 | 類型 | 是否必須 | 含義 |
|---|---|---|---|
| clientOid | String | 是 | Client Order Id，客戶端創建的唯一標識，建議使用UUID，最大長度為128位 |
| side | String | 是 | buy（買） 或 sell（賣） |
| symbol | String | 是 | 交易對 比如，ETH-BTC |
| type | String | 否 | 訂單類型 limit 和 market (默認爲 limit) |
| remark | String | 否 | 訂單說明，長度不超過50個字符（編碼只支持ASCII） |
| stp | String | 否 | 自成交保護 分爲CN, CO, CB , DC四種策略 |
| tradeType | String | 否 | 交易類型，分爲TRADE（現貨交易）, MARGIN_TRADE（槓桿交易）（默認爲TRADE ）。另請注意：爲了提升系統性能和下單速度，我們新增單獨的槓桿訂單接口，請還在此接口下槓桿訂單的用戶儘快遷移至新槓桿訂單接口。此接口將於2020年5月1日（UTC+8）不再接受槓桿訂單，屆時我們將提前公告用戶。 |
limit 限價單額外所需請求參數
| 請求參數 | 類型 | 是否必須 | 含義 |
|---|---|---|---|
| price | String | 是 | 指定幣種的價格 |
| size | String | 是 | 指定幣種的數量 |
| timeInForce | String | 否 | 訂單時效策略 GTC, GTT, IOC, FOK (默認爲GTC) |
| cancelAfter | long | 否 | n 秒之後取消，訂單時效策略爲 GTT |
| postOnly | boolean | 否 | 被動委託的標識, 當訂單時效策略爲 IOC 或 FOK 時無效 |
| hidden | boolean | 否 | 是否隱藏（買賣盤中不展示） |
| iceberg | boolean | 否 | 冰山單中是否僅顯示訂單的可見部分 |
| visibleSize | String | 否 | 冰山單最大的展示數量 |
market 市價單額外所需請求參數
| 請求參數 | 類型 | 是否必須 | 含義 |
|---|---|---|---|
| size | String | 否（size和funds 二選一） | 下單數量 |
| funds | String | 否（size和funds 二選一） | 下單資金 |
- 下市價單，需定買賣數量或資金
返回值
| 字段 | 含義 |
|---|---|
| orderId | 訂單Id,下單成功後，會返回一個orderId字段 |
術語解釋
交易對(Symbol)
交易對必須是KuCoin支持的交易對。
Client Order Id(clientOid)
ClientOid字段是客戶端創建的唯一ID（推薦使用UUID），只能包含數字、字母、下劃線（_） 和 分隔線（-）。這個字段會在獲取訂單信息時返回。您可使用clientOid來標識您的訂單。ClientOid不同於服務端創建的訂單ID。請不要使用同一個clientOid發起請求。clientOid最長不得超過40個字符。
請妥善記錄服務端創建的orderId，以用於查詢訂單狀態的更新。
訂單類型(type)
您在下單時指定的訂單類型，決定了您是否需要請求其他參數，同時還會影響到撮合引擎的執行。如果您在下單時未指定訂單類型，系統將默認按照限價單執行。
下限價單時，您需指定限價單的價格（price）和數量（size）。系統將根據市場行情以指定或更優價格撮合該訂單。如果訂單未能被立即撮合，將繼續留買賣盤中，直至被撮合或被用戶取消。
與限價單不同，市價單價格會隨着市場價格波動而變化。下市價單時，您無需指定價格，只需指定數量。市價單會立即成交，不會進入買賣盤。所有市價單都是taker，需支付taker費用。
交易類型(tradeType)
目前平台支持現貨（TRADE）與槓桿（MARGIN_TRADE）兩種資產交易下單。系統根據您的參數類型，將對指定賬戶資金進行凍結。若未傳遞該參數，將默認按照現貨凍結您交易賬戶資金。另請注意：爲了提升系統性能和下單速度，我們新增單獨的槓桿訂單接口，請還在此接口下槓桿訂單的用戶儘快遷移至新槓桿訂單接口。此接口將於2020年5月1日（UTC+8）不再接受槓桿訂單，屆時我們將提前公告用戶。
價格(Price)
下限價單時，price 必須以交易對的價格增量 priceIncrement爲基準，價格增量是交易對的價格的精度。比如，對BTC-USDT這個交易對, 它的 priceIncrement 爲0.00001000。那麼你下單的 price 不可以小於0.00001000，且爲 priceIncrement 的正整數倍，否則下單時會報錯，invalid priceIncrement。
數量(Size)
下限價單時，size 是指交易對的交易對象(即寫在靠前部分的資產名)的數量。size 必須以交易對中的數量增量 baseIncrement爲基準，數量增量是交易對的數量的精度。下單的 size 爲 baseIncrement 的正整數倍並且必須在 baseMinSize 和 baseMaxSize 之間。
資金(Funds)
下市價單時，funds 字段是指交易對的定價資產(即寫在靠後部分資產名)的資金。funds 必須以交易對中的資金增量quoteIncrement爲基準，資金增量是交易對的資金的精度。下單的 funds 爲 quoteIncrement 的正整數倍且必須在 quoteMinSize 和 quoteMaxSize 之間。
訂單時效策略(TimeInForce)
訂單時效是一種交易時使用的特殊策略，用於設定訂單在被撮合或取消前的生效時間。訂單時效策略分爲四種：
| 縮寫 | 全稱 | 含義 |
|---|---|---|
| GTC | Good Till Canceled | 主動取消才過期 |
| GTT | Good Till Time | 指定時間後過期 |
| IOC | Immediate Or Cancel | 立即成交可成交的部分，然後取消剩餘部分，不進入買賣盤 |
| FOK | Fill Or Kill | 如果下單不能全部成交，則取消 |
- 注意，成交也包含自成交。市價單並不支持訂單時效策略(TimeInForce)
被動委託(PostOnly)
postOnlys只是一個標識，如果下單有能立即成交的對手方，則取消。
- 當用戶所下訂單是postonly訂單時，如果訂單進入撮合引擎後遇到冰山單和隱藏單可以立即成交，postonly 訂單收maker 手續費，冰山單和隱藏單收taker手續費。
隱藏單和冰山單(Hidden & Iceberg)
您可在高級設置中設置隱藏單和冰山單（冰山單是一種特殊形式的隱藏單）。進行限價單和限價止損單交易時，您可選擇按照隱藏單或冰山單執行。
隱藏單不會展示在買賣盤上。
與隱藏單不同，冰山單分爲可見和隱藏兩部分。進行冰山單交易時，需設置可見訂單數量。冰山單最小可見數量是總訂單量的1/20。
進行撮合時，冰山單的可見部分會首先被撮合，當可見部分被全部撮合後，另一部分隱藏訂單將浮出，直至訂單全部成交。
注意：
- 系統將對隱藏和冰山單收取taker費用。
- 如果您同時設定了冰山單和隱藏單，您的訂單將默認作爲冰山單處理。
凍結策略(Hold)
對於限價買單，我們會從您的資金裏面凍結您買單的金額(price * size)。同樣，對於限價賣單，我們也會凍結您賣單的資產。在成交那一刻評估實際的手續費。如果您取消了一個部分成交或未成交的訂單，那麼剩餘金額會解凍會退到您的賬戶。 對於市價買/賣單，需要指定funds(資金)，我們會根據funds來凍結您賬戶裏的資金。如果只指定了size，在成交或取消之前，您的賬戶所有資金會被凍結（通常凍結時間非常短）。
自成交保護(SelfTradePrevention)
您可在高級設置中設置自成交保護策略。您的訂單將不會發生自成交。如果您在下單時沒有指定STP，否則您的訂單可能會被自己的訂單成交。市價單現不支持DC策略。
市價單現不支持 DC，當timeInForce 爲FOK， 那麼stp會指定爲CN。
| 縮寫 | 全稱 | 含義 |
|---|---|---|
| DC | Decrease and Cancel | 取消數量少的一方的訂單，並將數量多的一方數量改爲新舊差值 |
| CO | Cancel old | 取消舊的訂單 |
| CN | Cancel new | 取消新的訂單 |
| CB | Cancel both | 雙方都取消 |
訂單生命週期(ORDER LIFECYCLE)
當下單請求因請求成功（撮合引擎已收到訂單）或（因餘額不足、參數不合法等原因）被拒絕時，HTTP請求會進行響應。下單成功，返回訂單ID，訂單將被撮合，可能會部分或全部成交。部分成交後，訂單剩餘爲未成交部分會變成等待撮合（Active）狀態（不包括使用立即成交或取消[IOC]的訂單）。已完全成交的訂單會變成“已完成”（Done）狀態。
訂閱市場數據頻道的用戶可使用訂單ID（orderId）和用戶訂單ID（clientOid）來識別消息。
價格保護機制
下單將啓用價格保護機制。具體規則如下
若用戶在幣幣交易所下的市價單/限價單可以與當前買賣盤內訂單直接成交，那麼系統會判斷成交深度對應的價格與同方向盤口價的偏差是否超出閾值（閾值可根據API symbol接口獲取）；
若超過，當您是限價單時，該訂單會提示下單失敗；
若是市價單則此訂單將被系統部分執行，執行上限爲閾值對應的價格內的訂單數量，其他剩餘訂單將不被成交。
舉例說明：若閾值爲10%，當某用戶在KCS/USDT交易區下了10,000 USDT的市價買單時(此時賣一價爲1.20000)，系統會判斷訂單成交後最新成交價爲1.40000。(1.40000-1.20000)/1.20000=16.7%>10%，而閾值價格爲1.32000，此時，用戶的這筆市價買單將最多被成交至1.32000，其他剩餘訂單則不會和買賣盤內訂單進行撮合。 請注意：該功能對深度的探測可能存在偏差，若您的訂單未被完全成交有可能是因爲超出了閾值的部分未成交。
是
否