獲取流水記錄 - 現貨高頻

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

HTTP請求

GET /api/v1/hf/accounts/ledgers

請求示例

GET /api/v1/hf/accounts/ledgers?bizType=TRADE_EXCHANGE&currency=YOP,DAI&startAt=1601395200000

// response
{
    "code": "200000", 
    "data": [
        {
            "id": "42852417537", 
            "currency": "CSP", 
            "amount": "1.00000000", 
            "fee": "0.00000000", 
            "balance": "99999986.99999999", 
            "accountType": "TRADE_HF", 
            "bizType": "TRADE_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": "TRADE_HF", 
            "bizType": "TRADE_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-轉賬,TRADE_EXCHANGE-交易
lastId	long	否	前一批次數據最後一條數據的id。 默認獲取最新流水
limit	int	否	默認100，最大200
startAt	long	否	開始時間（毫秒），限制流水創建時間
endAt	long	否	截止時間（毫秒），限制流水創建時間

TIP

如果設定lastId，獲取流水id < lastId，否則返回最近流水。lastId的值取流水id，可以從返回結果裏獲取。

您只能獲取3 * 24小時時間範圍內的數據（即：從當前時間起至3 * 24小時前）。若超出時間範圍，系統會默認查詢3 * 24小時時間範圍內的數據。

返回值

字段	含義
id	唯一鍵
currency	幣種
amount	資金變動值
fee	充值或提現費率
balance	變動後的資金總額
accountType	母賬號賬戶類型TRADE_HF
bizType	業務類型，比如TRANSFER-轉賬，TRADE_EXCHANGE -交易
direction	出入賬方向 out 或 in
createdAt	創建時間
context	業務核心參數

• context說明
  • 如果 bizType 是TRADE_EXCHANGE，那麼 context 字段會包含交易的額外信息（訂單id，交易id，交易對）。