批量下單

該接口支持在一個接口中按順序批量下單,每次最多可同時下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",
		  "success": true
	  },
	  {
		  "orderId": "641d669c9ca34800017a2a45",
		  "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 失敗原因