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
  option	String	no	order option, NORMAL: normal order, IOC: an Immediate or Cancel Order, FOK: Fill or kill Order, MAKER_ONLY: only maker order, default value is NORMAL
  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
  client_id	String	No	client_id is the custom id of order. Currently, it only supports uppercase and lowercase letters, numbers, hyphens and underlines, and it should be less than 32 bytes.
  hide	Boolean	No	Whether to hide order, default to false

• Return value description:

  name	type	description
  amount	String	order count
  asset_fee	String	asset fee
  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
  fee_asset	String	fee asset
  fee_discount	String	fee discount
  finished_time	Integer	complete time
  id	Integer	Order No.
  left	String	left
  maker_fee_rate	String	maker fee
  money_fee	String	money 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;
  stock_fee	String	stock fee
  taker_fee_rate	String	taker fee
  type	String	sell: sell order; buy: buy order;
  client_id	String	client_id: what you give

• 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
    "asset_fee": "0.01"            # asset fee       
    "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
    "fee_asset": "BCH",            # fee asset
    "fee_discount": "0.01",        # fee discount
    "id": 300032,                  # order no.
    "left": "0",                   # unexecuted amount
    "maker_fee_rate": "0.001",     # maker rate
    "market": "BTCBCH",            # market
    "money_fee": "0.01",           # money fee
    "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;
    "client_id": "xxx",            # client_id: return what you give
  },
  "message": "Ok"
}