Skip to main content

New Order (TRADE)

API Description#

Send a new order.

HTTP Request#

POST /eapi/v1/order

Request Parameters#

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
recvWindowLONGNO
timestampLONGYES

Some parameters are mandatory depending on the order type as follows:

TypeMandatory parameters
LIMITtimeInForce, quantity, price

Response Example#

Response ACK:

{  "orderId": 4611875134427365377,     // System order number  "clientOrderId": ""                 // Client order ID  "symbol": "BTC-200730-9000-C",      // Option trading pair  "price": "100",                     // Order Price  "quantity": "1",                    // Order Quantity  "side": "BUY",                      // Buy/sell direction  "type": "LIMIT",                    // Order type  "createDate": 1592465880683,        // Order Time  "updateTime": 1566818724722,        // Update time}

Response RESULT:

{  "orderId": 4611875134427365377,     // System order number  "symbol": "BTC-200730-9000-C",      // Option trading pair  "price": "100",                     // Order Price  "quantity": "1",                    // Order Quantity  "executedQty": "0",                 // Number of executed quantity  "fee": "0",                         // Fee   "side": "BUY",                      // Buy/sell direction  "type": "LIMIT",                    // Order type  "timeInForce": "GTC",               // Time in force method  "reduceOnly": false,                // Order is reduce only Y/N  "postOnly": false,                  // Order is post only  "createTime": 1592465880683,        // Order Time  "updateTime": 1566818724722,        // Update time  "status": "ACCEPTED",               // Order status  "avgPrice": "0",                    // Average price of completed trade  "clientOrderId": ""                 // Client order ID  "priceScale": 2,  "quantityScale": 2,  "optionSide": "CALL",  "quoteAsset": "USDT",  "mmp": false}