036finished

Acquire Executed Order List

• Request description: Acquire executed order list, including datas in last 2 days.

• Request type: GET

• Signature required: Yes

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

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

• Request parameter:

  name	type	required	description
  access_id	String	Yes	access_id
  market	String	Yes	See <API invocation description·market>
  page	Integer	Yes	page, start from 1
  limit	Integer	Yes	Amount per page(1-100)
  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
  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 >

• 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
GET https://api.coinex.com/v1/order/finished?access_id=EFF0C4057AA240F6AAE52634E07EC0DC&limit=10&market=BTCBCH&page=1&tonce=1513746038205

# Response
{
  "code": 0, 
  "data": {
    "count": 1,                   # current page rows
    "curr_page": 1,               # current page 
    "data": [                     # return in reverse of (executed) order time with latest order on top
        {
            "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
        },
    ], 
    "has_next": true,             # is there a next page
  }, 
  "message": "Ok"
}