核心用法
腾讯财经股票行情工具基于 qt.gtimg.cn 公开 API,无需注册或密钥即可调用。支持三类市场:
- A股:
sh/sz前缀(如sh688256)或直接输入代码 - 港股:
hk前缀(如hk00700)或直接输入5位代码 - 美股:
us前缀必填(如usAAPL) - 指数:
sh000001、hkHSI、usINX等
运行方式:uv run query_stock.py [代码...],加 --detail 输出完整财务指标。
显著优点
1. 零门槛接入:无需 API Key、无调用配额限制、无账号体系
2. 市场覆盖全:中美港三地市场 + 主要指数,支持多代码批量查询
3. 数据维度丰富:除基础价量外,提供 TTM PE、PB、市值、52周高低、换手率等投资核心指标
4. 输出友好:紧凑/详细双模式,中文标签 + emoji 涨跌标识,终端直接可读
5. 字段自适应:A股成交量自动识别「手/股」单位切换
潜在局限与风险
- 数据源单一:完全依赖腾讯财经 API,若服务调整或限流将直接影响可用性
- 非实时延迟:行情数据存在秒级延迟,不适合高频交易场景
- 财务数据口径:PE(TTM) 为动态市盈率,亏损股显示负值;港股/美股部分字段(如A股总股本)存在映射缺失
- 无历史数据:仅支持实时快照,无法查询分时 K 线或财务历史
- 合规边界:虽为公开接口,但大规模自动化调用可能触发 IP 限流,需控制频率
适合人群
- 个人投资者快速盘前/盘中扫货
- 分析师批量获取多市场估值对比数据
- 开发者构建轻量级行情看板原型
常规风险
- S+ 级数据安全:仅读取公开行情,不传输持仓或账户信息
- 可用性风险:第三方 API 变更无 SLA 保障,建议本地缓存容错
- 估值误读风险:负 PE 或缺失 PB 时需人工二次验证