批量下单

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

results matching ""

    No results matching ""