跳至主要内容

創建委託單

信息

  • 市價單: 一個傳統的市場價格訂單, 會以當前的最優價格為您成交訂單。當且僅當選擇市價單時， 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

請求參數​

參數是否必需類型說明
categorytruestring產品類型. linear, option
symboltruestring合約名稱
sidetruestring方向. Buy, Sell
orderTypetruestring訂單類型. Market, Limit
qtytruestring下單數量
pricefalsestring訂單價格. orderType=Market時，值將被忽略
basePricefalsestring當前市價
  • 用於和triggerPrice值進行比較，確定當前條件委托是看空到triggerPrice時觸發還是看多到triggerPrice觸發
  • 主要是用來標識當前條件單預期的方向
triggerPricefalsestring觸發價格. 如果您期望價格上漲时觸發您的條件訂單, 請確保:
triggerPrice > max(market price, basePrice)
否則, triggerPrice < min(market price, basePrice)
triggerByfalsestring觸發價格類型. LastPrice, IndexPrice, MarkPrice. 默認: LastPrice
ivfalsestring隱含波動率. 僅適用於option. 按照實際值傳慘，如10%，則傳0.1
timeInForcetruestring訂單執行策略 GoodTillCancel, ImmediateOrCancel, FillOrKill, PostOnly
positionIdxfalseinteger倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉. 統一保證金僅支持單向持倉
orderLinkIdfalsestring用戶自定義訂單ID, 最大長度36位，且同一機構下自定義ID支持數字、字母（大小寫）、中劃線、下劃線這些字符的組合
期貨規則:
  • 該參數選填
  • USDC永續和USDT永續的orderLinkId互相獨立，即orderLinkId可相同
  • 在訂單未完全成交或取消前，orderLinkId需保持不一致; 訂單完全成交或取消後，orderLinkId可使用之前使用過的
    • 期權規則:
  • 該參數必傳
  • 總是唯一
takeProfitfalsestring止盈價格
stopLossfalsestring止損價格
tpTriggerByfalsestring止盈激活價格類型，MarkPrice, IndexPrice, 默認:LastPrice
slTriggerByfalsestring止損激活價格類型. MarkPrice, IndexPrice, 默認:LastPrice
reduceOnlyfalseboolean什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效
closeOnTriggerfalseboolean什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行.
mmpfalseboolean做市商保護. 僅對期權生效. true表示該訂單是做市商保護訂單

響應參數​

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

請求示例​

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"
}'

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "e10b0716-7c91-4091-b98a-1fa0f401c7d5",
        "orderLinkId": "test0000003"
    },
    "retExtInfo": {},
    "time": 1664441344238
}