提交批量订单
类型 POST
接口描述: /v4/batch-order
请求参数
参数名 | 类型 | 是否必填 | 默认值 | 描述 | 取值范围 |
---|---|---|---|---|---|
clientBatchId | string | 否 | N/A | 客户端批次号。正则规则:^[a-zA-Z0-9_]{4,32}$ | — |
items | array | 是 | N/A | 订单数组 | — |
item.symbol | string | 是 | N/A | 交易对 | — |
item.clientOrderId | string | 否 | N/A | 客户端订单号。正则规则:^[a-zA-Z0-9_]{4,32}$ | — |
item.side | string | 是 | N/A | 买卖方向 | BUY, SELL |
item.type | string | 是 | N/A | 订单类型 | LIMIT, MARKET |
item.timeInForce | string | 是 | N/A | 有效方式 | GTC, FOK, IOC, GTX |
item.bizType | string | 是 | N/A | 业务类型 | SPOT, LEVER |
item.price | number | 否 | N/A | 价格。LIMIT 必填,MARKET 可为空 | — |
item.quantity | number | 否 | N/A | 数量。LIMIT 必填,或按数量下 MARKET 订单时必填 | — |
item.quoteQty | number | 否 | N/A | 金额。LIMIT 必填,或按金额下 MARKET 订单时必填 | — |
限流规则
- 30次/秒/apikey
请求示例
Request
{
"clientBatchId": "51232",
"items": [
{
"symbol": "BTC_USDT",
"clientOrderId": "16559590087220001",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTC",
"bizType": "SPOT",
"price": 40000,
"quantity": 2,
"quoteQty": 80000
}
]
}
响应示例
Response
{
"rc": 0,
"mc": "string",
"ma": [{}],
"result": {
"batchId": "123",
"items": [
{
"index": "0", // 从 0 开始
"clientOrderId": "123",
"orderId": "123",
"reject": "false",
"reason": "invalid price precision"
}
]
}
}