Files
pytdxdata/examples/quickstart.py
T
openbot-coder 3e0beb27a6 release: v0.6.0(统一对外接口重构)
按「数据类型」合并同类查询接口:一个数据类型 = 一个方法,跨市场自动选路。

- 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 方法回归)。
2026-09-17 11:34:52 +08:00

50 lines
1.7 KiB
Python

"""pytdxdata 快速上手:报价 / K线 / 分时 / 板块汇总。
运行:
python examples/quickstart.py
说明:数据来自通达信公开行情服务器(无需账号,15 分钟延时)。
标的一律用字符串(``sh600000`` / ``sz000001`` / ``hk00700`` / ``usAAPL`` / ``cffex:IFL0``)。
"""
import asyncio
from pytdxdata import TdxData
async def main() -> None:
# TdxData 为异步上下文管理器:进入时建连,退出时释放
async with TdxData() as td:
# 1) 批量五档报价(可一次传多只,超过 80 只自动切批)
quotes = await td.get_quotes(["sh600000", "sz000001"])
print("== 报价 ==")
for q in quotes:
print(
f"{q.code} 现价={q.price} 昨收={q.pre_close} "
f"买一={q.bid[0]} 卖一={q.ask[0]} 成交量={q.vol}"
)
# 2) 日K线(最近 10 根)
bars = await td.get_bars("sh600000", count=10)
print("\n== 日K(最近 3 根)==")
for b in bars[-3:]:
print(
f"{b.datetime:%Y-%m-%d} "
f"开={b.open} 高={b.high} 低={b.low} 收={b.close} 量={b.vol}"
)
# 3) 当日分时
minutes = await td.get_minutes("sh600000")
latest = minutes[-1].price if minutes else "-"
print(f"\n== 分时 ==\n共 {len(minutes)} 个点,最新价={latest}")
# 4) 板块汇总(示例:通达信行业板块 881001)
summary = await td.get_board_summary("881001")
print("\n== 板块汇总 881001 ==")
for key, value in summary.items():
print(f" {key}: {value}")
if __name__ == "__main__":
asyncio.run(main())