上一提交只补了 getting-started / routing / llms.txt / SKILL.md 四处,本轮把其余 教程类页面与接口清单补齐,并顺手修正 v0.6.0 统一接口改造后遗留的过时说明。 补齐(当日测速缓存): - README「已知限制」:说明当日首次启动会自动后台测速并缓存 - FAQ 新增「启动时会变慢吗?会不会在后台偷偷联网?」:无感保证 + 三个环境变量开关 - FAQ「连不上服务器怎么办」:加入"删当日测速缓存 / 环境变量指定主机"两条前置排查 - API_REFERENCE 四、辅助模块:config 补全当日测速相关函数与优先级链说明, 新增 pytdxdata.pool.probe_cache 一节(ProbeCache / schedule_probe / get_probe_cache) - internals/architecture.md 目录树:config.py、probe_cache.py 的职责注释更新 - internals/cache-pool.md「下一步」:补「服务器是怎么选出来的」交叉链接 修正(v0.6.0 遗留过时描述): - FAQ / api/enums.md:删掉「所有接口的第一个参数都是 market」——统一接口已改为字符串标的 - FAQ / cookbook:`*_batch` 已并入 `get_bars`(多标的),不再作为批量入口 - FAQ / getting-started「自建服务器清单」:`standard_servers` 实际是 Sequence[str] 而非 (host, port) 元组(端口由统一的 port= 指定);原示例照抄会取到错的主机名 (已实测:字符串写法正确,元组写法不会被解析) 校验:check_docs.py exit 0;mkdocs build --strict 无告警;新增交叉链接 #当日自动测速无感 / #daily-probe 均正确渲染且目标锚点存在;全量 164 项通过; src/pytdxdata/servers.json 跑测前后逐字节不变。
4.4 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 "代码不唯一"
市场 + 代码才唯一。sh000001 是上证指数,sz000001 是平安银行。
统一接口用字符串标的把两者一起表达(前缀即市场),避免只写 6 位数字时的歧义。
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 公开接口。