Skip to main content

Place Multiple Orders (TRADE)

API Description

Send multiple option orders.

HTTP Request

POST /eapi/v1/batchOrders

Request Weight

5

Request Parameters

NameTypeMandatoryDescription
ordersLISTYESorder list. Max 5 orders
recvWindowLONGNO
timestampLONGYES

Where batchOrders is the list of order parameters in JSON:

  • example: /eapi/v1/batchOrders?orders=[{"symbol":"BTC-210115-35000-C", "price":"100","quantity":"0.0002","side":"BUY","type":"LIMIT"}]
NameTypeMandatoryDescription
symbolSTRINGYESOption trading pair, e.g BTC-200730-9000-C
sideENUMYESBuy/sell direction: SELL, BUY
typeENUMYESOrder Type: LIMIT (Only support LIMIT)
quantityDECIMALYESOrder Quantity
priceDECIMALNOOrder Price
timeInForceENUMNOTime in force method(Default GTC)
reduceOnlyBOOLEANNOReduce Only(Default false)
postOnlyBOOLEANNOPost Only(Default false)
newOrderRespTypeENUMNO"ACK", "RESULT", Default "ACK"
clientOrderIdSTRINGNOUser-defined order ID cannot be repeated in pending orders
isMmpBOOLEANNOis market maker protection order, true/false
 
Some parameters are mandatory depending on the order type as follows:
TypeMandatory parameters
LIMITtimeInForce, quantity, price
  • Parameter rules are same with New Order
  • Batch orders are processed concurrently, and the order of matching is not guaranteed.

Response Example

[
{
"orderId": 4612288550799409153, // System order number
"symbol": "ETH-220826-1800-C", // Option trading pair
"price": "100", // Order Price
"quantity": "0.01", // Order Quantity
"side": "BUY", // Buy/sell direction
"type": "LIMIT", // Order type
"reduceOnly": false, // Order is reduce only Y/N
"postOnly": false, // Post only or not
"clientOrderId": "1001", // Client order ID
"mmp": false // MMP
}
]