在 PTrade 量化交易中，持仓信息是策略调仓、盈亏核算、风险控制的核心依据。很多用户在实操中会困惑：“如何精准获取持仓数据？单只标的、多只标的还有全账户持仓，该用哪个接口？” 其实答案很明确，PTrade 提供了 get_position、get_positions、get_all_positions 三个专属接口，覆盖从单只到全账户的所有持仓查询需求，今天就手把手教你用对、用透！

精准查单只
如果想知道某一只特定股票的详细持仓信息，get_position 接口是首选，传入股票代码即可直接返回对应持仓对象，信息精准且调用便捷。

• 核心用法 示例代码
  接口仅需一个参数 —— 带市场尾缀的股票代码（如 SS/SZ），返回的 Position 对象包含该股票的持仓数量、成本价、盈亏等完整信息，可直接提取字段使用。

批量查多只
做组合策略时，常需要同时查询多只股票的持仓，或一次性获取账户内所有持仓，get_positions 接口正好满足这一需求，支持指定股票列表和全量查询两种模式。

• 核心用法 示例代码该接口灵活度高，传入列表可查指定多只股票，不传参数则默认返回账户内所有持仓，返回结果为字典格式，键是股票代码，值是对应的 Position 对象。1、查询指定多只股票持仓def handle_data(context, data): # 定义需要查询的多只股票列表 multi_stocks = ['600570.SS', '600000.SS', '000001.SZ'] # 获取指定多只股票的持仓 positions = get_positions(multi_stocks) # 遍历字典，解析每只股票的持仓 for code, pos in positions.items(): log.info(f"{code}：持仓量{pos.amount}，成本价{pos.cost_basis}，最新价{pos.lastsaleprice}") 2、查询账户内所有持仓def handle_data(context, data): # 不传参数，获取账户内所有持仓 all_positions = get_positions() # 遍历所有持仓 if all_positions: log.info("账户全部持仓：") for code, pos in all_positions.items(): log.info(f"股票{code}：持仓量{pos.amount}，多头盈亏{pos.long_pnl}")

全量查账户
如果需要获取账户内不同交易品种（如股票、ETF、可转债等）的完整持仓信息，get_all_positions 接口是最优选择，不过要注意它仅在交易模块可用。

• 核心用法 示例代码
  该接口无需传入参数，返回当前账户所有持仓的列表，包含不同业务类型的持仓细节，适合做全账户持仓汇总和分析。

持仓字段说明
三个接口返回的 Position 对象包含统一的核心字段，搞懂这些字段才能精准提取数据，满足策略需求：

这些字段覆盖了持仓状态、成本、收益等关键维度，无论是做持仓监控还是策略决策，都能从中提取所需数据。

注意事项 ️

• 模块使用限制：get_position 和 get_positions 接口兼容性强，在回测和交易模块均可使用；而 get_all_positions 接口仅在交易模块，回测场景调用会报错，需提前区分使用场景。
• 柜台字段差异：不同券商柜台返回的持仓字段可能存在细微差异，比如部分柜台可能不返回手续费字段，部分字段名称略有不同，建议在策略中添加字段判断，做兼容处理。
• 缓存数据提示：get_all_positions 返回的是账户同步的缓存数据，并非实时数据，若需获取毫秒级实时持仓，建议结合委托成交回调函数辅助判断。

不同场景选接口？

• 回测场景：优先用 get_position（单只）和 get_positions（多只 / 全部），满足回测中持仓分析、盈亏计算的需求；
• 实盘交易场景：单只股票查询用 get_position，组合股票监控用 get_positions，全账户多品种汇总用 get_all_positions；
• 高频交易场景：建议用 get_position 和 get_positions 结合委托成交回调函数，兼顾实时性和数据精准度。

想了解如何结合持仓信息做自动调仓策略，或有其他接口使用疑问，欢迎在评论区留言！ 关注我，持续解锁 PTrade 实操技巧～

（注：点我红色头像旁边有个咨询TA，加我微或者电话联系我开户）