通达信(TDX)行情数据客户端 —— 动态连接池 + 双层TTL缓存 + 3连接并发分页, 纯 asyncio、零运行时依赖。一套接口覆盖 A股(沪/深/北) / 港股 / 美股 / 期货 / 期权。 主要能力: - 四层架构:api → pool(标准/MAC/EX 三池) → protocol(16 命令模块) → cache(内存+SQLite) - TdxData 提供 51 个公开异步方法;CLI(tdx) 提供 19 个子命令 - 服务器文件下载 + 解析:板块 block_*.dat / 行业 tdxhy.cfg / 历史财报 gpcw*.zip - 85 个离线测试(协议 / 连接池 / 缓存 / 分页 / API / 文件解析 / CLI) 协议层参照 easy-tdx 的字节级格式独立实现,不依赖 easy-tdx 包。
49 lines
1.7 KiB
Python
49 lines
1.7 KiB
Python
"""pytdxdata 快速上手:报价 / K线 / 分时 / 板块汇总。
|
|
|
|
运行:
|
|
python examples/quickstart.py
|
|
|
|
说明:数据来自通达信公开行情服务器(无需账号,15 分钟延时)。
|
|
"""
|
|
|
|
import asyncio
|
|
|
|
from pytdxdata import KlinePeriod, Market, TdxData
|
|
|
|
|
|
async def main() -> None:
|
|
# TdxData 为异步上下文管理器:进入时建连,退出时释放
|
|
async with TdxData() as td:
|
|
# 1) 批量五档报价(可一次传多只,超过 80 只自动切批)
|
|
quotes = await td.get_quotes([(Market.SH, "600000"), (Market.SZ, "000001")])
|
|
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_kline(Market.SH, "600000", KlinePeriod.DAY, 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_minute(Market.SH, "600000")
|
|
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())
|