# 查询账户资金

# accinfo_query

accinfo_query(trd_env=TrdEnv.REAL, acc_id=0, acc_index=0, refresh_cache=False, currency=Currency.HKD)

  • 介绍

    查询交易业务账户的资产净值、证券市值、现金、购买力等资金数据。

  • 参数

    参数 类型 说明
    trd_env TrdEnv 交易环境
    acc_id int 交易业务账户 ID
    acc_index int 交易业务账户列表中的账户序号
    refresh_cache bool 是否刷新缓存
    currency Currency 资金的展示货币
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK 时,返回资金数据
    str 当 ret != RET_OK 时,返回错误描述
    • 资金数据格式如下:
      字段 类型 说明
      power float 最大购买力
      max_power_short float 卖空购买力
      net_cash_power float 现金购买力
      total_assets float 资产净值
      cash float 现金
      market_val float 证券市值
      long_mv float 多头市值
      short_mv float 空头市值
      pending_asset float 在途资产
      interest_charged_amount float 计息金额
      frozen_cash float 冻结资金
      avl_withdrawal_cash float 现金可提
      max_withdrawal float 最大可提
      currency Currency 本次查询所用币种
      available_funds float 可用资金
      unrealized_pl float 未实现盈亏
      realized_pl float 已实现盈亏
      risk_level CltRiskLevel 风控状态
      risk_status CltRiskStatus 风险状态
      initial_margin float 初始保证金
      margin_call_margin float Margin Call 保证金
      maintenance_margin float 维持保证金
      hk_cash float 港元现金
      hk_avl_withdrawal_cash float 港元可提
      us_cash float 美元现金
      us_avl_withdrawal_cash float 美元可提
      jp_cash float 日元现金
      jp_avl_withdrawal_cash float 日元可提
      pdt_seq string 剩余日内交易次数
      is_pdt bool 是否为 PDT 账户
      beginning_dtbp float 初始日内交易购买力
      remaining_dtbp float 剩余日内交易购买力
      dt_call_amount float 日内交易待缴金额
      dt_status DtStatus 日内交易限制情况
      cn_cash float 人民币现金
      cn_avl_withdrawal_cash float 人民币可提
      sg_cash float 新元现金
      sg_avl_withdrawal_cash float 新元可提
  • Example

from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
ret, data = trd_ctx.accinfo_query()
if ret == RET_OK:
    print(data)
    print(data['power'][0])  # 取第一行的购买力
    print(data['power'].values.tolist())  # 转为 list
else:
    print('accinfo_query error: ', data)
trd_ctx.close()  # 关闭当条连接
1
2
3
4
5
6
7
8
9
10
  • Output
     power  max_power_short  net_cash_power  total_assets     cash  market_val  long_mv  short_mv  pending_asset  interest_charged_amount  frozen_cash  avl_withdrawal_cash  max_withdrawal currency available_funds unrealized_pl realized_pl risk_level risk_status  initial_margin  margin_call_margin  maintenance_margin hk_cash hk_avl_withdrawal_cash us_cash us_avl_withdrawal_cash
0  55926.96          46605.8         5880.48      50080.48  5880.48     44200.0  44200.0       0.0            0.0                      0.0          0.0              5880.48        25755.18      N/A             N/A           N/A         N/A        N/A      LEVEL2         22083.0             19874.7             15458.1     N/A                    N/A     N/A                    N/A
55926.96
[55926.96]
1
2
3
4

接口限制

  • 每 30 秒内最多请求 10 次查询账户资金接口
  • 调用此接口,只有在刷新缓存时,才受到限频限制