# 查询持仓

position_list_query(code='', position_market=TrdMarket.NONE, pl_ratio_min=None, pl_ratio_max=None, trd_env=TrdEnv.REAL, acc_id=0, acc_index=0, refresh_cache=False)

  • 介绍

    查询交易业务账户的持仓列表

  • 参数

    参数 类型 说明
    code str 代码过滤
    position_market TrdMarket 持仓所属市场过滤
    pl_ratio_min float 当前盈亏比例下限过滤,仅返回高于此比例的持仓
    pl_ratio_max float 当前盈亏比例上限过滤,低于此比例的会返回
    trd_env TrdEnv 交易环境
    acc_id int 交易业务账户 ID
    acc_index int 交易业务账户列表中的账户序号
    refresh_cache bool 是否刷新缓存
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK 时,返回持仓列表
    str 当 ret != RET_OK 时,返回错误描述
    • 持仓列表
      字段 类型 说明
      position_side PositionSide 持仓方向
      code str 股票代码
      stock_name str 股票名称
      position_market TrdMarket 持仓所属市场
      qty float 持有数量
      can_sell_qty float 可用数量
      currency Currency 交易货币
      nominal_price float 市价
      cost_price float 摊薄成本价(证券账户),平均开仓价(期货账户)
      cost_price_valid bool 成本价是否有效
      average_cost float 平均成本价
      diluted_cost float 摊薄成本价
      market_val float 市值
      pl_ratio float 盈亏比例(摊薄成本价模式)
      pl_ratio_valid bool 盈亏比例是否有效
      pl_ratio_avg_cost float 盈亏比例(平均成本价模式)
      pl_val float 盈亏金额
      pl_val_valid bool 盈亏金额是否有效
      today_pl_val float 今日盈亏金额
      today_trd_val float 今日交易金额
      today_buy_qty float 今日买入总量
      today_buy_val float 今日买入总额
      today_sell_qty float 今日卖出总量
      today_sell_val float 今日卖出总额
      unrealized_pl float 未实现盈亏
      realized_pl 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.position_list_query()
if ret == RET_OK:
    print(data)
    if data.shape[0] > 0:  # 如果持仓列表不为空
        print(data['stock_name'][0])  # 获取持仓第一个股票名称
        print(data['stock_name'].values.tolist())  # 转为 list
else:
    print('position_list_query error: ', data)
trd_ctx.close()  # 关闭当条连接
1
2
3
4
5
6
7
8
9
10
11
  • Output
       code stock_name position_market    qty  can_sell_qty  cost_price  cost_price_valid average_cost  diluted_cost  market_val  nominal_price  pl_ratio  pl_ratio_valid pl_ratio_avg_cost  pl_val  pl_val_valid today_buy_qty today_buy_val today_pl_val today_trd_val today_sell_qty today_sell_val position_side unrealized_pl realized_pl currency
0  HK.01810     小米集团-W              HK  400.0         400.0      53.975              True          53.975        53.975     19820.0          49.55  -8.19824            True            -8.19824    -1770.0          True           0.0           0.0          0.0           0.0            0.0            0.0          LONG           0.0         0.0      HKD
小米集团-W
['小米集团-W']
1
2
3
4

接口限制

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