Skip to main content

Submit batch order

POST

/az/spot/batch-order

Limit Flow Rules​

30/s/apikey

Parameters​

ParameterTypeMandatoryDefaultDescriptionRanges
clientBatchIdstringfalseClient batch number. Pattern: ^[a-zA-Z0-9_]{4,32}$
itemsarraytruearray
item.symbolstringtrue
item.clientOrderIdstringfalsePattern: ^[a-zA-Z0-9_]{4,32}$
item.sidestringtrueBUY,SELL
item.typestringtrueorder type:LIMIT,MARKET
item.timeInForcestringtrueeffective way:GTC, FOK, IOC, GTX
item.bizTypestringtrueSPOT, PREDICTION
item.pricenumberfalseprice. Required if it is the LIMIT price; blank if it is the MARKET price
item.quantitynumberfalsequantity. Required if it is the LIMIT price or the order is placed at the market price by quantity
item.quoteQtynumberfalseamount. Required if it is the LIMIT price or the order is the market price when placing an order by amount
item.outcomenumberfalseoutcome. Required if it is the PREDICTION bizType; [1=YES;2=NO]
item.slippagenumberfalseRFQ slippage. Example: 0.01

Request

{
"clientBatchId": "51232",
"items": [
{
"symbol": "BTC_USDT",
"clientOrderId": "16559590087220001",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTC",
"bizType": "SPOT",
"price": 40000,
"quantity": 2,
"quoteQty": 80000
}
]
}

Response

{
"rc": 0,
"mc": "string",
"ma": [
{}
],
"result": {
"batchId": "123",
"items": [
{
"index": "0", // start with 0
"clientOrderId": "123",
"orderId": "123",
"rejected": false, // whether rejected
"reason": "invalid price precision"
}
]
}
}