創建委託單
提示
市價單: 一個傳統的市場價格訂單, 會以當前的最優價格為您成交訂單。當且僅當選擇市價單時, 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
請求參數
參數 | 是否必需 | 類型 | 說明 |
---|---|---|---|
symbol | true | string | 合約名稱 |
side | true | string | 方向. Buy ,Sell |
orderType | true | string | 訂單類型. Market , Limit |
qty | true | string | 下單數量 |
timeInForce | true | string | 訂單策略. |
price | false | string | 訂單價格. orderType =Market時,值將被忽略 |
positionIdx | false | integer | 倉位標識. 0 : 單向持倉, 1 : 買側雙向持倉, 2 : 賣側雙向持倉. 雙向模式下,該字段必傳 |
triggerDirection | false | integer | 條件單參數. 用於辨別期望的方向.
|
triggerPrice | false | string | 條件單觸發價格參數. 若您希望市場價是要上升後觸發, 確保:: triggerPrice > 市場價格 否則, triggerPrice < 市場價格 |
triggerBy | false | string | 觸發價格類型. LastPrice , IndexPrice , MarkPrice . 默認: LastPrice |
orderLinkId | false | string | 用戶自定義訂單ID, 最大長度36位,且同一機構下自定義ID支持數字、字母(大小寫)、中劃線、下劃線這些字符的組合 期貨規則:
|
takeProfit | false | string | 止盈價格 |
stopLoss | false | string | 止損價格 |
tpTriggerBy | false | string | 止盈激活價格類型,MarkPrice , IndexPrice , 默認:LastPrice |
slTriggerBy | false | string | 止損激活價格類型. MarkPrice , IndexPrice , 默認:LastPrice |
reduceOnly | false | boolean | 什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效 |
closeOnTrigger | false | boolean | 什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉(平倉)而非加倉,並且在可用保證金不足的情況下,取消其他委託,騰出保證金以確保平倉委託的執行. |
smpType | false | string | Smp執行類型. 什麼是SMP? |
tpslMode | false | string | 止盈止損模式
|
tpLimitPrice | false | string | 觸發止盈後轉換為限價單的價格. 僅tpslMode=Partial且tpOrderType=Limit時有效 |
slLimitPrice | false | string | 觸發止損後轉換為限價單的價格. 僅tpslMode=Partial且slOrderType=Limit時有效 |
tpOrderType | false | string | 止盈觸發後的訂單類型. Market (默認), Limit . 對於tpslMode=Full時, 僅支持tpOrderType=Market |
slOrderType | false | string | 止損觸發後的訂單類型. Market (默認), Limit . 對於tpslMode=Full時, 僅支持slOrderType=Market |
響應參數
參數 | 類型 | 說明 |
---|---|---|
orderId | string | 訂單ID |
orderLinkId | string | 用戶自定義訂單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
}