031limit_order

Place Limit Order

• Request description:place limit order.

• Request type: POST

• Signature required: Yes

• Rate limit: 100/10s

• Request Header:

  authorization:"xxxx" (32-digit capital letters, see generating methos in <API invocation instruction>)

• Request Url:https://api.coinex.com/v1/order/limit

• Request parameter:

  name	type	required	description
  access_id	String	Yes	access_id
  market	String	Yes	See <API invocation description·market>
  type	String	Yes	sell: sell order; buy: buy order;
  amount	String	Yes	order amount, min. 0.001, accurate to 8 decimal places
  price	String	Yes	order amount, accurate to 8 decimal places
  source_id	String	no	user defines number and return
  account_id	Integer	no	main account ID: 0, margin account ID: See < Inquire Margin Account Market Info >, future account ID: See < Inquire Future Account Market Info >
  tonce	Integer	Yes	Tonce is a timestamp with a positive Interger that represents the number of milliseconds from Unix epoch to the current time. Error between tonce and server time can not exceed plus or minus 60s

• Return value description:

  name	type	description
  amount	String	order count
  avg_price	String	average price
  create_time	Interger	time when placing order
  deal_amount	String	count
  deal_fee	String	transaction fee
  deal_money	String	amount
  finished_time	Interger	complete time
  id	Interger	Order No.
  maker_fee_rate	String	maker fee
  market	String	See <API invocation description·market>
  order_type	String	limit:limit order; market:market order;
  price	String	order price
  status	String	not_deal: unexecuted; part_deal: partly executed; done: executed;
  taker_fee_rate	String	taker fee
  type	String	sell: sell order; buy: buy order;

• Example:

# Request
POST https://api.coinex.com/v1/order/limit
# Request.Body
{
  "access_id":" BFFA64957AA240F6BBEA26F4E07EC0D9",
  "amount": "56.5",  # order count
  "price": "10",   # order price
  "type": "sell",    # order type
  "market":"BTCBCH",  # market type
  "tonce": 1513746038205,
  "source_id": "123" # user defines number and return
}
# Response
{
  "code": 0,
  "data": {
    "amount": "56.5",              # order count       
    "avg_price": "11641.3",        # average order price
    "create_time": 1496798479,     # order placing time 
    "deal_amount": "56.5",         # executed amount
    "deal_fee": "1315.4669122",    # transaction fee
    "deal_money": "657733.4561",   # executed value
    "id": 300032,                  # order no.
    "left": "0",                   # unexecuted amount
    "maker_fee_rate": "0.001",     # maker rate
    "market": "BTCBCH",            # market
    "order_type": "limit",         # order type: limit: limit order;market: market order;
    "price": "10",                 # order price
    "source_id": "123",            # user-defined no.
    "status": "done",              # order status: done:executed;part_deal:partly executed;not_deal:unexecuted;
    "taker_fee_rate": "0.002",     # taker rate
    "type": "sell"                 # order type: sell: sell;buy: buy;
  },
  "message": "Ok"
}