批量下單
該接口支持在一個接口中批量下單,每次可同時下5個訂單,訂單類型必須爲相同交易對的限價單(目前該接口只支持現貨交易,不支持槓桿交易)
HTTP請求
POST /api/v1/orders/multi
請求示例
POST /api/v1/orders/multi
//request
{
"symbol": "KCS-USDT",
"orderList": [
{
"clientOid": "3d07008668054da6b3cb12e432c2b13a",
"side": "buy",
"type": "limit",
"price": "0.01",
"size": "0.01"
},
{
"clientOid": "37245dbe6e134b5c97732bfb36cd4a9d",
"side": "buy",
"type": "limit",
"price": "0.01",
"size": "0.01"
}
]
}
//response
{
"data": [
{
"symbol": "KCS-USDT",
"type": "limit",
"side": "buy",
"price": "0.01",
"size": "0.01",
"funds": null,
"stp": "",
"stop": "",
"stopPrice": null,
"timeInForce": "GTC",
"cancelAfter": 0,
"postOnly": false,
"hidden": false,
"iceberge": false,
"iceberg": false,
"visibleSize": null,
"channel": "API",
"id": "611a6a309281bc000674d3c0",
"status": "success",
"failMsg": null,
"clientOid": "552a8a0b7cb04354be8266f0e202e7e9"
},
{
"symbol": "KCS-USDT",
"type": "limit",
"side": "buy",
"price": "0.01",
"size": "0.01",
"funds": null,
"stp": "",
"stop": "",
"stopPrice": null,
"timeInForce": "GTC",
"cancelAfter": 0,
"postOnly": false,
"hidden": false,
"iceberge": false,
"iceberg": false,
"visibleSize": null,
"channel": "API",
"id": "611a6a309281bc000674d3c1",
"status": "success",
"failMsg": null,
"clientOid": "bd1e95e705724f33b508ed270888a4a9"
}
]
}
API權限
此接口需要幣幣交易權限。
請求URL
此接口支持現貨URL
頻率限制
現貨類權重
:3
請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
clientOid | String | 是 | Client Order Id,客戶端創建的唯一標識,建議使用UUID |
side | String | 是 | buy(買) 或 sell(賣) |
symbol | String | 是 | 交易對 比如,ETH-BTC |
type | String | 否 | 訂單類型 只能是limit(默認爲limit) |
remark | String | 否 | 訂單說明,長度不超過50個字符(編碼只支持ASCII) |
stop | String | 否 | 止盈止損單,觸發條件, loss(小於等於) 或 entry(大於等於)。設置後,就必須設置stopPrice參數。 |
stopPrice | String | 否 | 觸發價格,只要設置stop參數,就必須設置此屬性。 |
stp | String | 否 | 自成交保護 分爲CN, CO, CB , DC四種策略 |
tradeType | String | 否 | 交易類型,默認爲TRADE |
price | String | 是 | 指定貨幣的價格 |
size | String | 是 | 指定貨幣的數量 |
timeInForce | String | 否 | 訂單時效策略 GTC, GTT, IOC, FOK (默認爲GTC) |
cancelAfter | long | 否 | n 秒之後取消,訂單時效策略爲 GTT |
postOnly | boolean | 否 | 被動委託的標識, 當訂單時效策略爲 IOC 或 FOK 時無效 |
hidden | boolean | 否 | 是否隱藏(買賣盤中不展示) |
iceberg | boolean | 否 | 冰山單中是否僅顯示訂單的可見部分 |
visibleSize | String | 否 | 冰山單最大的展示數量 |
返回值
字段 | 含義 |
---|---|
status | 訂單創建結果 (success, fail) |
failMsg | 失敗原因 |