KUCOIN API
主頁更新日誌API DOC V1
語言
  • English
主頁更新日誌API DOC V1
語言
  • English
SDK
Telegram
Kucoin
  1. 帳戶與資金
  • 簡介
  • 驗證
  • 枚舉定義
  • 術語定義
  • SDK
  • 速率限制
  • 更新日誌
  • 用戶服務
    • 做市獎勵計劃
    • 貴賓快速通道
    • 經紀商計劃
  • 統一REST
    • 介紹
    • 市場數據
      • 取得公告
      • 取得幣種列表
      • 取得交易對詳情
      • 取得行情
      • 取得訂單簿
      • 取得最近交易歷史
      • 取得K線數據
      • 取得目前資金費率
      • 取得歷史資金費率
      • 取得全倉保證金配置
      • 取得服務器狀態
  • 統一Websocket
    • 基礎資訊
      • 簡介
    • 新增/撤銷 訂單
      • 新增訂單
      • 撤銷訂單
  • 經典REST
    • 帳戶資訊
      • 帳戶與資金
        • 取得帳戶摘要資訊
          GET
        • 取得KYC區域信息
          GET
        • 取得 Apikey 資訊
          GET
        • 取得帳戶類型-幣幣
          GET
        • 取得帳戶清單- 幣幣
          GET
        • 取得帳戶詳細資料- 幣幣
          GET
        • 取得帳戶- 全倉
          GET
        • 取得帳戶- 逐倉槓桿
          GET
        • 取得帳戶- 合約
          GET
        • 取得流水記錄- 幣幣/保證金
          GET
        • 取得流水記錄- 現貨高頻
          GET
        • 取得流水記錄- 槓桿高頻
          GET
        • 取得流水記錄- 合約
          GET
      • 子帳戶
        • 新增子帳戶
        • 新增子帳戶保證金權限
        • 新增子帳戶合約權限
        • 取得所有子帳戶信息
        • 取得單個子賬戶資產信息
        • 取得子帳戶清單- 幣幣餘額 (V2)
        • 取得子帳戶清單- 合約餘額 (V2)
      • 子帳戶 API
        • 取得子帳戶API列表
        • 新增子帳戶 API
        • 修改子帳戶 API
        • 刪除子帳戶 API
      • 存款
        • 新增存款地址 (V3)
        • 取得存款地址 (V3)
        • 取得存款記錄
      • 提款
        • 取得提款額度
        • 提款 (V3)
        • 取消提款
        • 取得提款紀錄
        • 按 ID 取得提款紀錄
      • 轉移
        • 取得轉移配額
        • 萬向劃轉
      • 交易費用
        • 取得基本費用- 幣幣/保證金
        • 取得實際費用- 幣幣/保證金
        • 取得實際費用- 合約
    • 幣幣交易
      • 市場數據
        • 取得公告
        • 取得幣種列表
        • 取得所有幣種詳情
        • 取得交易對詳情
        • 取得所有交易對詳情
        • 取得行情
        • 取得全部行情
        • 取得交易歷史
        • 取得K線數據
        • 取得部分訂單簿
        • 取得完整訂單簿
        • 取得集合競價部分訂單簿
        • 取得集合競價資訊
        • 取得法幣換算價格
        • 取得 24 小時統計資料
        • 取得市場清單
        • 取得用戶端 IP 位址
        • 取得伺服器時間
        • 取得服務狀態
      • 訂單
        • 新增訂單
        • 新增訂單同步
        • 新增訂單測試
        • 批次新增訂單
        • 批次新增訂單同步
        • 按 OrderId 取消訂單
        • 按 OrderId 取消訂單同步
        • 按 ClientOid 取消訂單
        • 按 clientOid 取消訂單同步
        • 取消部分訂單
        • 按交易對取消所有訂單
        • 取消所有訂單
        • 修改訂單
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 取得活躍訂單的交易對
        • 取得活躍訂單
        • 按頁面取得開放訂單
        • 取得已完成訂單
        • 取得交易歷史
        • 取得 DCP
        • 設定 DCP
        • 新增止損單
        • 按 ClientOid 取消止損單
        • 按 OrderId 取消止損單
        • 批次取消止損單
        • 取得止損單清單
        • 按 OrderId 取得止損單
        • 按 ClientOid 取得止損單
        • 新增 OCO 訂單
        • 按 OrderId 取消 OCO 訂單
        • 按 ClientOid 取消 OCO 訂單
        • 批次取消 OCO 訂單
        • 按 OrderId 取得 OCO 訂單
        • 按 ClientOid 取得 OCO 訂單
        • 按 OrderId 取得 OCO 訂單的詳細資料
        • 取得 OCO 訂單清單
    • 槓桿交易
      • 市場數據
        • 取得交易對 - 全倉槓桿
        • 取得交易對 - 逐倉槓桿
        • 取得 ETF 資訊
        • 獲取標記價格詳情
        • 取得保證金配置
        • 取得標記價格價目表
        • 查詢槓桿幣種階梯質押率
        • 查詢平台可借入數量
      • 訂單
        • 新增訂單
        • 新增訂單測試
        • 按 OrderId 取消訂單
        • 按 ClientOid 取消訂單
        • 按交易對取消所有訂單
        • 取得開放訂單的交易對
        • 取得開放訂單
        • 取得已結束訂單
        • 取得交易歷史
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 新增止損單
        • 按 OrderId 取消止損單
        • 按 ClientOid 取消止損單
        • 批次取消止損單
        • 取得止損單清單
        • 按 OrderId 取得止損單
        • 按 ClientOid 取得止損單
        • 新增 OCO 訂單
        • 按 OrderId 取消 OCO 訂單
        • 按 ClientOid 取消 OCO訂單
        • 批次取消 OCO 訂單
        • 按 OrderId 取得 OCO 訂單
        • 按 ClientOid 取得 OCO 訂單
        • 按 OrderId 取得 OCO 訂單的詳細資料
        • 取得 OCO 訂單清單
      • 借記
        • 取得借貸利率
        • 借幣
        • 取得借貸記錄
        • 還幣
        • 取得還幣記錄
        • 取得利息記錄
        • 修改槓桿
      • 信貸
        • 取得貸款市場
        • 取得貸款市場利率
        • 購買
        • 修改購買
        • 取得購買訂單
        • 贖回
        • 取得贖回訂單
      • 風險上限
        • 取得保證金風險限額
    • 合約交易
      • 簡介
      • 市場數據
        • 取得交易對詳情
        • 取得所有交易對詳情
        • 取得行情
        • 取得全合約最新行情
        • 取得完整買賣盤
        • 取得部分買賣盤
        • 取得交易歷史
        • 取得K線數據
        • 獲取標記價格
        • 取得幣幣指數價格
        • 取得利率指數
        • 取得溢價指數
        • 取得 24 小時統計資料
        • 取得伺服器時間
        • 取得服務狀態
      • 訂單
        • 新增訂單
        • 新增訂單測試
        • 批次新增訂單
        • 新增獲利止損單
        • 按 OrderId 取消訂單
        • 按 ClientOid 取消訂單
        • 批次取消訂單
        • 取消所有訂單
        • 取消所有止損單
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 取得訂單清單
        • 取得最近的已結訂單
        • 取得止損單清單
        • 取得開放訂單總價值
        • 取得最近的交易歷史
        • 取得交易歷史
      • 倉位
        • 取得槓桿模式
        • 切換槓桿模式
        • 批量切換槓桿模式
        • 取得倉位模式
        • 切換持倉模式
        • 取得最大可開倉量
        • 取得倉位詳情
        • 取得倉位列表
        • 取得持倉歷史
        • 取得最大可提取保證金
        • 取得全倉槓桿
        • 修改全倉槓桿
        • 新增逐倉槓桿
        • 移除逐倉槓桿
        • 取得全倉槓桿風險限額
        • 獲取全倉保證金要求
        • 取得逐倉槓桿風險限額
        • 修改逐倉槓桿風險限額
      • 資金費用
        • 取得目前資金費率
        • 取得歷史資金費率
        • 取得私人資金費用歷史記錄
    • 賺幣
      • 簡單賺幣
        • 購買
        • 取得贖回預覽
        • 贖回
        • 獲取餘幣寶產品
        • 獲取促銷產品
        • 取得質押產品
        • 取得 KCS 質押產品
        • 取得 ETH 質押產品
        • 取得帳戶持有
      • 結構性產品
        • 結構化產品購買
        • 獲取雙幣盈產品清單
        • 獲取結構化產品訂單
    • VIP 借貸
      • 簡介
      • 取得抵押率
      • 取得貸款資訊
      • 取得帳戶
    • 合夥人
      • 簡介
      • 取得邀請
      • 取得佣金
      • 取得歷史交易
      • 取得交易紀錄
      • 取得Kumining交易明細
    • 經紀商
      • 簡介
      • 經紀商申請
      • 說明
      • API 經紀商
        • 簡介
        • Fast API服務
        • 取得經紀返傭
        • 查詢我的傭金
        • 查詢用戶列表
        • 查詢用戶交易明細
      • 交易所經紀商
        • 簡介
        • 提交 KYC
        • 取得 KYC 狀態
        • 取得 KYC 狀態列表
        • 取得經紀資訊
        • 新增子帳戶
        • 取得子帳戶
        • 新增子帳戶 API
        • 取得子帳戶 API
        • 修改子帳戶 API
        • 刪除子帳戶 API
        • 轉移
        • 取得轉移記錄
        • 取得存款清單
        • 取得存款明細
        • 取得提款明細
        • 取得經紀返傭
    • 跟單交易
      • 簡介
      • 新增訂單
      • 新增訂單測試
      • 新增獲利止損單
      • 按 OrderId 取消訂單
      • 按 ClientOid 取消訂單
      • 取得最大可開倉量
      • 取得最大可提取保證金
      • 新增逐倉槓桿
      • 移除逐倉槓桿
      • 修改逐倉槓桿風險限額
      • 修改逐倉槓桿自動存款狀態
      • 切換槓桿模式
      • 修改全倉槓桿
      • 獲取全倉保證金要求
      • 切換持倉模式
    • 閃兌
      • 簡介
      • 查詢閃兌交易對
      • 查詢閃兌幣種列表
      • 查詢閃兌市價單價格
      • 新增閃兌市價單
      • 查詢閃兌市價單訂單詳情
      • 查詢閃兌市價單訂單歷史
      • 查詢閃兌限價單保護價格
      • 新增閃兌限價單
      • 取消閃兌限價單
      • 查詢閃兌限價單訂單詳情
      • 查詢閃兌限價單活躍訂單和歷史訂單
  • 經典Websocket
    • 基礎資訊
      • 簡介
      • 取得公開Token- 幣幣/槓桿
      • 取得私人槓桿- 幣幣/槓桿
      • 取得公開Token- 合約
      • 取得私人Token- 合約
    • 幣幣交易
      • 公共頻道
        • Ticker
        • Trade
        • 訂單簿 - Level1
        • 訂單簿 - Level5
        • 訂單簿 - Level50
        • 訂單簿 - Increment
        • 集合競價訂單簿 - Level50
        • K線
        • 交易數據
        • 交易對快照數據
        • 市場快照數據
      • 私人頻道
        • 訂單 V2
        • 訂單 V1
        • 餘額
        • 止損單
    • 槓桿交易
      • 公共頻道
        • 指數價格
        • 標記價格
      • 私人頻道
        • 逐倉杠桿倉位推送
        • 全倉槓桿倉位推送
    • 合約交易
      • 公共頻道
        • 行情數據 V2
        • 行情數據 V1
        • 訂單簿 - Level5
        • 訂單簿 - Level50
        • 訂單簿- 增量
        • K線
        • 交易數據
        • 產品行情數據
        • 資金費率結算
        • 交易對快照
      • 私人頻道
        • 訂單
        • 餘額
        • 持倉
        • 保證金模式
        • 全倉模式杠桿修改推送
        • 止損單生命週期監聽事件
  • 錯誤代碼
    • HTTP
    • 幣幣
    • 槓桿
    • 合約
    • 賺取
    • 經紀
    • 跟單交易
    • Websocket
  • 棄用的接口
    • 簡介
    • 帳戶與資金
      • 取得子帳戶清單- 摘要資訊 (V1)
      • 取得子帳戶清單- 幣幣餘額 (V1)
      • 取得存款地址 (V2)
      • 取得存款地址- V1
      • 子帳戶劃轉
      • 取得存款記錄- 舊
      • 內部劃轉
      • 取得合約帳戶轉出帳簿
      • 取得提款記錄- 舊
      • 合約帳戶轉出
      • 合約帳戶轉入
      • 新增存款地址- V1
      • 取款- V1
    • 幣幣交易
      • 訂單
        • 新增訂單- 舊
        • 新增訂單測試- 舊
        • 批次新增訂單- 舊訂單
        • Cancel Order By OrderId- Old
        • 按 ClientOid 取消訂單 - Old
        • 批次取消訂單- 舊
        • 取得訂單清單- 舊
        • 取得最近訂單清單- 舊
        • 按 OrderId 取得訂單- Old
        • 按客戶代碼取得訂單- Old
        • 獲取交易歷史- 舊
        • 獲取最近的交易歷史- 舊
    • 槓桿交易
      • 取得帳戶詳細資料- 保證金
      • 新增訂單- V1
      • 新增訂單測試- V1
      • 取得帳戶清單- 逐倉槓桿- V1
      • 取得帳戶明細- 逐倉槓桿- V1
    • 合約交易
      • 取得倉位詳情- V1
      • 修改逐倉槓桿自動存款狀態
      • 取消所有訂單- V1
    • 合夥人
      • 取得帳戶
    • 經紀商
      • API經紀商
        • 取得經紀返傭
  • 開發中
    • 簡介
  1. 帳戶與資金

取得流水記錄- 幣幣/保證金

GET
https://api.kucoin.com/api/v1/accounts/ledgers
api-channel:Private
api-permission:General
api-rate-limit-pool:Management
api-rate-limit-weight:2
sdk-service:Account
sdk-method-name:getSpotLedger
sdk-sub-service:Account
說明
此界面適用於您所有帳戶類型的交易紀錄,支援各種貨幣查詢。項目會分頁排序,先顯示最新的項目。請參閱「分頁」一節,以檢索第一頁之後的其他項目。
提示
開始和結束時間範圍不能超過 24 小時。如果指定的時間視窗超出範圍,則會發生錯誤。如果您只指定結束時間,系統會自動將開始時間計算為結束時間減去 24 小時,反之亦然。
提示
支援取得 1 年的歷史資料。如果您需要取得更長的歷史資料,請提交票單: https://kucoin.zendesk.com/hc/en-us/requests/new
內容
如果 bizType 下的回傳值是 "trade exchange",額外的交易資訊(例如訂單 ID、交易 ID、交易對等)會以欄位上下文回傳。
BizType 說明
欄位說明
Assets Transferred in After UpgradingV1 升級至 V2 後轉入的資產
Deposit存款
Withdrawal提款
Transfer轉帳
Trade_Exchange貿易
Vote for Coin投幣
KuCoin BonusKuCoin 獎金
Referral Bonus推薦獎金
Rewards活動獎勵
Distribution分配,如持有 NEO 可獲得 GAS
Airdrop/Fork空投/分叉
Other rewards其他獎勵,投票、空投除外、Fork
Fee Rebate費用回佣
Buy Crypto使用信用卡購買加密貨幣
Sell Crypto使用信用卡出售加密貨幣
Public Offering Purchase公開發行購買 Spotlight
Send red envelope發紅包
Open red envelope打開紅包
Staking質押
LockDrop Vesting鎖定轉歸
Staking Profits鎖定利潤
Redemption贖回
Refunded Fees退回費用
KCS Pay FeesKCS 支付費用
Margin Trade孖展交易
Loans貸款
Borrowings借款
Debt Repayment債務償還
Loans Repaid貸款償還
Lendings貸款
Pool transactionsPool-X 交易
Instant Exchange即時交換
Sub Account Transfer子帳戶劃轉
Liquidation Fees清算費用
Soft Staking Profits軟質抵押收益
Voting Earnings在 Pool-X 上的投票收益
Redemption of Voting贖回 Pool-X 上的投票
Convert to KCS轉換為 KCS
BROKER_TRANSFER經紀人轉帳記錄

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kucoin.com/api/v1/accounts/ledgers?currency=BTC&direction=in&bizType=TRANSFER&startAt=1728663338000&endAt=1728692138000&currentPage=1&pageSize=50'

Responses

🟢200確認
application/json
Body

Examples
{
    "code": "200000",
    "data": {
        "currentPage": 1,
        "pageSize": 50,
        "totalNum": 1,
        "totalPage": 1,
        "items": [
            {
                "id": "265329987780896",
                "currency": "USDT",
                "amount": "0.01",
                "fee": "0",
                "balance": "0",
                "accountType": "TRADE",
                "bizType": "SUB_TRANSFER",
                "direction": "out",
                "createdAt": 1728658481484,
                "context": ""
            }
        ]
    }
}
Modified at 2025-12-11 14:06:42
Previous
取得帳戶- 合約
Next
取得流水記錄- 現貨高頻