跳至主要内容

創建委託單

提示

  • 市價單: 一個傳統的市場價格訂單, 會以當前的最優價格為您成交訂單。當且僅當選擇市價單時， price可為空. 為了保護市價單遭遇嚴重的滑點，Bybit將價單轉為限價單入撮合， 買單價格高於最優賣價，賣單價格低於最優買價。限價價格和成交價格均可通過用戶成交記錄接口查詢.

  • 限價單: 您可以為您的訂單設置一個執行價格，當市場價格達到您的設置價格時，系統會為您成交訂單。

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

  • 委托數量: 表示您要購買/賣出的永續合約數，對於委托數量目前Bybit只允許提交正整數。

  • 委托價格: 如果是下限價單，該參數為必填. 在沒有倉位時，做多的委托價格需高於市價的 10%、低於1百萬。如有倉位時則需優於強平價。 價格增減最小單位請參考交易對接口響應中的priceFilter字段。

  • 用戶自定義訂單ID: 您可以自定義活動委托訂單ID，我們會為您關聯到系統的訂單ID，並把系統的唯一訂單ID在活動委托創建成功後一並返回給您，您可以使用 該訂單ID去取消活動委托，同時要求您傳遞的自定義訂單ID 最大長度不超過36個字段且唯一。

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

HTTP 請求​

POST /contract/v3/private/order/create

請求參數​

參數是否必需類型說明
symboltruestring合約名稱
sidetruestring方向. Buy,Sell
orderTypetruestring訂單類型. Market, Limit
qtytruestring下單數量
timeInForcetruestring訂單策略.
pricefalsestring訂單價格. orderType=Market時，值將被忽略
positionIdxfalseinteger倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉. 雙向模式下，該字段必傳
triggerDirectionfalseinteger條件單參數. 用於辨別期望的方向.
  • 1: 當市場價上漲到了triggerPrice時觸發條件單
  • 2: 當市場價下跌到了triggerPrice時觸發條件單
triggerPricefalsestring條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保::
triggerPrice > 市場價格
否則, triggerPrice < 市場價格
triggerByfalsestring觸發價格類型. LastPrice, IndexPrice, MarkPrice. 默認: LastPrice
orderLinkIdfalsestring用戶自定義訂單ID, 最大長度36位，且同一機構下自定義ID支持數字、字母（大小寫）、中劃線、下劃線這些字符的組合
期貨規則:
  • 該參數選填
  • USDC永續和USDT永續的orderLinkId互相獨立，即orderLinkId可相同
  • 在訂單未完全成交或取消前，orderLinkId需保持不一致; 訂單完全成交或取消後，orderLinkId可使用之前使用過的
    • 期權規則:
  • 該參數必傳
  • 總是唯一
takeProfitfalsestring止盈價格
stopLossfalsestring止損價格
tpTriggerByfalsestring止盈激活價格類型，MarkPrice, IndexPrice, 默認:LastPrice
slTriggerByfalsestring止損激活價格類型. MarkPrice, IndexPrice, 默認:LastPrice
reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效
closeOnTriggerfalseboolean什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
smpTypefalsestringSmp執行類型. 什麼是SMP?
tpslModefalsestring止盈止損模式
  • Full: 全部倉位止盈止損. 此時, tpOrderType或者slOrderType必須傳Market
  • Partial: 部分倉位止盈止損. 支持創建限價止盈止損. 注意: 創建限價止盈止損時, tpslMode必傳且為Partial
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 /contract/v3/private/order/create HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670487164902
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json; charset=utf-8
{
    "symbol": "BTCUSDT",
    "side": "Buy",
    "orderType": "Limit",
    "qty": "0.05",
    "price": "18500",
    "timeInForce": "GoodTillCancel",
    "positionIdx": null,
    "triggerDirection": 1,
    "triggerPrice": "19000"
}

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "0cf62262-7dc2-4503-9566-8835c841509b",
        "orderLinkId": ""
    },
    "retExtInfo": {},
    "time": 1670486764551
}