Batch Add Orders

POST

https://api-futures.kucoin.com/api/v1/orders/multi

api-channel:Private

api-permission:Futures

api-rate-limit-pool:Futures

sdk-service:Futures

sdk-sub-service:Order

sdk-method-name:batchAddOrders

api-rate-limit-weight:20

Description

Place multiple order to the futures trading system, you can place two major types of orders: limit and market. Orders can only be placed if your account has sufficient funds. Once an order is placed, your funds will be put on hold for the duration of the order. The amount of funds on hold depends on the order type and parameters specified.
You can place up to 20 orders at one time, including limit orders, market orders, and stop orders

Please be noted that the system would hold the fees from the orders entered the orderbook in advance.

Do NOT include extra spaces in JSON strings.

Place Order Limit
The maximum limit orders for a single contract is 100 per account, and the maximum stop orders for a single contract is 50 per account.

Tips

The maximum limit orders for a single contract is 100 per account, and the maximum stop orders for a single contract is 50 per account.

Request

Body Params application/json

Example

[
    {
        "clientOid": "5c52e11203aa677f33e493fb",
        "side": "buy",
        "symbol": "XBTUSDTM",
        "leverage": 3,
        "type": "limit",
        "remark": "order remarks",
        "reduceOnly": false,
        "marginMode": "ISOLATED",
        "positionSide": "BOTH",
        "price": "0.1",
        "size": 1,
        "timeInForce": "GTC"
    },
    {
        "clientOid": "5c52e11203aa677f33e493fc",
        "side": "buy",
        "symbol": "XBTUSDTM",
        "leverage": 3,
        "type": "limit",
        "remark": "order remarks",
        "reduceOnly": false,
        "marginMode": "ISOLATED",
        "positionSide": "BOTH",
        "price": "0.1",
        "size": 1,
        "timeInForce": "GTC"
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-futures.kucoin.com/api/v1/orders/multi' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "clientOid": "5c52e11203aa677f33e493fb",
        "side": "buy",
        "symbol": "XBTUSDTM",
        "leverage": 3,
        "type": "limit",
        "remark": "order remarks",
        "reduceOnly": false,
        "marginMode": "ISOLATED",
        "positionSide": "BOTH",
        "price": "0.1",
        "size": 1,
        "timeInForce": "GTC"
    },
    {
        "clientOid": "5c52e11203aa677f33e493fc",
        "side": "buy",
        "symbol": "XBTUSDTM",
        "leverage": 3,
        "type": "limit",
        "remark": "order remarks",
        "reduceOnly": false,
        "marginMode": "ISOLATED",
        "positionSide": "BOTH",
        "price": "0.1",
        "size": 1,
        "timeInForce": "GTC"
    }
]'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": [
        {
            "orderId": "235919387779985408",
            "clientOid": "5c52e11203aa677f33e493fb",
            "symbol": "XBTUSDTM",
            "code": "200000",
            "msg": "success"
        },
        {
            "orderId": "235919387855482880",
            "clientOid": "5c52e11203aa677f33e493fc",
            "symbol": "XBTUSDTM",
            "code": "200000",
            "msg": "success"
        }
    ]
}

Modified at 2025-11-10 09:13:58

Add Order Test

Add Take Profit And Stop Loss Order