Place Multiple Orders

Description

Place orders in a batch. A maximum of 10 orders can be placed per request.

HTTP Request

POST /v3/trade/orders

Request Parameters

Parameter	Required	Type	Description
symbol	Yes	String	A trading pair, consisting of two currencies: base currency and quote currency
side	Yes	String	Enumerate: BUY and SELL
type	Yes	String	Order type; enumerate MARKET, LIMIT, and LIMIT_MAKER
clOrdId	No	String	Client Order ID as assigned by the client
px	No	String	Price, applicable for limit orders only. No price input is required for market orders.
sz	Yes	String	Order size, specifically in Cont
reduceOnly	No	Boolean	Reduce only
timeInForce	No	String	Enumerate FOK, IOC, and GTC. It is an optional field with GTC by default.
stpMode	No	String	Enumerate - EXPIRE_TAKER - EXPIRE_MAKER - EXPIRE_BOTH Default is NONE

Response Parameters

Parameter	Type	Description
ordId	String	Order ID
clOrdId	String	Client Order ID as assigned by the client

Request Example

[
    {
        "symbol": "BTC_USDT_PERP",
        "side": "buy",
        "type": "limit",
        "px": "60000",
        "sz": "1",
        "timeInForce": "GTC",
        "stpMode": "",
        "reduceOnly": false,
        "clOrdId": "310d7fc9-8bb4-472f-b477-d974724f077d"
    },
    {
        "symbol": "BTC_USDT_PERP",
        "side": "buy",
        "type": "limit",
        "px": "60000",
        "sz": "2",
        "timeInForce": "GTC",
        "stpMode": "EXPIRE_TAKER",
        "reduceOnly": false,
        "clOrdId": "2486353f-64d3-4f7d-aa0a-7e34f45b6a6e"
    },
    {
        "symbol": "BTC_USDT_PERP",
        "side": "buy",
        "type": "limit",
        "px": "60000",
        "sz": "2",
        "timeInForce": "GTC",
        "stpMode": "EXPIRE_TAKER",
        "reduceOnly": false,
        "clOrdId": "57faf779-d45b-46ee-87e6-9cb11d5804f4"
    },
    {
        "symbol": "BTC_USDT_PERP",
        "side": "sell",
        "type": "limit_maker",
        "px": "60000",
        "sz": "1",
        "timeInForce": "GTC",
        "stpMode": "",
        "reduceOnly": false,
        "clOrdId": "843afc62-06ec-4439-bace-b93dd4d96fbd"
    },
    {
        "symbol": "BTC_USDT_PERP",
        "side": "sell",
        "type": "limit",
        "px": "60000",
        "sz": "2",
        "timeInForce": "GTC",
        "stpMode": "EXPIRE_TAKER",
        "reduceOnly": false,
        "clOrdId": "fa8011fe-8312-4b23-a671-b0ed34df3f30"
    },
    {
        "symbol": "BTC_USDT_PERP",
        "side": "sell",
        "type": "limit",
        "px": "60000",
        "sz": "2",
        "timeInForce": "GTC",
        "stpMode": "EXPIRE_TAKER",
        "reduceOnly": false,
        "clOrdId": "c9a20e43-1dda-45f4-9f69-3c0656b53161"
    }
]

Response Example

{
    "code":200,
    "data":[
        {
            "clOrdId":"310d7fc9-8bb4-472f-b477-d974724f077d",
            "code":10014,
            "msg":"Price limit, high 0.6897,low 0.5643",
            "ordId":""
        },
        {
            "clOrdId":"2486353f-64d3-4f7d-aa0a-7e34f45b6a6e",
            "code":200,
            "msg":"Success",
            "ordId":"331377100571541504"
        },
        {
            "clOrdId":"57faf779-d45b-46ee-87e6-9cb11d5804f4",
            "code":200,
            "msg":"Success",
            "ordId":"331377100605095936"
        },
        {
            "clOrdId":"843afc62-06ec-4439-bace-b93dd4d96fbd",
            "code":10014,
            "msg":"Price limit, high 0.6897,low 0.5643",
            "ordId":""
        },
        {
            "clOrdId":"fa8011fe-8312-4b23-a671-b0ed34df3f30",
            "code":200,
            "msg":"Success",
            "ordId":"331377100613484545"
        },
        {
            "clOrdId":"c9a20e43-1dda-45f4-9f69-3c0656b53161",
            "code":200,
            "msg":"Success",
            "ordId":"331377100621873152"
        }
    ],
    "msg":"Success"
}