批量下单
批量下单 (鉴权类型:SIGNED, 参见接口权限)
请求格式
POST https://api-cloud.bitmart.com/contract/v1/ifcontract/batchOrders
请求限制
参见 速率限制详细
请求参数
开仓订单请求参数
| 参数 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| contract_id | long | 是 | 合约 ID |
| category | int | 是 | 订单类型 |
1:限价单 |
|||
2:市价单 |
|||
| way | int | 是 | 订单方向 |
1:开多 |
|||
4:开空 |
|||
| custom_id | int | 是 | 客户端自定义ID,必须传,否则返回无效参数 |
| open_type | int | 是 | 开仓方式 |
1:逐仓 |
|||
2:全仓 |
|||
| leverage | int | 是 | 杠杆,必须满足合约配置的杠杆有效范围,否则返回无效参数 |
| price | string | 是 | 价格,必须满足合约配置的价格精度要求,精度是合约配置价精度乘以10,否则返回无效请求 |
| vol | string | 是 | 数量,必须满足合约配置的量精度,否则返回无效请求 |
平仓订单请求参数
| 参数 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| contract_id | long | 是 | 合约 ID |
| category | int | 是 | 订单类型 |
1:限价单 |
|||
2:市价单 |
|||
| position_id | long | 是 | 仓位ID,必须带仓位ID,否则返回无效参数 |
| way | int | 是 | 订单方向 |
2:平空 |
|||
3:平多 |
|||
| price | string | 是 | 价格,必须满足合约配置的价格精度要求,精度是合约配置价精度乘以10,否则返回无效请求 |
| vol | string | 是 | 数量,必须满足合约配置的量精度,否则返回无效请求 |
解释说明
请求示例
https://api-cloud.bitmart.com/contract/v1/ifcontract/batchOrders
{
"orders":[
{
"contract_id":3,
"category":1,
"custom_id":1,
"way":4,
"open_type":1,
"leverage":100,
"price":"100",
"vol":"10"
},
{
"contract_id":3,
"category":1,
"custom_id":2,
"way":4,
"open_type":1,
"leverage":100,
"price":"100",
"vol":"10"
}
]
}
响应详情
| 字段 | 类型 | 描述 |
|---|---|---|
| custom_id | int | 客户端自定义 ID |
| order_id | int | 订单 ID |
返回数据格式示例
成功:
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"orders": [
{
"custom_id": 1,
"order_id": 10540013
},
{
"custom_id": 2,
"order_id": 10540014
}
]
}
}
失败:
{
"errno": "OK",
"message": "Success",
"data": {
"orders": [
{
"custom_id": 1,
"err": {
"http_err":405,
"err_code":"LIQUIDATE_ORDER",
"err_msg":"订单将触发强平"
}
},
{
"custom_id": 2,
"order_id": 10540014
}
]
}
}