批量下單
該接口支持在一個接口中按順序批量下單,每次最多可同時下5
個訂單,訂單類型必須爲相同交易對的限價單(目前該接口只支持現貨交易,不支持槓桿交易)
此接口只提交下單請求,實際下單結果需要通過查詢訂單狀態或訂閱websocket獲取訂單消息。
HTTP請求
POST /api/v1/hf/orders/multi
請求示例
POST /api/v1/hf/orders/multi
//request
{
"orderList": [
{
"clientOid": "3d07008668054da6b3cb12e432c2b13a",
"side": "buy",
"type": "limit",
"price": "0.01",
"size": "1",
"symbol": "ETH-USDT"
},
{
"clientOid": "37245dbe6e134b5c97732bfb36cd4a9d",
"side": "buy",
"type": "limit",
"price": "0.01",
"size": "1",
"symbol": "ETH-USDT"
}
]
}
//response
{
"success": true,
"code": "200",
"msg": "success",
"retry": false,
"data": [
{
"orderId": "641d669c9ca34800017a2a3c",
"clientOid": "3d07008668054da6b3cb12e432c2b13a",
"success": true
},
{
"orderId": "641d669c9ca34800017a2a45",
"clientOid": "37245dbe6e134b5c97732bfb36cd4a9d",
"success": true
}
]
}
API權限
此接口需要幣幣交易權限。
請求URL
此接口支持現貨URL
頻率限制
現貨類權重
:1
請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
clientOid | String | 否 | Client Order Id,客戶端創建的唯一標識,建議使用UUID |
symbol | String | 是 | symbol, 比如,ETH-BTC |
type | String | 是 | 訂單類型 limit 和 market |
timeInForce | String | 否 | 訂單時效策略 GTC , GTT , IOC , FOK (默認爲GTC ) |
stp | String | 否 | 自成交保護, 分爲CN, CO, CB , DC四種策略 |
side | String | 是 | buy(買) 或 sell(賣) |
price | String | 是 | 指定幣種的價格 |
size | String | 是 | 指定幣種的數量 |
cancelAfter | long | 否 | n 秒之後取消,訂單時效策略爲 GTT |
postOnly | boolean | 否 | 被動委託的標識, 當訂單時效策略爲 IOC 或 FOK 時無效 |
hidden | boolean | 否 | 是否隱藏(買賣盤中不展示) |
iceberg | boolean | 否 | 冰山單中是否僅顯示訂單的可見部分 |
visibleSize | String | 否 | 冰山單最大的展示數量 |
tags | String | 否 | 訂單標籤,長度不超過20 個字符(編碼只支持ASCII) |
remark | String | 否 | 下單備註,長度不超過20 個字符(編碼只支持ASCII) |
返回值
字段 | 含義 |
---|---|
status | 訂單創建結果 (success , fail ) |
failMsg | 失敗原因 |