New Order

POST /api/v1/trade/order

Permission: Trade

weight: 1

Request parameters

Name	Type	Mandatory	Description
symbol	string	YES	symbol
side	string	YES	BUY / SELL
type	string	YES	LIMIT / MARKET
clientOrderId	string	NO	Client id, consisting of upper and lower case letters / numbers / hyphen, maximum 64 bits.
size	string	NO	Quantity. Required in limit order and market sell order.
price	string	NO	Price. Required in limit order.
amount	string	NO	Buying amount. Required in market buy order.
IOC	boolean	NO	Default false .

Response format

Name	Type	Description
orderId	number	Order id.
clientOrderId	string	Client id.

Caution:

Error code:

• TRADE_INVALID_SYMBOL Invalid symbol.

• TRADE_PARAMETER_ERROR Parameter error.

• TRADE_NOT_ENOUGH_MONEY Price amount higher than available balance.

• TRADE_PRICE_FILTER_DENIED Price too low or too high.

• TRADE_SIZE_FILTER_DENIED Invalid quantity.

• TRADE_AMOUNT_FILTER_DENIED Invalid amount of market buy order or invalid price * size.

• TRADE_REPEAT_CLIENT_ORDER_ID Duplicated clientOrderId.

• TRADE_OPEN_ORDER_EXCEED_LIMIT The number of open orders exceed the maximum limit.

• TRADE_OPERATION_DENIED Operation denied.

Request example

POST https://{site}/api/v1/trade/order
{
  "clientOrderId":  "9e3d93d6-e9a4-465a-a39c-2e48568fe194",
  "symbol":  "BTC_USDT",
  "side":  "BUY",
  "type":  "LIMIT",
  "size":  "0.1",
  "price":  "30000",
  "IOC":  true
}

Response example

{ 
  "data": {
    "orderId": 1234567890,
    "clientOrderId":  "9e3d93d6-e9a4-465a-a39c-2e48568fe194"
  },
  "result": true,
  "timestamp": 1566691672311
}