獲取流水記錄 - 槓桿高頻
獲取高頻杠杠交易帳戶的出入賬流水記錄,支持多幣種查詢。查詢結果按流水創建時間和Id降序排序。
HTTP請求
GET /api/v3/hf/margin/account/ledgers
請求示例
GET /api/v3/hf/margin/account/ledgers?bizType=MARGIN_EXCHANGE¤cy=YOP,DAI&startAt=1601395200000
//Response
{
"code": "200000",
"data": [
{
"id": "42852417537",
"currency": "CSP",
"amount": "1.00000000",
"fee": "0.00000000",
"balance": "99999986.99999999",
"accountType": "MARGIN_V2",
"bizType": "MARGIN_EXCHANGE",
"direction": "in",
"createdAt": "1661347205743",
"context": "{'symbol':'CSP-USDT','orderId':'6306257dd9180300014c8d47','tradeId':'609522034689'}"
},
{
"id": "42852401152",
"currency": "CSP",
"amount": "1.00000000",
"fee": "0.00000000",
"balance": "99999985.99999999",
"accountType": "MARGIN_V2",
"bizType": "MARGIN_EXCHANGE",
"direction": "out",
"createdAt": "1661347205743",
"context": "{'symbol':'CSP-USDT','orderId':'63062585d9180300014c8d50','tradeId':'609522034689'}"
}
]
}
API權限
此接口需要通用權限
請求URL
此接口支持现货URL
頻率限制
現貨類權重
:2
請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
currency | String | 否 | 幣種,選填,可多選,以逗號分隔,最多支持選擇10個幣種,若不填寫,默認查詢所有幣種 |
direction | String | 否 | 出入賬方向: in -入賬,out -出賬 |
bizType | String | 否 | 業務類型: TRANSFER -轉賬,MARGIN_EXCHANGE -全倉交易,ISOLATED_EXCHANGE -逐倉交易,LIQUIDATION -平倉,ASSERT_RETURN -強平資產回退 |
lastId | long | 否 | 前一批次數據最後一條數據的id,默認獲取最新流水。 |
limit | int | 否 | 默認100,最大200 |
startAt | long | 否 | 開始時間(毫秒),限制流水創建時間 |
endAt | long | 否 | 截止時間(毫秒),限制流水創建時間 |
TIP
如果設定lastId,獲取流水id < lastId,否則返回最近流水。lastId的值取流水id,可以從返回結果裏獲取。
您只能獲取 3 * 24 小時時間範圍內的數據(即:從當前時間起至3 * 24 小時前)。若超出時間範圍,系統會默認查詢 3 * 24 小時時間範圍內的數據。
如果 bizType 是MARGIN_EXCHANGE 或 ISOLATED_EXCHANGE,那麼 context 字段會包含交易的額外信息(訂單id,交易id,交易對)。
返回值
字段 | 含義 |
---|---|
id | 唯一鍵 |
currency | 幣種 |
amount | 資金變動值 |
fee | 充值或提現費率 |
balance | 變動後的資金總額 |
accountType | 母帳號帳戶類型MARGIN_V2 -全倉,ISOLATED_V2 -逐倉 |
bizType | 業務類型,比如TRANSFER -轉賬,MARGIN_EXCHANGE -全倉交易 |
direction | 出入賬方向 out 或 in |
createdAt | 創建時間 |
context | 業務核心參數 |