# 口座キャッシュフローの照会

get_acc_cash_flow(clearing_date='', trd_env=TrdEnv.REAL, acc_id=0, acc_index=0, cashflow_direction=CashFlowDirection.NONE)

  • 概要

    取引口座の指定日付における現金フローデータを照会します。入出金、振替、通貨両替、金融資産の売買、信用買い・信用売り利息など、現金変動が発生するすべての取引を含みます。

  • パラメータ

    パラメータ 説明
    clearing_date str 清算日付
    trd_env TrdEnv 取引環境
    acc_id int 取引口座 ID
    acc_index int 取引口座リスト内の口座インデックス
    cashflow_direction CashFlowDirection キャッシュフロー方向フィルタ
  • 戻り値

    パラメータ 説明
    ret RET_CODE API呼び出し結果
    data pd.DataFrame 当 ret == RET_OK 时,返す取引口座現金フローリスト形式
    str 当 ret != RET_OK 时,返すエラー説明
    • 取引口座現金フローリストフォーマットは以下の通り:
      フィールド タイプ 説明
      cashflow_id int 現金流唯一識別子
      clearing_date str 清算日付
      settlement_date str 交收日付
      currency Currency 币种
      cashflow_type str 現金流タイプ
      cashflow_direction CashFlowDirection キャッシュフロー方向
      cashflow_amount float 金額(正数は流入、負数は流出を示します)
      cashflow_remark str 備考
  • Example

from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.US, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUINC)
ret, data = trd_ctx.get_acc_cash_flow(clearing_date='2025-02-18', trd_env=TrdEnv.REAL, acc_id=0, acc_index=0, cashflow_direction=CashFlowDirection.NONE)
if ret == RET_OK:
    print(data)
    if data.shape[0] > 0:  # 現金フローリストが空でない場合
        print(data['cashflow_type'][0])  # 最初のフローの現金フロータイプを取得
        print(data['cashflow_amount'].values.tolist())  # list に変換
else:
    print('get_acc_cash_flow error: ', data)
trd_ctx.close()

1
2
3
4
5
6
7
8
9
10
11
12
  • Output
   cashflow_id     clearing_date     settlement_date     currency     cashflow_type     cashflow_direction     cashflow_amount     cashflow_remark
0  16308           2025-02-27        2025-02-28          HKD             其他                 N/A                   0.00      Opt ASS-P-JXC250227P13000-20250227
1  16357           2025-02-27        2025-03-03          HKD             其他                 OUT               -104000.00
2  16360           2025-02-27        2025-02-27          USD            基金赎回               IN                 23000.00     Fund Redemption#Taikang Kaitai US Dollar Money...
3  16384           2025-02-27        2025-02-27          HKD            基金赎回               IN                104108.96     Fund Redemption#Taikang Kaitai Hong Kong Dolla...
其他
[0.00, -104000.00, 23000.00, 104108.96]
1
2
3
4
5
6
7

APIレート制限

  • 同一口座ID(acc_id) 每 30 秒内最多リクエスト 20 次現金フローAPI。
  • 現金フローは時刻の「昇順」で並べられます。
  • デモ取引および moomoo US 口座は現在、現金フローの照会に対応していません。