獲取流水記錄 - 現貨/槓桿

此接口返回所有賬戶的出入賬流水記錄，支持多幣種查詢。 返回值是分頁後的數據，根據時間降序排序。

HTTP請求

GET /api/v1/accounts/ledgers

請求示例

GET /api/v1/accounts/ledgers?currency=BTC&startAt=1601395200000

{
  "currentPage": 1,
  "pageSize": 50,
  "totalNum": 2,
  "totalPage": 1,
  "items": [
    {
      "id": "611a1e7c6a053300067a88d9",//唯一鍵
      "currency": "USDT", //幣種
      "amount": "10.00059547", //資金變動值
      "fee": "0", //充值或提現費率
      "balance": "0", //金額變動
      "accountType": "MAIN", //賬戶類型
      "bizType": "Loans Repaid", //業務類型
      "direction": "in", //出入賬方向入賬或出賬（in or out）
      "createdAt": 1629101692950, //創建時間
      "context": "{\"borrowerUserId\":\"601ad03e50dc810006d242ea\",\"loanRepayDetailNo\":\"611a1e7cc913d000066cf7ec\"}" //Business core parameters
    },
    {
      "id": "611a18bc6a0533000671e1bf",
      "currency": "USDT",
      "amount": "10.00059547",
      "fee": "0",
      "balance": "0",
      "accountType": "MAIN",
      "bizType": "Loans Repaid",
      "direction": "in",
      "createdAt": 1629100220843,
      "context": "{\"borrowerUserId\":\"5e3f4623dbf52d000800292f\",\"loanRepayDetailNo\":\"611a18bc7255c200063ea545\"}"// 業務核心參數
    }
  ]
}

API權限

此接口需要通用權限

請求URL

此接口支持現貨URL

頻率限制

管理类权重：2

TIP

這個接口需要使用分頁

請求參數

請求參數	類型	是否必須	含義
currency	String	否	幣種，選填，可多選，以逗號分隔，最多支持選擇10個幣種，若不填寫，默認查詢所有幣種
direction	String	否	出入賬方向: in -入賬, out -出賬
bizType	String	否	業務類型: DEPOSIT -充值, WITHDRAW -提現, TRANSFER -轉賬, SUB_TRANSFER -子賬戶轉賬,TRADE_EXCHANGE -交易, MARGIN_EXCHANGE -槓桿交易, KUCOIN_BONUS -鼓勵金, BROKER_TRANSFER -Broker劃轉記錄
startAt	long	否	開始時間（毫秒）
endAt	long	否	截止時間（毫秒）

TIP

您只能獲取 24 小時時間範圍內的數據（即：查詢時，開始時間到結束時間的時間範圍不能超過24小時）。若超出時間範圍，系統會報錯。如果您只指定了結束時間，沒有指定開始時間，系統將按照24小時的範圍自動計算開始時間（開始時間=結束時間-24小時）並返回相應數據，反之亦然。

TIP

最多獲取1年的歷史數據，如需要獲取更久遠的歷史數據，請提交工單查詢：https://kucoin.zendesk.com/hc/en-us/requests/new

返回值

字段	含義
id	唯一鍵
currency	幣種
amount	資金變動值
fee	充值或提現費率
balance	變動後的資金總額
accountType	母賬號賬戶類型MAIN、TRADE、MARGIN或CONTRACT
bizType	業務類型，比如交易，提現，推薦關係獎，借貸等
direction	出入賬方向 out 或 in
createdAt	創建時間
context	業務核心參數

context

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

BizType 含義

字段	含義
Assets Transferred in After Upgrading	從V1遷入V2時系統升級轉入
Deposit	獲取充值入賬記錄
Withdrawal	獲取提現記錄
Transfer	獲取資金劃轉記錄
Trade_Exchange	獲取幣幣交易記錄
Vote for Coin	投票上幣分發資產
KuCoin Bonus	獲取鼓勵金入賬記錄
Referral Bonus	獲取邀請獎勵入賬記錄
Rewards	一些活動發獎記錄
Distribution	持幣分發，持有NEO 獲得GAS 等資產分發記錄
Airdrop/Fork	某些代幣的空投活動，比如持有BTC空投KCS
Other rewards	其他獎勵，除持幣分發、空投、分叉之外的其他活動獎勵
Fee Rebate	手續費返傭，負手續費獲得的手續費返傭
Buy Crypto	使用信用卡購買資產
Sell Crypto	使用信用卡出售資產
Public Offering Purchase	Spotlight活動公開發行某些資產
Send red envelope	發送紅包
Open red envelope	領取紅包
Staking	Staking鎖倉
LockDrop Vesting	進行Lockdrop認購
Staking Profits	Staking收益
Redemption	贖回資產
Refunded Fees	KCS抵扣
KCS Pay Fees	KCS抵扣
Margin Trade	槓桿交易
Loans	槓桿借出
Borrowings	槓桿借入
Debt Repayment	槓桿還款
Loans Repaid	槓桿收款
Lendings	借貸
Pool transactions	Pool-X交易
Instant Exchange	閃兌交易
Sub Account Transfer	子母賬戶轉賬
Liquidation Fees	爆倉手續費
Soft Staking Profits	獲取Soft Staking收益
Voting Earnings	Pool-X獲取投票收益
Redemption of Voting	Pool-X投票贖回資產
Convert to KCS	一鍵轉KCS
BROKER_TRANSFER	Broker劃轉記錄