獲取流水記錄 - 合約

當存在未平倉合約時，第一頁返回數據包含的未平倉合約記錄狀態爲Pending，是當前8小時結算週期內的已實現盈虧。翻頁使用當前頁返回的最小offset，作爲請求offset參數值傳入，實現翻頁。

HTTP請求

GET /api/v1/transaction-history

請求示例

GET /api/v1/transaction-history?offset=1&forward=true&maxCount=50

  {
    "code": "200000",
    "data": {
      "hasMore": false,//是否存在下一頁
      "dataList": [{
        "time": 1558596284040, //業務發生時間
        "type": "RealisedPNL", //類型
        "amount": 0, //交易金額
        "fee": null,//手續費
        "accountEquity": 8060.7899305281, //賬戶權益
        "status": "Pending", //狀態，當前8h有過未平倉合約
        "remark": "XBTUSDM",//合約
        "offset": -1, //起始偏移量，一般使用上個請求最後一條返回結果的唯一屬性，默認返回第一頁
        "currnecy": "XBT" //幣種
      },
      {
        "time": 1557997200000,
        "type": "RealisedPNL",
        "amount": -0.000017105,
        "fee": 0,
        "accountEquity": 8060.7899305281,
        "status": "Completed",//狀態，已完成的8h週期
        "remark": "XBTUSDM",
        "offset": 1,
        "currency": "XBT"
     }]
    }
  }

API權限

此接口需要通用權限

請求URL

此接口支持合約URL

頻率限制

管理类权重：2

參數

參數	數據類型	是否必須	含義
startAt	long	否	開始時間（毫秒）
endAt	long	否	截止時間（毫秒）
type	String	否	類型 RealisedPNL-已實現盈虧；Deposit-充值,Withdrawal-提現；TransferIn-轉入；TransferOut-轉出
offset	long	否	起始偏移量，一般使用上個請求最後一條返回結果的唯一屬性，默認返回第一頁
maxCount	long	否	每頁顯示條數 默認50
currency	String	否	幣種 XBT或USDT
forward	boolean	否	是否前向查詢，true或者false，默認爲true

TIP

針對startAt、endAt的補充說明：startAt必須小於endAt；並且間隔不能超過1天；允許只傳一個字段，如果只傳一個字段時，另有一個字段系統會自動進行加減1天補齊

返回值

字段	含義
time	業務發生時間
type	類型包括 RealisedPNL-已實現盈虧,Deposit-充值,Withdrawal-提現,TransferIn-轉入 ,TransferOut-轉出
amount	交易金額
fee	手續費
accountEquity	賬戶權益
status	狀態包括 Completed，Pending
remark	合約
offset	起始偏移量，一般使用上個請求最後一條返回結果的唯一屬性，默認返回第一頁
currnecy	幣種