批量下单
批量下单
(鉴权类型: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
}
]
}
}