獲取資金流水

GET /api/v1.0/accounts/{acc_id}/cash_logs

查詢指定交易賬戶的資金流水記錄，支持按時間範圍、流水方向、標的進行過濾，並支持分頁查詢。

路徑參數

參數	類型	必填	說明
acc_id	string	是	業務賬戶 ID。

請求參數

參數	類型	位置	必填	說明
begin_time	uint64	查詢	是	查詢開始時間，Unix 時間戳（微秒）。
end_time	uint64	查詢	是	查詢結束時間，Unix 時間戳（微秒）。需大於等於 begin_time。
direction	direction	查詢	否	流水方向過濾。IN：流入；OUT：流出。不傳時返回全部方向。
code	string	查詢	否	標的代碼，格式：market.symbol，例如 US.AAPL、HK.00700。不傳時返回所有標的的流水。
page_flag	string	查詢	否	分頁游標。首次請求不傳，後續請求傳入上一次響應中的 page_flag。
page_size	uint32	查詢	否	每頁條數。不傳默認 10；傳入時不得超過 20。

請求示例

curl -X GET 'https://webapi.futunn.com/api/v1.0/accounts/{acc_id}/cash_logs?begin_time=1709251200000000&end_time=1709337600000000&direction=IN&page_size=10' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

字段	類型	說明
cash_logs	list[cash_log]	資金流水列表。
page_flag	string	下一頁游標。傳入下次請求的 page_flag 參數以獲取後續數據。
completed	bool	是否已返回全部數據。true 表示無更多數據。

響應示例

{
  "s": "ok",
  "d": {
    "cash_logs": [
      {
        "transaction_name": "股票賣出成交",
        "created_time": "03/01/2024 10:30:00",
        "cash_change": "18000.00",
        "balance": "25000.00",
        "symbol": "AAPL",
        "stock_name": "AAPL Apple Inc."
      },
      {
        "transaction_name": "股票買入成交",
        "created_time": "03/01/2024 09:45:00",
        "cash_change": "-18000.00",
        "balance": "7000.00",
        "symbol": "AAPL",
        "stock_name": "AAPL Apple Inc."
      }
    ],
    "page_flag": "a1b2c3d4e5f6",
    "completed": false
  }
}