按「数据类型」合并同类查询接口:一个数据类型 = 一个方法,跨市场自动选路。 - 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 方法回归)。
50 lines
1.7 KiB
Python
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())
|