獲取流水記錄 - 槓桿高頻

獲取高頻杠杠交易帳戶的出入賬流水記錄,支持多幣種查詢。查詢結果按流水創建時間和Id降序排序。

HTTP請求

GET /api/v3/hf/margin/account/ledgers

請求示例

GET /api/v3/hf/margin/account/ledgers?bizType=MARGIN_EXCHANGE&currency=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 業務核心參數