Get HF order details by clientOid

This endpoint can be used to obtain information for a single margin HF order using the clientOid.

If the order is not an active order, you can only get data within the time range of 3 _ 24 hours (ie: from the current time to 3 _ 24 hours ago). If the time range is exceeded, the system will query the data within the time range of 3 * 24 hours by default.


GET /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}


GET /api/v3/hf/margin/orders/client-order/6d539dc614db312?symbol=6d539dc614db312

  "code": "200000",
  "data": {
    "id": "5f3113a1c9b6d539dc614dc6",
    "symbol": "KCS-BTC",
    "opType": "DEAL",
    "type": "limit",
    "side": "buy",
    "price": "0.00001",
    "size": "1",
    "funds": "0",
    "dealFunds": "0",
    "dealSize": "0",
    "fee": "0",
    "feeCurrency": "BTC",
    "stp": "",
    "timeInForce": "GTC",
    "postOnly": false,
    "hidden": false,
    "iceberg": false,
    "visibleSize": "0",
    "cancelAfter": 0,
    "channel": "API",
    "clientOid": "6d539dc614db312",
    "remark": "",
    "tags": "",
    "active": true,
    "inOrderBook": false,
    "cancelExist": false,
    "createdAt": 1547026471000,
    "lastUpdatedAt": 1547026471001,
    "tradeType": "MARGIN_TRADE"

This endpoint requires the General permission.


This endpoint support Spot URL


Spot weight:5

Param Type Mandatory Description
clientOid String Yes Path parameter,an identifier created by the client
symbol String Yes symbol, such as, ETH-BTC
Param Description
id Order id,a unique identifier pertaining to the order
symbol Trading pair
opType Operation type: DEAL
type Order type
side Buy or sell
price Order price
size Order size
funds Order amount
dealFunds Number of filled funds
dealSize Number of filled transactions
fee Service fee
feeCurrency currency used to calculate fees
stp self trade prevention
timeInForce Time in force
postOnly Is it post only?
hidden Is it a hidden order?
iceberg Is it an iceberg order?
visibleSize Visible size of iceberg order in order book.
cancelAfter A GTT timeInForce that expires in n seconds
channel Source of orders
clientOid Identifier created by the client
remark Order description
tags Order identifier
active Order status: true-The status of the order isactive; false-The status of the order isdone
inOrderBook Whether to enter the orderbook: true: enter the orderbook; false: not enter the orderbook
cancelExist Are there any cancellation records pertaining to the order?
createdAt order creation time
lastUpdatedAt Last update time of order
tradeType Transaction type: MARGIN_TRADE - cross margin trading order, MARGIN_ISOLATED_TRADE - isolated margin trading order