批量下單

該接口支持在一個接口中批量下單,每次可同時下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 下單備註,長度不超過100個字符(UTF-8)
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 被動委託的標識, 當訂單時效策略爲 IOCFOK 時無效
hidden boolean 是否隱藏(買賣盤中不展示)
iceberg boolean 冰山單中是否僅顯示訂單的可見部分
visibleSize String 冰山單最大的展示數量
返回值
字段 含義
status 訂單創建結果 (success, fail)
failMsg 失敗原因