# Batch create orders

**method url**: `/api/third/hot/order/batchCreate`

**request type**:`POST`

**data type**：application/json

**need sign:**`true`

**detail**:

**request example**:

```
{
  "orders": [
    {
      "clientOrderId": "",
      "isLong": true,
      "isMarket": true,
      "lever": 0,
      "matchType": 0,
      "pairName": "",
      "positionType": 0,
      "price": "",
      "quantity": ""
    }
  ],
  "timestamp": ""
}
```

**request param**:

| param\_name | param note            | type | required | data type | schema |
| ----------- | --------------------- | ---- | -------- | --------- | ------ |
|   orders    | order list （limit 20） |      | true     | array     |        |

order

| param\_name       | param note                          | type   | required | data type | schema |
| ----------------- | ----------------------------------- | ------ | -------- | --------- | ------ |
|     clientOrderId |                                     |        | true     | string    |        |
|     isLong        |                                     |        | true     | boolean   |        |
|     isMarket      |                                     |        | true     | boolean   |        |
|     lever         |                                     |        | true     | integer   |        |
|     matchType     | 1 GTC ；2 IOC ；3 FOK ；4 POST\_ONLY ； |        | true     | integer   |        |
|     pairName      |                                     |        | true     | string    |        |
|     positionType  | 3 one-way isloate 4 one-way cross   |        | true     | integer   |        |
|     price         |                                     |        | false    | string    |        |
|     quantity      |                                     |        | true     | string    |        |
|   timestamp       |                                     |        | true     | string    |        |
| Accept-Language   | zh-CN、en-US、                        | header | false    | string    |        |
| APIKEY            |                                     | header | true     | string    |        |
| signature         |                                     | header | true     | string    |        |

**response param【list】**:

| param\_name | param note | type           | schema |
| ----------- | ---------- | -------------- | ------ |
|   cOrderId  |            | string         |        |
|   orderId   |            | integer(int64) |        |
|   pairName  |            | string         |        |

**example**:

> 1 Set request parameters, json body\[No spaces.]:

```
{"orders":[{"clientOrderId":"1725696393685","isLong":true,"isMarket":true,"lever":20,"matchType":2,"pairName":"ETH-USD","positionType":3,"price":"3100","quantity":"0.02"},{"clientOrderId":"1725696393685","isLong":false,"isMarket":false,"lever":1,"matchType":1,"pairName":"ETH-USD","positionType":3,"price":"3500","quantity":"0.02"},{"clientOrderId":"1725696393685","isLong":false,"isMarket":false,"lever":1,"matchType":1,"pairName":"ETH-USD","positionType":3,"price":"3500","quantity":"0.02"}],"timestamp":"1725696393685"}
```

> 2 Sign the json string, result:

```
0x89d41d5762b114bfc2a698f1af59f622e93249a3228dfef07970f7d975e919fb12c339db8f628252773d00aa68b10732ffd45424976950e47db0da874bc7cc6a1b
```

> 3 Assemble the complete request

```
curl --location 'https://zk-test.satori.finance/api/third/hot/order/batchCreate' \
--header 'APIKEY: st_fq6cvRF4fr5tnKiZfrIntRnLfrwxcXjcfr1y8FR7' \
--header 'X-SAPI-SIGN-TYPE: 2' \
--header 'signature: 0x89d41d5762b114bfc2a698f1af59f622e93249a3228dfef07970f7d975e919fb12c339db8f628252773d00aa68b10732ffd45424976950e47db0da874bc7cc6a1b' \
--header 'Content-Type: application/json' \
--data '{"orders":[{"clientOrderId":"1725696393685","isLong":true,"isMarket":true,"lever":20,"matchType":2,"pairName":"ETH-USD","positionType":3,"price":"3100","quantity":"0.02"},{"clientOrderId":"1725696393685","isLong":false,"isMarket":false,"lever":1,"matchType":1,"pairName":"ETH-USD","positionType":3,"price":"3500","quantity":"0.02"},{"clientOrderId":"1725696393685","isLong":false,"isMarket":false,"lever":1,"matchType":1,"pairName":"ETH-USD","positionType":3,"price":"3500","quantity":"0.02"}],"timestamp":"1725696393685"}'
```

> 4 Return results

```
{
  "error": false,
  "code": 200,
  "msg": "SUCCESS",
  "data": [{
    "pairName": "ETH-USD",
    "orderId": 178785303,
    "corderId": "1725696393685"
  }, {
    "pairName": "ETH-USD",
    "orderId": 178785304,
    "corderId": "1725696393685"
  }, {
    "pairName": "ETH-USD",
    "orderId": 178785305,
    "corderId": "1725696393685"
  }],
  "sid": "1809523822859296769"
}
```

**Error Code**:

| code | msg                                                                       |
| ---- | ------------------------------------------------------------------------- |
| 2001 | Illegal parameter:{param0}                                                |
| 2002 | Required parameter:{param0}                                               |
| 2102 | Insufficient balance:{param0}                                             |
| 2122 | No hot assets have been frozen                                            |
| 2123 | The amount to be frozen must be greater than 0                            |
| 2124 | Failed to process hot account                                             |
| 2201 | Insufficient balance available                                            |
| 2301 | Quantity cannot be less than {param0}                                     |
| 2302 | Quantity cannot be greater than {param0}                                  |
| 2303 | Lever cannot be less than {param0}                                        |
| 2304 | Lever cannot be greater than {param0}                                     |
| 2305 | The quantity of one-way positions cannot be greater than {param0}         |
| 2306 | Total quantity of this contract positions cannot be greater than {param0} |
| 2307 | Contract stops trading                                                    |
| 2310 | The position margin mode is invalid, please try again.                    |
| 2312 | Decimal places out of limit                                               |
| 2316 | 10 minutes before delivery:Stop Open/Undo                                 |
| 2317 | Order too small                                                           |
| 2318 | The hot account not support reverse position order!                       |
| 2325 | Position type not supported,Supported types are{0}                        |
| 2329 | The server is updating, please wait a moment...                           |
| 2330 | No settlement coin found                                                  |
| 2331 | Market predict price was not obtained                                     |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.satori.finance/api-docs/openapi/rest-api/order-operation-private-operation/batch-create-orders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.