Batch Order

Batch order (Authentication type: SIGNED, See Interface Permission)

Request Format

POST https://api-cloud.bitmart.com/contract/v1/ifcontract/batchOrders

Request Limit

See Detailed Rate Limit

Request Parameter

Opening order request

Field Type Required? Description
contract_id long Yes Contract ID
category int Yes Order type
1: Limit order
2: Market order
way int Yes Order side
1: Open long
4: Open short
custom_id int Yes The client's custom ID must be passed, otherwise it returns invalid parameters
open_type int Yes Open type
1: Cross margin
2: Fixed margin
leverage int Yes Leverage must meet the effective range of leverage configured in the contract, otherwise invalid parameters are returned
price string Yes The price must meet the price accuracy requirements of the contract configuration, and the accuracy is the contract configuration price precision multiplied by 10, otherwise invalid request is returned
vol string Yes The quantity must meet the quantity precision configured by the contract, otherwise invalid request is returned

Closing order request

Field Type Required? Description
contract_id long Yes Contract ID
category int Yes Order type
1: Limit order
2: Market order
position_id long Yes Position ID, you must send the position ID, otherwise invalid parameters are returned
way int Yes Order side
2: Close short
3: Close long
price string Yes The price must meet the price accuracy requirements of the contract configuration, and the accuracy is the contract configuration price precision multiplied by 10, otherwise invalid request is returned
vol string Yes The quantity must meet the quantity precision configured by the contract, otherwise invalid request is returned

Instruction

Request example

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"
        }
    ]
}

Response Data

Field Type Description
custom_id int Client custom ID
order_id int Order ID

Example of returned data format

Success:
{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
      "orders": [
          {
              "custom_id": 1,
              "order_id": 10540013
          },
          {
              "custom_id": 2,
              "order_id": 10540014
          }
      ]
  }
}

Failure:
{
  "errno": "OK",
  "message": "Success",
  "data": {
      "orders": [
          {
              "custom_id": 1,
              "err": {
                  "http_err":405,
                  "err_code":"LIQUIDATE_ORDER",
                  "err_msg":"The order will trigger a strong flat"
              }
          },
          {
              "custom_id": 2,
              "order_id": 10540014
          }
      ]
  }
}

results matching ""

    No results matching ""