031limit_order - coinexcom/coinex_exchange_api GitHub Wiki
-
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"
}