pytdx获取5档数据

pytdx.get_security_quotes() 返回数据说明文档
概述

pytdx.hq.TdxHq_API().get_security_quotes(stocks) 是通达信行情接口中用于批量获取股票 五档快照（Level-1）行情 的核心函数。
它返回一个 list，其中每个元素是一个 dict，包含对应股票的完整实时行情字段。

数据结构总览
返回类型：List[Dict[str, Any]]
列表顺序：与输入 stocks 列表一一对应
字段数量：约 40 个字段，部分为保留字段（以 reversed_bytes 命名），实际有效字段约 30 个

字段详解（按功能分类）

1. 基础标识信息

字段 类型 说明

market int 市场代码：0=深圳，1=上海
code str 股票代码，如 ‘000001’

1. 价格类字段（单位：元）

字段 说明

price 最新成交价
last_close 昨日收盘价
open 今日开盘价
high 今日最高价
low 今日最低价
✅ 示例：price=11.5 表示当前最新成交价为 11.50 元

1. 成交量与成交额

字段 类型 说明

vol int 累计成交量（单位：手，1 手 = 100 股）
cur_vol int 最新一笔成交量（单位：手）
amount float 累计成交额（单位：元）
s_vol int 内盘（主动卖出成交量，单位：手）
b_vol int 外盘（主动买入成交量，单位：手）
💡 内盘 + 外盘 ≈ 总成交量（可能因时间差略有差异）

1. 五档买卖盘（Level-1）

字段 说明

bid1 ~ bid5 买一至买五价格
ask1 ~ ask5 卖一至卖五价格
bid_vol1 ~ bid_vol5 买一至买五挂单量（单位：手）
ask_vol1 ~ ask_vol5 卖一至卖五挂单量（单位：手）
📌 注意：买价 ≤ 卖价，且 bid1 <= bid2 <= …（价格递减），ask1 >= ask2 >= …（价格递增）

1. 时间信息

字段 类型 说明

servertime str 服务器时间，格式：HHSS.mmm（如 ‘13:48:23.706’）
⏰ 该时间为行情服务器本地时间，可用于判断行情延迟

1. 保留/未公开字段（通常可忽略）

以下字段为通达信协议中的保留字段或内部字段，含义不公开或不稳定，建议不要依赖：

字段 示例值 说明

reversed_bytes0 ~ reversed_bytes9 13483951, (4300,), -0.08 等 协议保留字段，可能包含内部状态、扩展数据等
active1, active2 3295, 2133 可能与活跃度、订单流相关，但无官方文档说明
⚠️ 这些字段在不同版本、不同服务器上可能变化，不建议用于生产逻辑

示例解读（以 000001 为例）

python
{
‘market’: 0,
‘code’: ‘000001’,
‘price’: 11.5,
‘last_close’: 11.55,
‘open’: 11.55,
‘high’: 11.58,
‘low’: 11.46,
‘vol’: 761778, # 已成交 761,778 手（约 7.6 亿股）
‘amount’: 876330880.0, # 成交额约 8.76 亿元
‘s_vol’: 482775, # 内盘（主动卖）48.2 万手
‘b_vol’: 279004, # 外盘（主动买）27.9 万手
‘bid1’: 11.49, ‘bid_vol1’: 1725,
‘ask1’: 11.5, ‘ask_vol1’: 2840,
…
‘servertime’: ‘13:48:23.706’
}
当前股价 下跌：11.50 < 昨收 11.55（跌 0.05 元）
卖盘压力略大：内盘 > 外盘（48.2万 > 27.9万）
买一价 11.49，卖一价 11.50，价差 0.01 元（最小变动单位）

使用建议

1. 重点关注字段：price, last_close, vol, amount, bid1/ask1, bid_vol1/ask_vol1
2. 避免使用：所有 reversed_bytes 和 active* 字段（除非你有逆向工程依据）
3. 注意单位：
   成交量 vol 是 手（非股数）
   成交额 amount 是 元
4. 空值处理：若某股票无行情（如停牌），对应 quote 可能为 None

附：字段映射速查表

中文名 字段名

股票代码 code
市场 market
最新价 price
昨收 last_close
开盘价 open
最高价 high
最低价 low
成交量（手） vol
成交额（元） amount
内盘 s_vol
外盘 b_vol
买一价 bid1
卖一价 ask1
买一量 bid_vol1
卖一量 ask_vol1
服务器时间 servertime

文档基于 pytdx 实际返回数据整理，适用于 v1.7+ 版本。如有协议变更，请以最新源码为准。