止盈止损下單
//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,
"stopPriceType": "",
"symbol": "XBTUSDM",
"timeInForce": "",
"type": "limit",
"visibleSize": 0,
"marginMode": "ISOLATED"
"triggerStopUpPrice": 9000, //止盈价格
"triggerStopDownPrice": 7000 //止损价格
}
//Response
{
"code": "200000",
"data": {
"orderId": "5bd6e9286d99522a52e458de",
"clientOid": "5c52e11203aa677f33e493fb"
}
}
此接口支持同時支持止盈和止損功能,其他功能同正常下單接口完全一致
有兩種訂單類型:限價單和市價單。只有當賬戶資金充足時,下單纔會成功。下單後,系統將根據指定訂單類型和參數,凍結相應資金,直至訂單完結。
注意:系統將在訂單進入買賣盤前凍結手續費用。查看成交記錄,瞭解更多詳情。
請勿在JSON字符串中添加空格。
下單限制
一個賬戶中,每種合約最多可下100個限價單和50個止盈止損單。
HTTP請求
POST /api/v1/st-orders
示例
POST /api/v1/st-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)。 |
triggerStopUpPrice | String | 否 | 止盈價格 |
stopPriceType | String | 否 | 止損單觸發價類型,包括TP、IP和MP |
triggerStopDownPrice | String | 否 | 止損價格 |
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 |
clientOid | 用戶自定義訂單id |
術語解釋
用戶訂單ID
ClientOid字段是客戶端創建的唯一的ID(推薦使用UUID),只能包含數字、字母、下劃線(_) 和 分隔線(-)。這個字段會在獲取訂單信息時返回。您可使用clientOid來標識您的訂單。ClientOid不同於服務端創建的訂單ID。請不要使用同一個clientOid發起請求。clientOid最長不得超過40個字符。
請妥善記錄服務端創建的orderId,以用於查詢訂單狀態的更新。
TYPE
您在下單時指定的訂單類型,決定了您是否需要請求其他參數,同時還會影響到撮合引擎的執行。如果您在下單時未指定訂單類型,系統將默認按照限價單執行。
下限價單時,您需指定限價單的價格(price)和數量(size)。系統將根據市場行情以指定或更優價格撮合該訂單。如果訂單未能被立即撮合,將繼續留買賣盤中,直至被撮合或被用戶取消。
與限價單不同,市價單價格會隨着市場價格波動而變化。下市價單時,您無需指定價格,只需指定合約數量。市價單會立即成交,不會進入買賣盤。所有市價單都是taker,需支付taker費用。
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.
訂單時效
訂單時效是一種交易時使用的特殊策略,用於設定訂單在被撮合或取消前的生效時間。訂單時效策略分爲兩種:
- 取消前有效(Good Till Canceled,簡稱爲GTC):指委託將持續有效直到被手動取消。如果用戶在交易時沒有設置該字段,系統將默認按照GTC策略執行訂單。
- 立即成交或取消(Immediate Or Cancel,簡稱爲IOC):指如果委託全部成交或部分成交,未成交部分將被立即取消。
注意:成交也包含自成交
隱藏單&冰山單
您可在高級設置中設置隱藏單和冰山單(冰山單是一種特殊形式的隱藏單)。進行限價單和限價止損單交易時,您可選擇按照隱藏單或冰山單執行。
隱藏單不會展示在買賣盤上。
與隱藏單不同,冰山單分爲可見和隱藏兩部分。進行冰山單交易時,需設置可見訂單數量。冰山單最小可見數量是總訂單量的1/20。
進行撮合時,冰山單的可見部分會首先被撮合,當可見部分被全部撮合後,另一部分隱藏訂單將浮出,直至訂單全部成交。
注意:
- 系統將對隱藏和冰山單收取taker費用。
- 如果您同時設定了冰山單和隱藏單,您的訂單將默認作爲冰山單處理。
凍結訂單
下單時,系統會根據訂單的價格和數量凍結一定的賬戶金額,作爲倉位保證金和交易費。沒有凍結的訂單不能進行加倉撮合, 只能進行平倉撮合。當撮合引擎發現訂單零凍結數量超過反向倉位數量時, 會取消多餘零凍結訂單, 以保證沒有零凍結訂單加倉撮合。
交易實際產生的手續費會在訂單成交時確定。如果您取消了一個未完全成交的委託,則其相應的剩餘的已凍結資金會被釋放到可用餘額中。
訂單的加倉數量需要凍結,平倉數量不需要凍結,平倉單(closeOrder is true)和只減倉訂單(reduceOnly is true)不需要凍結。
訂單生命週期
當下單請求因請求成功(撮合引擎已收到訂單)或(因餘額不足、參數不合法等原因)被拒絕時,HTTP請求會進行響應。下單成功,返回訂單ID,訂單將被撮合,可能會部分或全部成交。部分成交後,訂單剩餘爲未成交部分會變成等待撮合(Active)狀態(不包括使用立即成交或取消[IOC]的訂單)。已完全成交的訂單會變成“已完成”(Done)狀態。
訂閱市場數據頻道的用戶可使用訂單ID(orderId)和用戶訂單ID(clientOid)來識別消息。
響應
下單成功後會返回一個訂單ID(order id)。下單成功即表示撮合引擎已收到訂單。
未被撮合的訂單將繼續留在買賣盤上直至被完全撮合或取消。