Skip to content

037order_status

buyongji edited this page Jun 28, 2018 · 10 revisions

Acquire Order Status

  • Request description: Acquire order status.

  • 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/

  • Request parameter:

    name type required description
    access_id String Yes access_id
    id Interger Yes order no
    market String Yes See <API invocation description·market>
    tonce Interger 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 executed value
    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;
    To guarantee server performance, all cancelled unexecuted orders will be deleted.
    taker_fee_rate String taker fee
    type String sell: sell order;
    buy: buy order;
  • Example:

# Request
GET https://api.coinex.com/v1/order/?id=300021&access_id=F0160AD40BAE4519A3836BFB057BD682&market=btcbch&tonce=1513746038205

# Response
{
  "code": 0,
  "data": {                           # order data
    "amount": "1000",                 # order count
    "avg_price": "11782.28",          # average executed price
    "create_time": 1496761108,        # order placing time
    "deal_amount": "1000",            # executed amount
    "deal_fee": "23564.5798468",      # transaction fee
    "deal_money": "11782289.9234",    # executed value
    "id": 300021,                     # order no.
    "left": "9.4",                    # unexecuted amount
    "maker_fee_rate": "0.001",        # maker fee
    "market": "BTCBCH",               # market
    "order_type": "limit",            # order type
    "price": "7000",                  # order price
    "status": "done",                 # order status
    "taker_fee_rate": "0.002",        # taker fee
    "type": "sell"                    # order type
    }
  },
  "message": "Ok"
}

HTTP API Introduction

Common API

Market API

Account API

Trading API

Margin API

Contract API

WebSocket API Introduction

Clone this wiki locally