按「数据类型」合并同类查询接口:一个数据类型 = 一个方法,跨市场自动选路。 - 28 个统一接口(get_universe/get_quotes/get_bars/get_indicators/get_ticks/ get_minutes/get_f10/get_file/get_boards/get_board_of/get_snapshot 等), 标的统一字符串写法(sz000001 / hk00700 / usAAPL / cffex:IFL0); 同名旧方法不再兼容 (market, code) 元组。 - 旧 51 个按通道/市场分裂的接口:33 个保留为 deprecated 别名(1.0 移除), 18 个同名升级为统一接口。公开方法共 63 个。 - 新增库层标的解析 pytdxdata.symbols;数据模型追加 symbol/name/fields 兜底字段。 - 修复:分页器连接泄漏、日期区间 K线返回 0 条(偏移方向探测)、池子全冷却死等。 - 文档/README/SKILL/llms.txt 全量同步;新增 docs/refactor-audit.md 审查报告。 - 测试 127 个用例全绿(含 tests/test_all_interfaces.py 全 63 方法回归)。
4.3 KiB
枚举速查
!!! danger "先看这里——本项目最容易踩的坑"
通达信的枚举取值完全没有直觉:KlinePeriod.DAY 是 4 不是 0 也不是 3,
ExMarket.HK_MAIN_BOARD 是 31,Market.SZ 是 0。
写死数字几乎必错,请一律使用枚举成员。
from pytdxdata.models import Adjust, ExMarket, KlinePeriod, Market
Market — 普通市场
| 成员 | 值 | 说明 |
|---|---|---|
Market.SZ |
0 |
深圳 |
Market.SH |
1 |
上海 |
Market.BJ |
2 |
北京(北交所) |
!!! warning "代码不唯一"
市场 + 代码才唯一。(SH, "000001") 是上证指数,(SZ, "000001") 是平安银行。
所有接口的第一个参数都是 market,就是为了消歧。
KlinePeriod — K 线周期
| 成员 | 值 | 说明 |
|---|---|---|
KlinePeriod.MIN_5 |
0 |
5 分钟 |
KlinePeriod.MIN_15 |
1 |
15 分钟 |
KlinePeriod.MIN_30 |
2 |
30 分钟 |
KlinePeriod.MIN_60 |
3 |
60 分钟 |
KlinePeriod.DAY |
4 |
日线(最常用) |
KlinePeriod.WEEK |
5 |
周线 |
KlinePeriod.MONTH |
6 |
月线 |
KlinePeriod.MIN_1 |
7 |
1 分钟 |
KlinePeriod.MIN_3 |
8 |
3 分钟 |
KlinePeriod.YEAR |
9 |
年线 |
KlinePeriod.SEASON |
10 |
季线 |
KlinePeriod.YEAR_ALT |
11 |
另一套年线编码 |
取值与通达信协议字节一致(KlineCategory)。附带一个属性:
KlinePeriod.MIN_1.is_minute # True
KlinePeriod.DAY.is_minute # False
!!! warning "MIN_1 会换通道"
MIN_1 被强制路由到 MAC 通道并采用单连接串行分页,
避免并发分页在多服务器深度不一致时产生数据空洞。
详见 通道与数据源。
Adjust — 复权方式
| 成员 | 值 | 说明 |
|---|---|---|
Adjust.NONE |
0 |
不复权(默认) |
Adjust.QFQ |
1 |
前复权 |
Adjust.HFQ |
2 |
后复权 |
adjust != NONE 时 K 线请求会切到 MAC 通道(标准通道不提供复权数据)。
!!! tip "和券商软件对不上,先差这里"
很多券商前端默认前复权,而本包默认 NONE。对比数据前先确认两边复权方式一致。
ExMarket — 扩展市场
港股 / 美股 / 期货 / 期权等走通达信 EX 通道(端口 7727),market 参数传 ExMarket 成员。
常用值速查
| 成员 | 值 | 说明 |
|---|---|---|
ExMarket.SH_STOCK_OPTION |
8 |
沪股票期权 |
ExMarket.SZ_STOCK_OPTION |
9 |
深股票期权 |
ExMarket.ZZ_FUTURES |
28 |
郑商所期货 |
ExMarket.DL_FUTURES |
29 |
大商所期货 |
ExMarket.SH_FUTURES |
30 |
上期所期货 |
ExMarket.HK_MAIN_BOARD |
31 |
港股主板(最常用) |
ExMarket.NEEQ |
44 |
新三板 |
ExMarket.CFFEX_FUTURES |
47 |
中金所期货(股指 / 国债) |
ExMarket.HK_GEM |
48 |
港股创业板 |
ExMarket.GZ_FUTURES |
66 |
广期所期货 |
ExMarket.GE_STOCK |
73 |
德国股票 |
ExMarket.US_STOCK |
74 |
美股(最常用) |
from pytdxdata.models import KlinePeriod
# 统一接口用字符串前缀指定扩展市场(推荐):
await td.get_bars("hk00700", KlinePeriod.DAY, count=700) # 腾讯
await td.get_bars("usAAPL", KlinePeriod.DAY, count=700) # 苹果
await td.get_bars("cffex:IFL0", KlinePeriod.DAY, count=700) # 股指期货
await td.get_bars("sh_stock_option:10010971", KlinePeriod.DAY, count=700) # 沪股票期权
上表的
ExMarket枚举值用于查阅与内部协议;统一接口不再直接传枚举,改用字符串前缀 (短前缀hk/us/cffex…,无短别名的成员用枚举名小写 + 冒号,如sh_stock_option:10010971)。
完整成员列表
以下由 mkdocstrings 从源码实时渲染,以源码为准:
::: pytdxdata.models.ExMarket options: show_root_heading: false show_root_toc_entry: false members_order: source
!!! note "美股期权 / 港股期权不在其中" 通达信协议内没有美股、港股期权数据。美股期权需要走 CBOE 公开接口。