創建委託單
信息
市價單: 一個傳統的市場價格訂單, 會以當前的最優價格為您成交訂單。當且僅當選擇市價單時, price可為空. 為了保護市價單遭遇嚴重的滑點,Bybit將價單轉為限價單入撮合, 買單價格高於最優賣價,賣單價格低於最優買價。限價價格和成交價格均可通過用戶成交記錄接口查詢.
限價單: 您可以為您的訂單設置一個執行價格,當市場價格達到您的設置價格時,系統會為您成交訂單。
委托數量: 表示您要購買/賣出的永續合約數,對於委托數量目前Bybit只允許提交正整數。
委托價格: 如果是下限價單,該參數為必填. 在沒有倉位時,做多的委托價格需高於市價的 10%、低於1百萬。如有倉位時則需優於強平價。 價格增減最小單位請參考交易對接口響應中的priceFilter字段。
用戶自定義訂單ID: 您可以自定義活動委托訂單ID,我們會為您關聯到系統的訂單ID,並把系統的唯一訂單ID在活動委托創建成功後一並返回給您,您可以使用 該訂單ID去取消活動委托,同時要求您傳遞的自定義訂單ID 最大長度不超過36個字段且唯一。
訂單持有上限: 期貨: 單個账户针对合约可持有每个 symbol 最多可同时持有500个普通活动订单。这是针对合约的,因此可以允许出现例如:账户同时持有300个BTCUSD的活动单、 280个ETHUSD合约的活动单。針對條件單,單個帳戶針對合約可持有每個 symbol 最多同時持有 10 個條件單。 期權: 最多可持有100個委託單
期權不支持創建條件單
HTTP 請求
POST /unified/v3/private/order/create
請求參數
參數 | 是否必需 | 類型 | 說明 |
---|---|---|---|
category | true | string | 產品類型. linear , option |
symbol | true | string | 合約名稱 |
side | true | string | 方向. Buy , Sell |
orderType | true | string | 訂單類型. Market , Limit |
qty | true | string | 下單數量 |
price | false | string | 訂單價格. orderType =Market時,值將被忽略 |
basePrice | false | string | 當前市價
|
triggerPrice | false | string | 觸發價格. 如果您期望價格上漲时觸發您的條件訂單, 請確保: triggerPrice > max(market price, basePrice) 否則, triggerPrice < min(market price, basePrice) |
triggerBy | false | string | 觸發價格類型. LastPrice , IndexPrice , MarkPrice . 默認: LastPrice |
iv | false | string | 隱含波動率. 僅適用於option . 按照實際值傳慘,如10%,則傳0.1 |
timeInForce | true | string | 訂單執行策略 GoodTillCancel , ImmediateOrCancel , FillOrKill , PostOnly |
positionIdx | false | integer | 倉位標識. 0 : 單向持倉, 1 : 買側雙向持倉, 2 : 賣側雙向持倉. 統一保證金僅支持單向持倉 |
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 | 什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉(平倉)而非加倉,並且在可用保證金不足的情況下,取消其他委託,騰出保證金以確保平倉委託的執行. |
mmp | false | boolean | 做市商保護. 僅對期權生效. true 表示該訂單是做市商保護訂單 |
響應參數
參數 | 類型 | 說明 |
---|---|---|
orderId | string | 訂單ID |
orderLinkId | string | 用戶自定義訂單ID |
請求示例
- linear
curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/create' \
--header 'X-BAPI-SIGN-TYPE: 2' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1657871228347' \
--header 'X-BAPI-RECV-WINDOW: 5000' \
--header 'Content-Type: application/json' \
--data-raw '{
"symbol": "BTCUSDT",
"orderType": "Limit",
"side": "Buy",
"qty": "0.01",
"price": "20002",
"timeInForce": "GoodTillCancel",
"category": "linear"
}'
響應示例
- linear
{
"retCode": 0,
"retMsg": "OK",
"result": {
"orderId": "e10b0716-7c91-4091-b98a-1fa0f401c7d5",
"orderLinkId": "test0000003"
},
"retExtInfo": {},
"time": 1664441344238
}