ptrade 平台 get_snapshot 获取的快照数据包含哪些字段？

在 ptrade 量化交易平台中，get_snapshot(security) 接口用于获取指定标的的实时行情快照。该接口返回一个嵌套字典，外层 key 为股票代码，内层字典包含了丰富的行情字段。

以下是 get_snapshot 返回字典中包含的主要字段及其具体含义：

基础行情字段

• prod_code: 证券代码 (str)
• last_px: 最新成交价 (float)
• open_px: 今开盘价 (float)
• high_px: 最高价 (float)
• low_px: 最低价 (float)
• preclose_px: 昨收价 (float)
• up_px: 涨停价格 (float)
• down_px: 跌停价格 (float)
• wavg_px: 加权平均价 (float)
• px_change_rate: 涨跌幅 (float)

成交与持仓字段

• business_amount: 总成交量 (int)
• business_balance: 总成交额 (float)
• business_amount_in: 内盘成交量 (int)
• business_amount_out: 外盘成交量 (int)
• amount: 持仓量 (int)
• turnover_ratio: 换手率 (float)
• vol_ratio: 量比 (float)

盘口委托字段

• bid_grp: 委买档位 (dict)。格式如 {'bid_grp': {1: [价格, 委托量, 委托笔数, 委托队列{}], 2: [价格, 委托量, 委托笔数], ...}}。第一档在开通 L2 行情时包含委托队列。
• offer_grp: 委卖档位 (dict)。格式同 bid_grp。
• total_bidqty: 委买量 (int)
• total_offerqty: 委卖量 (int)
• total_bid_turnover: 委买金额 (int) 注：主推数据中不支持，仅在线请求支持
• total_offer_turnover: 委卖金额 (int) 注：主推数据中不支持，仅在线请求支持
• entrust_rate: 委比 (float)
• entrust_diff: 委差 (float)

财务与基本面字段

• pe_rate: 动态市盈率 (float)
• pb_rate: 市净率 (float)
• circulation_amount: 流通股本 (int)
• issue_date: 上市日期 (int)

状态与时间字段

• hsTimeStamp: 时间戳 (float)，格式如 20220617132109340
• trade_status: 交易状态 (str)。常见状态包括：
  • START: 市场启动
  • PRETR: 盘前
  • OCALL: 开始集合竞价
  • TRADE: 交易(连续撮合)
  • HALT: 暂停交易
  • SUSP: 停盘
  • BREAK: 休市
  • ENDTR: 交易结束
• prev_settlement: 昨结算 (float) 主要用于期货

⚠️ 注意事项

1. 盘前调用：如果在盘前阶段（如 before_trading_start 函数中）调用 get_snapshot，返回的数据中大部分字段（如成交量、当前价格、换手率等）可能为 0。
2. L2 行情依赖：bid_grp 和 offer_grp 中的第一档委托队列明细需要开通 Level-2 行情权限才能获取。