跳至主要内容

創建委託單

本接口提供合約以及現貨的訂單創建。

普通帳戶覆蓋範圍: 現貨 / USDT永續 / 反向合約

信息

  • 支持的訂單類型 (orderType):
    限價單: orderType=Limit, 需要指定訂單數量和價格.

    市價單: orderType=Market, 以市場內最優的價格一直執行到成交. 選擇市價單時，price 參數為空。在期貨交易系統，為了保護市價單產生嚴重的滑點 交易系統會將市價單轉為限價單進行撮合，如果市場價格轉限價時，超過滑點設置的閾值，該筆市場價格訂單將會被取消。滑點閾值是指訂單價格偏離最新成交價格的百分比，目前閾值設置為：BTC 合約3%，其他合約5%。

  • 支持的timeInForce策略:
    GTC 一直有效至取消
    IOC 立即成交或取消
    FOK 完全成交或取消
    PostOnly: 被動委托類型，如果該訂單在提交時會被立即執行成交，它將被取消. 這樣做的目的是為了保護您的訂單在提交的過程中，如果因為場內的價格變化，而撮合系統無法委託該筆訂單到訂單簿，因此會被取消。針對 PostOnly 訂單類型，單筆訂單可提交的數量比其他類型的訂單更多，請參考該接口中的lotSizeFilter > postOnlyMaxOrderQty參數.

  • 如何創建條件單:
    在提交訂單時，如果設置了triggerPrice，則該訂單會自動轉為條件單。另外條件單不佔用保證金，如果條件單觸發後，保證金不足，則該筆訂單會被取消。

  • 止盈 / 止損: 您可以在下單時設置止盈止損。另外，您可以通過設置止盈止損接口修改持倉時的止盈止損價格。

  • 訂單數量: 訂單數量，只支持正數。

  • 訂單價格: 下限價單，價格字段必傳。若您有倉位, 下單價格需要高於強平價. 對於設置價格的步長，請參閱該接口中的priceFilter > tickSize.

  • 用戶自定義訂單Id: 最大長度不超過36個字符且唯一。您可以自定義設置的订单ID(orderLinkId)，我们会为您关联到系统的唯一订单ID，并把唯一订单ID在活动委托创建成功后一并返回给您（包括Websocket），您可以使用 的订单ID 和 orderLinkId 去獲取和取消訂單，如果在參數輸入中同時輸入 orderId 和 orderLinkId， 會優先以 orderId 為准來處理對應訂單.

  • 訂單持有上限:
    期貨: 單個账户针对合约可持有每个 symbol 最多可同时持有500个普通活动订单。这是针对合约的，因此可以允许出现例如：账户同时持有300个BTCUSD的活动单、280个ETHUSD合约的活动单。針對條件單，單個帳戶針對合約可持有每個 symbol 最多同時持有 10 個條件單
    現貨: 總計支持500個掛單，包括最多持有30個止盈止損委託單。

  • API限頻:
    請參見接口頻率限制表

現貨止赢止损单規則

現貨支持止盈止損單, 但是背後的處理邏輯略有不同
當止盈止損創建後, 您將會得到一個訂單ID. 當它被觸發後, 您將獲取到一個全新的訂單ID

HTTP請求​

POST /cloud/trade/v3/order/create

請求參數​

參數是否必需類型說明
categorytruestring產品類型
  • 普通帳戶: spot, linear, inverse
symboltruestring合約名稱
sidetruestringBuy, Sell
orderTypetruestring訂單類型. Market, Limit
qtytruestring訂單數量.
  • 現貨: 市價買單的qty總是以quote coin為單位, 其他情況下, qty都是以base coin為單位
  • 期貨: qty總是以base coin為單位
pricefalsestring訂單價格. 如果您有持倉, 價格需要大於強平價
triggerDirectionfalseinteger條件單參數. 用於辨別期望的方向.
  • 1: 當市場價上漲到了triggerPrice時觸發條件單
  • 2: 當市場價下跌到了triggerPrice時觸發條件單

僅對linear和inverse有效
orderFilterfalsestring指定訂單品種. Order: 普通單,tpslOrder: 止盈止損單. 若不傳, 默認Order，僅對現貨有效
triggerPricefalsestring
  • 對於期貨, 是條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:
    triggerPrice > 市場價格
    否則, triggerPrice < 市場價格
  • 對於現貨, 這是下止盈止損單的觸發價格參數
triggerByfalsestring條件單參數. 觸發價格類型. LastPrice, IndexPrice, MarkPrice
僅對linear和inverse有效
timeInForcefalsestring訂單執行策略
  • 市價單，系統直接使用IOC
  • 若不傳，默認使用GTC
positionIdxfalseinteger倉位標識, 用戶不同倉位模式. 該字段對於雙向持倉模式是必傳:
  • 0: 單向持倉
  • 1: 買側雙向持倉
  • 2: 賣側雙向持倉

僅對linear和inverse有效
orderLinkIdfalsestring用戶自定義訂單Id.
takeProfitfalsestring止盈價格
stopLossfalsestring止損價格
tpTriggerByfalsestring觸發止盈的價格類型. MarkPrice, IndexPrice, 默認:LastPrice
僅對linear和inverse有效
slTriggerByfalsestring觸發止損的價格類型. MarkPrice, IndexPrice, 默認:LastPrice
僅對linear和inverse有效
reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉
  • 當減倉時, reduceOnly=true必傳
  • 只減倉單的止盈止損不生效

僅對linear和inverse有效
closeOnTriggerfalseboolean此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
僅對linear和inverse有效
smpTypefalsestringSmp執行類型.
tpslModefalsestring止盈止損模式
  • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
  • Partial: 部分倉位止盈止損. 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial

僅對linear和inverse有效
tpLimitPricefalsestring觸發止盈後轉換為限價單的價格. 僅tpslMode=Partial且tpOrderType=Limit時有效
slLimitPricefalsestring觸發止損後轉換為限價單的價格. 僅tpslMode=Partial且slOrderType=Limit時有效
tpOrderTypefalsestring止盈觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持tpOrderType=Market
slOrderTypefalsestring止損觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持slOrderType=Market

響應參數​

參數類型說明
orderIdstring訂單ID
orderLinkIdstring用戶自定義訂單ID

請求示例​

POST /cloud/trade/v3/order/create HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672211928338
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json


// USDT永續開多倉訂單 (單向持倉)
{"category":"linear","symbol":"BTCUSDT","side":"Buy","orderType":"Limit","qty":"1","price":"25000","timeInForce":"GTC","positionIdx":0,"orderLinkId":"usdt-test-01","reduceOnly":false,"takeProfit":"28000","stopLoss":"20000","tpslMode":"Partial","tpOrderType":"Limit","slOrderType":"Limit","tpLimitPrice":"27500","slLimitPrice":"20500"}

// USDT永續平多倉訂單 (單向持倉)
{"category": "linear", "symbol": "BTCUSDT", "side": "Sell", "orderType": "Limit", "qty": "1", "price": "30000", "timeInForce": "GTC", "positionIdx": 0, "orderLinkId": "usdt-test-02", "reduceOnly": true}

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "1321003749386327552",
        "orderLinkId": "test-postonly"
    },
    "retExtInfo": {},
    "time": 1672211918471
}