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

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

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 -鼓勵金
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 出入賬方向 outin
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