核心用法
本技能提供双引擎股票数据查询方案：
| 数据源 | 定位 | 安装成本 | 典型场景 |
|--------|------|---------|---------|
| **腾讯 Finance HTTP API（默认）** | 轻量快速 | 零安装、无需代理 | 实时报价、K 线查询、盘口分析 |
| **adata SDK（可选）** | 深度量化 | 需 pip 安装、可能需代理 | 资金流向、概念板块、完整财报 |
腾讯 API 快速上手
实时行情：http://qt.gtimg.cn/q=sh600519（茅台）
- 支持 A 股（sh/sz 前缀）、港股（hk 前缀）、美股（us 前缀）
- 返回 GBK 编码，含名称、现价、涨跌幅等 30+ 字段
历史 K 线：https://web.ifzq.gtimg.cn/appstock/app/fkqline/get
- 支持日/周/月线，前复权/后复权/不复权
- 参数化查询：股票代码、周期、起止日期、条数
盘口分析：http://qt.gtimg.cn/q=s_pk<代码> 获取内外盘买卖量比例
adata SDK 深度功能
import adata # 全市场代码、K 线、实时批量行情、资金流、概念板块、ETF 数据
---
显著优点
1. 零门槛即用：默认腾讯 API 无需任何安装，curl/wget 可直接调用
2. 三市场覆盖：A 股（主板/科创板/创业板）、港股、美股统一接口风格
3. 数据完整性：K 线含 OHLCV 标准字段，复权处理清晰
4. 灵活分层：简单查询用腾讯，专业量化切 adata，避免过度工程
5. 指数支持：内置沪深 300、创业板指等主流指数代码
---
潜在缺点与局限
| 局限项 | 说明 |
|--------|------|
| **数据延迟** | 实时行情可能有 **15 分钟延迟**，非 Level-2 实时逐笔 |
| **编码坑点** | 腾讯 API 返回 **GBK 编码**，UTF-8 环境直接解析会乱码 |
| **频率限制** | 高频请求可能触发限流，需批量查询（支持多代码逗号分隔） |
| **adata 依赖** | 部分高阶功能（资金流、概念板块）必须安装 SDK 且可能需代理 |
| **无 WebSocket** | 纯 HTTP 轮询，无推送式实时行情 |
| **错误信息简陋** | 无效代码仅返回 `v_pv_none_match="1"`，需自行判空 |
---
适合人群
- 个人投资者：快速查股价、看 K 线、简单技术分析
- 量化入门者：用 adata 获取标准化 DataFrame，对接 pandas/Backtrader
- 开发者集成：轻量后端服务、Telegram/钉钉机器人行情推送
- 教育场景：金融数据 API 教学示例（HTTP 协议直观易懂）
---
常规风险
1. 数据准确性风险：第三方免费 API 无 SLA，关键交易决策需交叉验证
2. 合规边界：仅用于个人研究，勿用于高频自动交易或商业数据再分发
3. 网络稳定性：腾讯 API 偶有维护或限流，生产环境需加降级缓存
4. 代理安全风险：adata 若配置代理，需确保代理可信，避免中间人攻击