高頻交易通過clientOid獲取訂單詳情
此接口,可以通過clientOid查詢單個訂單的信息,若訂單不存在則提示訂單不存在。
查詢“已完成”狀態的訂單時,您只能獲取 3 * 24 小時時間範圍內的數據(即:從當前時間起至3 * 24 小時前)。若超出時間範圍,系統會默認查詢 3 * 24 小時時間範圍內的數據。
HTTP請求
GET /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}
請求示例
GET /api/v3/hf/margin/orders/client-order/6d539dc614db312?symbol=6d539dc614db312
//Response
{
"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"
}
}
API權限
此接口需要通用權限
請求URL
此接口支持现货URL
頻率限制
現貨類權重
:5
請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
clientOid | String | 是 | 路徑參數,客戶端生成的標識 |
symbol | String | 是 | 交易對 比如,ETH-BTC |
返回值
字段 | 含義 |
---|---|
id | 訂單id,訂單唯一標識 |
symbol | 交易對 |
opType | 操作類型: DEAL |
type | 訂單類型 |
side | 買或賣 |
price | 訂單價格 |
size | 訂單數量 |
funds | 下單金額 |
dealFunds | 成交額 |
dealSize | 成交數量 |
fee | 手續費 |
feeCurrency | 計手續費幣種 |
stp | 自成交保護 |
timeInForce | 訂單時效策略 |
postOnly | 是否為被動委託 |
hidden | 是否為隱藏單 |
iceberg | 是否為冰山單 |
visibleSize | 冰山單在買賣盤可見數量 |
cancelAfter | timeInForce 為 GTT n秒後觸發 |
channel | 下單來源 |
clientOid | 客戶端生成的標識 |
remark | 訂單說明 |
tags | 訂單標籤 |
active | 訂單狀態 true: 訂單狀態為 active; false: 訂單訂單狀態為 done |
inOrderBook | 是否進入買賣盤 true: 進入買賣盤; false: 沒有進入買賣盤 |
cancelExist | 訂單是否存在取消記錄 |
createdAt | 訂單創建時間 |
lastUpdatedAt | 訂單最新更新時間 |
tradeType | 訂單類型: MARGIN_TRADE -全倉交易訂單,MARGIN_ISOLATED_TRADE -逐倉交易訂單 |