高頻交易查詢活躍訂單列表
該接口是獲取所有活躍訂單列表,活躍訂單接口返回值是所有還沒有完成的訂單列表分頁後的數據。返回數據根據訂單最新更新時間降序排序。
用戶成功下單後,訂單就處於活躍(Active)狀態,用戶可以通過 inOrderBook 來判斷委託是否進入買賣盤。被取消或者已完全成交的訂單則被標記爲已完成(Done)狀態。 查詢“活躍”狀態的訂單,沒有時間限制。
HTTP請求
GET /api/v1/hf/orders/active
請求示例
GET /api/v1/hf/orders/active?symbol=BTC-ETH
// response
{
"code" : "200000",
"data" : [
"id": "5c35c02703aa673ceec2a168",
"symbol": "BTC-USDT",
"opType": "DEAL",
"type": "limit",
"side": "buy",
"price": "10",
"size": "2",
"funds": "0",
"dealFunds": "0.166",
"dealSize": "2",
"fee": "0",
"feeCurrency": "USDT",
"stp": "",
"timeInForce": "GTC",
"postOnly": false,
"hidden": false,
"iceberg": false,
"visibleSize": "0",
"cancelAfter": 0,
"channel": "IOS",
"clientOid": "",
"remark": "",
"tags": "",
"active": true,
"inOrderBook": true,
"cancelExist": false,
"createdAt": 1547026471000,
"lastUpdatedAt": 1547026471001,
"tradeType": "TRADE",
"cancelledSize": "0",
"cancelledFunds": "0",
"remainSize": "0",
"remainFunds": "0"
}
]
}
API權限
此接口需要通用權限
請求URL
此接口支持現貨URL
頻率限制
現貨類權重
:2
請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
symbol | String | 是 | 只返回指定交易對的訂單信息 |
返回值
字段 | 含義 |
---|---|
id | 訂單id,訂單唯一標識 |
symbol | 交易對 |
opType | 操作類型: DEAL |
type | 訂單類型 |
side | 買或賣 |
price | 訂單價格 |
size | 訂單數量 |
cancelledSize | 累計取消數量 |
dealSize | 成交數量 |
remainSize | 剩餘數量 |
funds | 下單金額 |
cancelledFunds | 市價單累計取消資金 |
dealFunds | 成交額 |
remainFunds | 市價單剩餘資金 |
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 | 交易類型: TRADE(現貨交易) |
訂單輪詢(Polling)
對於高頻交易的用戶,建議您在本地緩存和維護一份自己的活動委託列表,並使用市場數據流實時更新自己的訂單信息。