批量創建委託單
提示
該接口支持批量創建委託單
- 下單時需確保帳戶內有足夠的資金。一旦下單，根據訂單所需資金，您的帳戶資金將在訂單生命週期內凍結相應額度，被凍結的資金額度取決於訂單屬性。
- 同一個請求中只能包含同一種合約的訂單，期權、期貨不可同時下單。僅支持Limit / Market order，不支持條件單。
- 如果期貨和期權的訂單都在一個請求裏 ，則根據category的類型，僅會操作symbol與category相匹配的訂單。
- 每個請求包含的訂單數最大10筆訂單。返回的數據列表中分成兩個 list，訂單創建的 list 和創建的信息返回，兩個 list 的訂單是完全序列保持一致的。
HTTP請求
POST /unified/v3/private/order/create-batch
請求參數
| 參數 | 是否必需 | 類型 | 說明 |
|---|---|---|---|
| category | true | string | 產品類型. linear, option |
| request | true | array | Object |
| > symbol | true | string | 合約名稱 |
| > side | true | string | 訂單方向. Buy, Sell |
| > orderType | true | string | 訂單類型. Market, Limit |
| > qty | true | string | 訂單數量 |
| > price | false | string | 訂單價格. 當orderType=Market時，設置的價格將被忽略 |
| > 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支持數字、字母（大小寫）、中劃線、下劃線這些字符的組合 期貨規則:
|
| > reduceOnly | false | boolean | 什麼是只減倉? true 將這筆訂單設為只減倉. 只減倉單的止盈止損不生效 |
| > closeOnTrigger | false | boolean | 什麼是觸發後平倉委託? 此選項可以確保您的止損單被用於減倉（平倉）而非加倉，並且在可用保證金不足的情況下，取消其他委託，騰出保證金以確保平倉委託的執行. |
| > mmp | false | boolean | 做市商保護. 僅對期權生效. true表示該訂單是做市商保護訂單 |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| result | Object | |
| > list | array | Object |
| >> category | string | 產品類型 |
| >> symbol | string | 合約名稱 |
| >> orderId | string | 訂單Id |
| >> orderLinkId | string | 用戶自定義訂單Id |
| >> createAt | string | 訂單創建時間 (毫秒) |
| retExtInfo | Object | |
| > list | array | Object |
| >> code | integer | 成功/錯誤碼 |
| >> msg | string | 成功/錯誤信息 |
請求示例
POST /unified/v3/private/order/create-batch HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672817108675
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{
"category": "linear",
"request": [
{
"symbol": "ETHUSDT",
"orderType": "Limit",
"side": "Buy",
"qty": "0.05",
"price": "1000",
"timeInForce": "GoodTillCancel",
"orderLinkId": "test-002",
"reduceOnly": false,
"closeOntrigger": false
},
{
"symbol": "XRPUSDT",
"orderType": "Limit",
"side": "Buy",
"qty": "100",
"price": "0.3",
"timeInForce": "GoodTillCancel",
"orderLinkId": "test-003",
"reduceOnly": false,
"closeOntrigger": false
}
]
}
響應示例
{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"category": "linear",
"symbol": "ETHUSDT",
"orderId": "ce295fcb-8c8a-4f12-89f4-4ab23d38ccd8",
"orderLinkId": "test-002",
"createAt": "1672817109797"
},
{
"category": "linear",
"symbol": "XRPUSDT",
"orderId": "e97f0355-6586-49a4-965f-feb7253cef14",
"orderLinkId": "test-003",
"createAt": "1672817109796"
}
]
},
"retExtInfo": {
"list": [
{
"code": 0,
"msg": "success"
},
{
"code": 0,
"msg": "success"
}
]
},
"time": 1672817109804
}